Un CRM con muchas piezas: dónde está la venta
Agile CRM junta en una sola cuenta contactos, deals, tareas, citas y automatización de marketing. Esa mezcla lo hace atractivo para equipos pequeños que quieren todo en un sitio, pero para medir anuncios plantea una cuestión de orden: de todo lo que vive en la cuenta, solo una parte describe una venta, y es el deal. El resto, correos enviados, tareas o puntuaciones, cuenta cómo trabaja tu equipo, no si una campaña funcionó.
El conector se centra en el deal y en el contacto asociado. Del deal toma el momento en que llega a ganado y su valor; del contacto, la forma de recuperar el clic de origen. Con esas dos cosas se puede decir a Meta y a Google: esta persona, que vino de tu anuncio, acabó comprando.
Qué documenta la API de Agile CRM
La referencia oficial de la API REST de Agile CRM indica que las peticiones se hacen a una dirección con el dominio de tu cuenta seguida de /dev/, y que la autenticación usa HTTP básico con el correo del usuario como nombre y su clave de API como contraseña. Para los deals existe una familia de rutas bajo dev/api/opportunity: listar, consultar uno por identificador, crear, actualizar parcialmente, borrar, consultar los deals de una pista concreta. Los deals de un contacto se consultan desde el propio contacto (dev/api/contacts/{id}/deals). El listado se pagina con page_size y cursor; cuando una respuesta ya no trae cursor, se ha llegado al final.
| Qué | Dirección | Para qué |
|---|---|---|
| Deals de tu cuenta, con su valor y su hito | Agile CRM → Acelera Sales | Saber cuáles se han ganado y por cuánto |
| Contactos vinculados a cada deal | Agile CRM → Acelera Sales | Recuperar el clic de origen de cada persona |
| Deal ganado con su valor | Acelera Sales → Meta (API de conversiones) | Que Meta optimice a compradores |
| Venta con el identificador de clic | Acelera Sales → Google Ads (conversión offline) | Conector listo; se activa en tu cuenta en la puesta en marcha |
Dos detalles de los deals que se tienen en cuenta
Primero, el valor. En la referencia, el campo expected_value se describe como el valor estimado del deal y como obligatorio. Es decir, todos los deals tienen un importe, pero un importe «esperado» no es lo mismo que lo facturado: se acuerda contigo si se devuelve ese valor o uno distinto cuando el deal se gana. Segundo, el hito. El campo milestone depende de la pista (el embudo) elegida, y la documentación advierte de que su nombre distingue mayúsculas de minúsculas y debe coincidir con el que aparece en la propia cuenta. Por eso la definición de «ganado» no se copia de ninguna lista: se lee de tu cuenta y se escribe tal cual en el mapa de la conexión, pista por pista si tienes varias.
Cómo se conecta, paso a paso
- La clave y el dominio. Se pide el dominio de tu cuenta de Agile CRM y la clave de API de un usuario. Es preferible el de un usuario dedicado a la integración.
- Pistas y hitos. Se listan tus pistas de ventas y se marca cuál es el hito de ganado en cada una.
- El origen. El píxel propio guarda el identificador de clic en el formulario de tu web; se acuerda en qué campo del contacto se escribe para unirlo después con el deal.
- Primera lectura. Se leen los deals por páginas y se comparan con lo que ves tú en la pantalla de Agile CRM.
- Cuadre del histórico. Los deals ganados hasta hoy se comprueban contra un listado tuyo.
- Prueba y activación. Se envían ventas de prueba a Meta; con la respuesta correcta, se activa el envío real y el de Google.
Qué ves en los paneles
El panel pone en una línea lo que ocurre antes del deal (anuncio, visita, formulario) y lo que ocurre después (cada hito de tu pista). Se ve qué campañas generan contactos que avanzan y cuáles se quedan por el camino, y para cada campaña el coste por venta y los ingresos. Más en paneles y alertas.
Qué recibe cada plataforma
Meta recibe la venta por la API de conversiones, con los datos de contacto con hash SHA-256 (ver la guía de la API de conversiones de Meta y la de conversiones offline de Meta desde tu CRM). Google recibe una conversión offline con el identificador de clic, tal como describen las conversiones offline de Google Ads. Cuando un deal se creó a mano para un contacto que no pasó por tu web, se refleja en el panel pero no se devuelve a las plataformas, porque no hay clic al que atribuirlo.
Siguiente paso
Si tu equipo comercial lleva el pipeline en Agile CRM, reserva una demo y lo vemos con una de tus pistas. Para repartir el mérito entre varios clics, los modelos de atribución dan el criterio.
Preguntas frecuentes
¿Cómo se autentica el conector en Agile CRM?
Con HTTP básico: el correo del usuario como nombre y su clave de API como contraseña, sobre la dirección de tu cuenta.
¿Qué pasa si tengo varias pistas de ventas?
Cada una tiene sus hitos. Se marca en el mapa cuál es el de ganado en cada pista y se leen todas con el mismo criterio.
¿Por qué importa que el hito coincida en mayúsculas y minúsculas?
Porque Agile CRM lo trata así. Si en tu cuenta se llama «Won» y el conector buscara «won», no encontraría nada; se copia tal como está en la cuenta.
¿El valor esperado es el importe que se manda a Meta?
Puede serlo, pero se decide contigo. Si el valor definitivo se corrige al cerrar, se acuerda cuál de los dos se devuelve.
¿Tengo que pagar un plan concreto para usar la API?
Eso depende de tu contrato con Agile CRM, no de nosotros. Lo comprobamos al empezar, junto con tu usuario de integración.
¿Los deals perdidos se mandan a las plataformas?
No. Solo se envían las ventas ganadas; los perdidos se quedan en el panel como parte del embudo.