EspoCRM y tus campañas: la oportunidad ganada, de vuelta al anuncio

El conector de EspoCRM está listo: consulta por la API REST las oportunidades de tu instancia, reconoce las ganadas y devuelve la venta a Meta y a Google con la campaña y el anuncio de origen.

Integración 4 min de lectura · Actualizado: 2026-11-16

Conector listo · Acelera Sales

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ónPara qué
Oportunidades y sus campos de ventaEspoCRM → Acelera SalesDetectar las cerradas y su importe
Contactos, cuentas y leads asociadosEspoCRM → Acelera SalesUnir la venta con la persona que dejó sus datos
Venta con su importeAcelera Sales → Meta (API de conversiones)Que Meta aprenda de compradores
Venta con el identificador de clicAcelera 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

  1. 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.
  2. Definir «ganada». Se anota la etapa que equivale a una venta y se decide qué ocurre si una oportunidad se reabre.
  3. 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.
  4. Prueba de lectura. Se pide un puñado de oportunidades y se comparan con la pantalla de EspoCRM, campo por campo.
  5. Carga de lo cerrado. Se leen las ventas ya registradas y se cuadran con tu listado.
  6. 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.

Relacionados

¿Lo vemos con tus datos?

En 30 minutos te enseñamos cómo se vería tu publicidad medida hasta la venta. Sin compromiso.