Una instancia que es tuya: qué implica para medir anuncios
EspoCRM se puede alojar en tu propio servidor, y quien lo hace suele querer algo concreto: control sobre sus datos y la libertad de adaptar entidades y campos a su forma de vender. Esa libertad es una ventaja, pero deja una consecuencia para la medición: no hay dos instalaciones idénticas. Una empresa renombra las etapas, otra añade un campo para el origen del contacto, otra usa una entidad propia. Un conector que diera todo por supuesto fallaría en cuanto alguien tocara la configuración.
Por eso la conexión se plantea como un mapa que se redacta contigo: qué entidad representa tu venta, qué valor significa «ganada», dónde está el importe y dónde se guarda de qué anuncio vino la persona. A partir de ese mapa, el resto es mecánico y se puede repetir cada día sin que nadie tenga que pensar en ello.
La API de EspoCRM: tres maneras de identificarse
La documentación oficial de EspoCRM describe una API REST cuya raíz es api/v1/. Para identificar a la aplicación que consulta ofrece varias vías. La más sencilla es un usuario de API con método «API Key» y un rol asignado, cuya clave se envía en la cabecera X-Api-Key. Otra es el método HMAC, más estricto: la cabecera X-Hmac-Authorization lleva una firma que se calcula con la clave secreta, la operación y la dirección. También hay OAuth 2.0, disponible a partir de la versión 10.1. La autenticación básica con usuario y contraseña existe pero la propia documentación no la recomienda, y el conector no la utiliza.
| Qué | Dirección | Para qué |
|---|---|---|
| Oportunidades y sus campos de venta | EspoCRM → Acelera Sales | Detectar las cerradas y su importe |
| Contactos, cuentas y leads asociados | EspoCRM → Acelera Sales | Unir la venta con la persona que dejó sus datos |
| Venta con su importe | Acelera Sales → Meta (API de conversiones) | Que Meta aprenda de 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 |
Cómo pide los datos el conector
EspoCRM permite filtrar en la petición misma. Los parámetros de búsqueda documentados incluyen maxSize y offset para paginar, orderBy y order para ordenar, select para pedir solo ciertos atributos y una estructura where con tipos como equals, in, greaterThan o between, además de filtros de fecha (por ejemplo, últimos días). Gracias a ello se puede pedir solo lo necesario: no una vuelta completa a todos los registros, sino las oportunidades cuyo estado cumple la condición acordada.
Qué campos exactos tiene tu oportunidad (etapa, importe, fecha de cierre, cuenta) se confirma en tu instancia, porque la documentación de la API remite a la de cada entidad y esos campos se pueden modificar con el gestor de entidades. Lo que no se comprueba allí no se da por hecho.
Puesta en marcha, paso a paso
- Un usuario de API. Se crea en la administración con el método de clave y un rol que solo lea las entidades necesarias. Se descarta usar la cuenta de una persona.
- Definir «ganada». Se anota la etapa que equivale a una venta y se decide qué ocurre si una oportunidad se reabre.
- El origen. El píxel propio conserva el identificador de clic; se acuerda en qué campo del lead o del contacto se guarda para cruzarlo con la oportunidad.
- Prueba de lectura. Se pide un puñado de oportunidades y se comparan con la pantalla de EspoCRM, campo por campo.
- Carga de lo cerrado. Se leen las ventas ya registradas y se cuadran con tu listado.
- Envío de prueba. Se mandan ventas de ensayo a Meta; solo si llegan bien se enciende la devolución real y la de Google.
Qué ves en los paneles
El embudo muestra tus etapas de EspoCRM con sus nombres y, delante, el tramo que el CRM no ve: visita, anuncio y formulario. Cada oportunidad ganada queda ligada a su campaña, conjunto y anuncio, y se calcula el coste por venta y los ingresos por campaña. Hay más detalle en paneles y alertas.
Qué se devuelve a las plataformas
A Meta se envía la venta por la API de conversiones con los datos de contacto con hash SHA-256 (más en la guía de la API de conversiones de Meta y en la de conversiones offline de Meta desde tu CRM). A Google se le entrega como conversión offline con su identificador de clic, como explican las conversiones offline de Google Ads. Si una oportunidad viene de una llamada o de un correo sin paso por tu web, la venta cuenta en el panel pero no tiene clic que devolver.
Siguiente paso
Si ya vendes con EspoCRM y quieres que tus campañas aprendan de lo que cierras, reserva una demo. Y para decidir cómo se reparte el mérito entre varios clics, mira los modelos de atribución.
Preguntas frecuentes
¿Qué versión de EspoCRM necesito?
La clave de API y HMAC son los métodos que describe la documentación de la API REST. Si prefieres OAuth 2.0, la documentación lo sitúa desde la 10.1.
¿Qué diferencia hay entre clave y HMAC?
La clave viaja tal cual en una cabecera; HMAC firma cada petición con un secreto que no se envía. HMAC es más estricto, y se elige según tu política de seguridad.
¿Se puede limitar lo que lee el conector?
Sí. El usuario de API recibe un rol, y en el rol se decide a qué entidades accede y con qué permisos.
Cambié los nombres de las etapas, ¿importa?
No, siempre que se refleje en el mapa. El conector filtra por el valor acordado, sea cual sea su nombre.
¿Y si uso una entidad propia en lugar de oportunidades?
Es posible. Mientras la API la exponga y tenga estado e importe, se puede tratar igual; se confirma en tu instancia.
¿Se envían a Meta los datos personales tal cual?
No: los datos de contacto viajan con hash SHA-256, que es el formato que pide la API de conversiones.