Por qué Insightly y los anuncios se miden por separado
Insightly agrupa contactos, organizaciones, oportunidades y proyectos en una sola herramienta, y muchas empresas lo usan precisamente porque cubre la venta y la entrega posterior. Esa amplitud tiene una consecuencia para la medición: el equipo trabaja con un volumen de registros mezclado, y nadie se detiene a anotar en cada oportunidad de qué campaña salió el primer contacto. Meta y Google, por su parte, solo conocen la acción de rellenar un formulario. Entre un sistema y otro hay un hueco, y es en ese hueco donde se pierde la información que importa.
Lo que hace el conector es cubrirlo en tres movimientos: leer la oportunidad cuando cambia a ganada, localizar el contacto asociado y recuperar el clic que lo originó, y mandar la venta a la plataforma que pagó por ese clic. Así la campaña deja de evaluarse por contactos baratos y pasa a evaluarse por oportunidades cerradas.
Qué ofrece la API de Insightly y qué usamos de ella
La API v3.1 de Insightly es una API REST con un recurso por cada tipo de objeto. Para este caso interesa el de oportunidades, que se puede listar, consultar por identificador y buscar por un campo y un valor. La documentación oficial pone como ejemplo de búsqueda la combinación de un campo de la oportunidad con un valor concreto. La lectura se divide en páginas con los parámetros top y skip: por defecto devuelve 100 registros y el máximo por respuesta es 500, y existe una opción para que la respuesta indique el total.
| Qué | Dirección | Para qué |
|---|---|---|
| Oportunidades de tu cuenta, con su estado y su importe | Insightly → Acelera Sales | Saber cuáles se han cerrado y por cuánto |
| Contactos y organizaciones relacionados | Insightly → Acelera Sales | Unir la oportunidad con la persona que dejó sus datos |
| Oportunidad ganada con su importe | Acelera Sales → Meta (API de conversiones) | Que Meta aprenda de compradores y no de curiosos |
| 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 |
Una precisión honesta: los nombres exactos de los campos de una oportunidad en tu cuenta (estado, importe, fechas, etapa del proceso, campos personalizados) se verifican contra tu instalación al implantar, no desde una tabla genérica. Insightly permite campos personalizados, y es muy probable que tu importe o tu etapa vivan en uno.
Conectarlo con tu cuenta, de la clave a la primera venta
- Región de tu cuenta. Las direcciones de la API incluyen un identificador de región (lo que Insightly llama «pod»), que aparece en la configuración de usuario junto a la clave. Es lo primero que se pide, porque sin él las peticiones no llegan al sitio correcto.
- La clave de API. Insightly usa autenticación HTTP básica: la clave, codificada en Base64, va como usuario y la contraseña se deja en blanco. Cada usuario tiene la suya; se recomienda usar la de un usuario dedicado a la integración.
- Qué es «ganada». Antes de nada se anota contigo qué estado, o qué etapa final, equivale a una venta. Si tienes varios procesos de venta, se decide cuáles cuentan.
- Origen del contacto. El píxel propio conserva el identificador de clic de quien rellena el formulario en tu web; se acuerda en qué campo de Insightly se guarda para poder unirlo con la oportunidad.
- Carga de lo cerrado hasta hoy. Se leen las oportunidades ya ganadas y se comparan con un listado de Insightly. Si las cifras no cuadran, se corrige antes de seguir.
- Eventos de prueba y alta. Se envían ventas de prueba a Meta y se comprueba que llegan; solo después se enciende la devolución real y, si procede, la de Google.
Límites de uso que conviene conocer
La documentación de Insightly fija un máximo de 10 peticiones por segundo por cuenta y una cuota diaria que depende del plan contratado; si se rebasan, la API responde con un error 429, y las respuestas indican cuántas peticiones quedan. El conector se diseña para leer lo necesario y no más: oportunidades en páginas, sin recorrer toda la cuenta en cada vuelta. Si tu plan tiene una cuota diaria ajustada, se tiene en cuenta al fijar cada cuánto se consulta.
Qué ves en los paneles
El embudo reproduce las etapas de tu proceso, con tus nombres, y delante coloca lo que ocurre antes de que exista una oportunidad: visita, formulario y alta del contacto. Cada venta aparece asociada a su campaña, conjunto de anuncios y anuncio, con coste por venta e ingresos por campaña. Para ver cómo funciona el conjunto, paneles y alertas.
Qué se devuelve a Meta y a Google, y cuándo no se puede
A Meta llega la venta por la API de conversiones (la guía de API de conversiones de Meta explica el mecanismo, y la de conversiones offline de Meta desde tu CRM el caso de ventas cerradas lejos del navegador). A Google se devuelve como conversión offline, con la mecánica de las conversiones offline de Google Ads. Si una oportunidad ganada nació de un contacto que nunca pasó por un formulario de tu web, la venta se registra en el panel, pero no hay clic al que atribuirla ni conversión que devolver a las plataformas. Ese límite lo pone el dato de origen, no el CRM.
Siguiente paso
Si tu equipo gestiona el pipeline en Insightly y quieres cruzarlo con tus campañas, reserva una demo. Para elegir qué clic se lleva el mérito de cada venta, está la guía de modelos de atribución.
Preguntas frecuentes
¿Qué versión de la API de Insightly se usa?
La v3.1, que es la que documenta Insightly. Las peticiones van a una dirección que incluye la región de tu cuenta.
¿Cómo se autentica el conector en Insightly?
Con la clave de API del usuario, mediante autenticación HTTP básica. Se recomienda un usuario exclusivo para la integración.
¿Cuántos registros se leen de una vez?
Insightly pagina las listas: 100 registros por defecto y hasta 500 por respuesta. El conector pide por páginas y solo lo que necesita.
¿Y si mi cuenta tiene campos personalizados para el importe?
Es habitual. Se verifica en tu instalación cuál es el campo del importe y cuál el de la etapa, y se registra en el mapa de la conexión.
¿Sirve si vendo por proyectos?
Sí, mientras la venta quede reflejada como una oportunidad ganada. Si en tu caso la venta se define de otra manera, se acuerda al principio.
¿Se pueden perder ventas por los límites de la API?
No deberían: el conector consulta por páginas y respeta el máximo de peticiones por segundo; la frecuencia se ajusta a la cuota de tu plan.