El problema: un CRM que controlas tú, pero que no habla con tus anuncios
SuiteCRM se presenta como un CRM de código abierto, sin cuotas de licencia, que puedes alojar tú mismo o contratar gestionado. Esa libertad atrae a empresas que quieren controlar sus datos y adaptar el sistema a su forma de vender. Pero un CRM propio también significa que nadie lo ha conectado de fábrica con Meta ni con Google, y que lo que ocurre dentro no sale.
El caso típico: los contactos llegan desde formularios de la web, se trabajan en SuiteCRM como oportunidades y se ganan o se pierden. Las plataformas de anuncios no se enteran de nada de eso, así que optimizan a quien rellena el formulario. El conector lee las oportunidades por la API, recupera el anuncio de origen de cada contacto y devuelve el resultado, sin que tengas que modificar el código de tu instalación.
Qué se lee de SuiteCRM y qué se devuelve
| Qué | Dirección | Para qué |
|---|---|---|
| Contactos y cuentas, con fecha de alta y origen del lead | SuiteCRM → Acelera Sales | Casar cada contacto con su visita y su clic |
| Oportunidades: etapa de venta, importe, fecha de cierre y contacto o cuenta vinculados | SuiteCRM → Acelera Sales | Calcular ventas e ingresos por campaña y anuncio |
| Definición de módulos y campos de tu instalación | SuiteCRM → Acelera Sales | Respetar los campos personalizados que hayas añadido |
| Oportunidad ganada con su importe | Acelera Sales → Meta (API de conversiones) | Que Meta aprenda de compradores y no solo de formularios |
| Venta con su importe y el clic de origen | Acelera Sales → Google Ads (conversión offline) | Conector listo; se activa en tu cuenta en la puesta en marcha |
La API V8 de SuiteCRM sigue un esquema REST por módulos: se lista un módulo con una petición del tipo /Api/V8/module/{nombre del módulo}, con filtros como filter[campo][eq]=valor y operadores and u or para combinarlos. Hay además puntos de metadatos que devuelven la lista de módulos y los campos de cada uno, y un esquema Swagger de tu propia instalación. Eso importa porque, al ser código abierto y personalizable, los campos de una instalación no tienen por qué coincidir con los de otra.
Cómo se conecta, paso a paso
- Crear un cliente OAuth2. En SuiteCRM, un administrador entra en Admin, «OAuth2 Clients and Tokens», y crea un cliente. Para una integración entre sistemas, la documentación describe el flujo de credenciales de cliente, pensado para máquinas sin intervención de una persona; también existen los flujos de contraseña y de código de autorización.
- Obtener el token. Con el identificador y el secreto del cliente se pide un token a la dirección
/Api/access_tokende tu instalación. El token se envía como Bearer en cada petición, caduca (el ejemplo oficial es de 3600 segundos) y se pide uno nuevo con las mismas credenciales. - Acceso desde fuera. Si tu SuiteCRM está alojado en tu propio servidor, la API tiene que ser alcanzable desde el nuestro; se revisa contigo qué dirección y qué reglas de red hacen falta.
- Mapa de etapas. Se acuerda qué etapa de venta cuenta como ganada, dónde está el importe y dónde queda el origen del lead.
- Histórico, prueba y activación. Antes de activar la devolución real se mandan eventos de prueba; el histórico se carga y se cuadra con un informe de SuiteCRM, y el píxel propio guarda el clic cuando la persona deja sus datos en tu web.
Qué ves en los paneles
Las etapas de venta de SuiteCRM forman el embudo del panel, y delante aparece lo que pasó antes en la web. Cada oportunidad ganada se muestra con su campaña, conjunto y anuncio, y el panel de campañas enseña coste por oportunidad, coste por venta e ingresos. El panel de eventos muestra qué se ha mandado a Meta y a Google y si lo han aceptado. Todo en paneles y alertas.
Qué devolvemos a Meta y a Google
Cuando la etapa que acordamos como ganada se alcanza en SuiteCRM, la venta va a Meta por la API de conversiones (la guía de API de conversiones de Meta explica el mecanismo) y a Google como conversión offline, que se activa en tu cuenta en la puesta en marcha; el detalle está en la guía de conversiones offline de Google Ads. Los datos de contacto que van a Meta se cifran, como exigen las propias plataformas.
Qué tener en cuenta
- La API V8 viene incluida en SuiteCRM 8, pero conviene comprobar que está activa en tu instalación; es parte de la puesta en marcha.
- Si has modificado etapas o añadido campos propios, no hay problema, pero el mapa se confirma con el esquema de tu instalación.
- Las oportunidades importadas en bloque no traen clic. Se miden en el embudo, pero sin anuncio de origen.
- La plataforma de anuncios aprende de la venta con retraso si el ciclo es largo; ningún conector lo evita.
Siguiente paso
Si usas SuiteCRM y quieres ver qué campañas acaban en una venta ganada, reserva una demo. Esta página trata del conector del software. Para decidir a qué clic se atribuye cada venta, mira los modelos de atribución.
Fuentes
Preguntas frecuentes
¿Cómo envío las oportunidades ganadas de SuiteCRM a Meta?
Acelera Sales lee la oportunidad por la API V8 de SuiteCRM, la une con el anuncio de origen del contacto y la manda a Meta por la API de conversiones. El conector está listo; en la puesta en marcha se crea el cliente OAuth2 y se prueba.
¿Funciona con SuiteCRM alojado en mi propio servidor?
Sí, siempre que la API de tu instalación sea alcanzable desde el conector. Se revisa contigo la dirección y las reglas de red necesarias.
¿Qué autenticación usa?
OAuth 2.0 de SuiteCRM. Para una integración entre sistemas, el flujo de credenciales de cliente, con un cliente creado desde el panel de administración.
¿Se puede conectar SuiteCRM con Google Ads?
Sí. La etapa ganada en SuiteCRM es el disparo: la venta se manda a Google como conversión offline, con el clic de origen. El conector está listo; se enciende en tu cuenta al ponerlo en marcha.
¿Y si he añadido campos personalizados?
Se leen igual. La API describe los campos de cada módulo en tu instalación, y se acuerda cuáles cuentan como importe y como origen.
¿Escribe Acelera Sales en SuiteCRM?
No, salvo que lo pidas. De SuiteCRM se lee por su API y hacia fuera solo sale la venta, rumbo a las plataformas; escribir en tu instalación es un extra que se acuerda aparte.