Capsule es sencillo, y la medición debería serlo también
Capsule CRM se ha ganado su sitio entre pequeñas empresas de servicios porque no abruma: personas y organizaciones, oportunidades, tareas y poco más. Esa sencillez es una virtud a la hora de conectarlo con los anuncios, porque casi todo lo importante está en un solo objeto, la oportunidad, y el resto son datos de contexto. Lo que no tiene Capsule es un lugar natural donde anotar de qué campaña salió quien entró, y por eso el clic se guarda aparte y se une después.
La idea es que quien lleva el CRM no tenga que hacer nada distinto: sigue moviendo oportunidades por sus fases, y cuando una se cierra, el conector se encarga de que Meta y Google lo sepan.
Lo que dice la API v2 de Capsule
La documentación oficial de desarrolladores explica que la API v2 usa HTTPS contra api.capsulecrm.com y que cada petición lleva un token en la cabecera Authorization con el esquema Bearer. Hay dos maneras de obtener ese token. La primera es un token de acceso personal, que se genera en las preferencias del usuario y encaja bien en integraciones internas. La segunda es OAuth 2 con el flujo de código de autorización, pensada para aplicaciones compartidas con otras cuentas; el usuario puede revocar el acceso cuando quiera y el token de acceso caduca, por lo que se renueva con el token de refresco.
El listado de oportunidades acepta el parámetro since (solo lo cambiado después de una fecha en formato ISO 8601), page y perPage (de 1 a 100, con 50 por defecto) y embed, que añade datos como la persona, la fase o los campos personalizados. Las páginas siguientes se indican en una cabecera Link.
| Qué | Dirección | Para qué |
|---|---|---|
| Oportunidades cambiadas desde la última lectura | Capsule → Acelera Sales | Detectar cierres sin releer toda la cuenta |
| Persona u organización de cada oportunidad | Capsule → Acelera Sales | Unir la venta con quien rellenó el formulario |
| Venta con su valor | 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 |
El modelo de oportunidad y lo que significa para el conector
En el modelo de Capsule, una oportunidad tiene un valor, una fase (milestone, obligatoria), una fecha de cierre (closedOn), una fecha prevista (expectedCloseOn), la persona o empresa principal (party) y sellos de creación y última modificación. De esos datos salen tres decisiones prácticas. Una, que el momento de la venta es la fecha de cierre y no la de creación. Dos, que la oportunidad ganada se reconoce por la fase y se acuerda contigo cuál es en tu tubería. Tres, que la lectura incremental con since evita volver a pedir lo ya procesado. Cómo guarda tu cuenta los campos personalizados (por ejemplo, el origen del lead) se revisa en la instalación y no se supone.
Puesta en marcha, paso a paso
- Token de integración. Se genera un token personal desde un usuario dedicado, o se acuerda el flujo OAuth 2 si prefieres no compartir ningún token.
- Fases y cierres. Se repasan las fases de tu tubería y se marca cuál es la de ganada. También se decide qué hacer con una oportunidad que se reabre.
- Dónde se guarda el clic. El píxel propio conserva el identificador de clic de quien rellena el formulario; se acuerda el campo de Capsule donde se anota para poder unirlo después.
- Primera lectura completa. Se recorren las oportunidades por páginas y se comparan con la pantalla de Capsule.
- Lecturas siguientes. A partir de ahí, solo lo modificado desde la última vuelta.
- Prueba y alta. Se mandan ventas de ensayo a Meta y, solo si llegan bien, se activa el envío real y el de Google.
Qué ves en los paneles
El embudo muestra las fases de tu tubería con los nombres que tú les diste. Antes de ellas aparece el tramo publicitario, y cada cierre se asocia con su campaña, conjunto y anuncio. Se calcula el coste por venta y los ingresos de cada campaña, y se puede ver cuánto tarda en cerrarse una oportunidad según de dónde vino. 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 (guía de la API de conversiones de Meta y la de conversiones offline de Meta desde tu CRM). Google la recibe como conversión offline con el identificador de clic, según las conversiones offline de Google Ads. Si una oportunidad nace de un contacto cargado a mano o de un evento, el panel la registra pero no hay clic al que atribuirla ni conversión que devolver.
Siguiente paso
Si cierras tus ventas en Capsule y quieres que Meta y Google aprendan de ellas, reserva una demo. Para elegir qué clic se lleva cada venta, los modelos de atribución explican las opciones.
Preguntas frecuentes
¿Token personal u OAuth 2?
Para tu propia cuenta, un token personal basta y es lo más directo. OAuth 2 tiene sentido cuando prefieres autorizar sin compartir un token.
¿Qué pasa cuando caduca el acceso?
Con OAuth 2, el token de acceso caduca y se renueva con el de refresco; con un token personal no hay renovación, pero puedes revocarlo cuando quieras.
¿Cada cuánto se lee Capsule?
Con la lectura incremental por fecha de modificación, la frecuencia se acuerda en la puesta en marcha sin necesidad de releer toda la cuenta.
¿Una oportunidad sin fecha de cierre cuenta como venta?
No. La fecha de cierre es el momento que usamos para la venta; si falta, se revisa el caso en lugar de inventarla.
¿Puedo usar campos personalizados de Capsule para el origen?
Sí. Se mira en tu cuenta cuál es y se registra en el mapa; el conector los puede pedir junto a la oportunidad.
¿Se pueden recibir avisos en vez de leer cada poco?
Capsule documenta REST hooks para evitar sondear. Si los usamos o no en tu caso se decide en la puesta en marcha.