Product analytics: Mixpanel, Amplitude y Segment
Envía eventos de producto del CRM (ej.: "Negocio ganado", "Lead creado") a tu Mixpanel, Amplitude o Segment y recibe eventos de vuelta como actividades en el Contacto (modelo BYO, la cuenta es tuya).
La integración de Product analytics usa TU cuenta de Mixpanel, Amplitude o Segment (modelo BYO, "trae tu propia cuenta"). El CRM ENVÍA eventos de producto a tu analytics (ej.: cuando se gana un negocio o se crea un lead) y RECIBE eventos de vuelta, que se convierten en actividades en el Contacto correspondiente. No hay costo, margen ni intermediación de nuestra parte: los eventos van directo a tu cuenta y vuelven de ella.
La integración nace inerte: no ocurre nada hasta que completes las credenciales y actives. Todos los secretos (project token, API key, write key) se guardan cifrados en el CRM y nunca se muestran de vuelta. Cada plataforma tiene su propia tarjeta en Configuración → Integraciones; la URL del webhook es única (/api/inbound/analytics/…) y el CRM sabe de qué plataforma se trata por el token de la URL.
Requisitos previos
- Una cuenta de Mixpanel, Amplitude o Segment con acceso para ver las credenciales de ingesta.
- Mixpanel: el Project Token (Settings → Project Settings). Amplitude: la API Key del proyecto (Settings → Projects). Segment: la Write Key de una fuente HTTP API (Connections → Sources).
- Para recibir eventos de vuelta, la capacidad de apuntar un export/webhook del proveedor a una URL.
- En Sellio, ser administrador para guardar las credenciales y activar la integración en Configuración → Integraciones.
Cómo funciona
- Salida (CRM → proveedor): cada evento se envía con un identificador de la persona (distinct id / user id, por defecto el correo del registro) y propiedades. El envío es idempotente por la clave de deduplicación del proveedor: Mixpanel usa $insert_id, Amplitude usa insert_id y Segment usa messageId; reenviar el mismo evento no duplica.
- Entrada (proveedor → CRM): cuando el proveedor hace POST de un evento a la URL del webhook, el CRM registra una actividad y la vincula al Contacto con el correo correspondiente. Si el correo no existe en el CRM, la actividad queda sin vínculo (nada se pierde).
- La manera recomendada de enviar eventos es la acción de automatización "Enviar evento (analytics)" (ver abajo). El botón "Enviar evento de prueba" en la tarjeta valida la configuración de extremo a extremo.
La acción de automatización "Enviar evento (analytics)"
En Configuración → Automatizaciones, crea o edita una regla y agrega la acción "Enviar evento (analytics)". Elige el proveedor (Mixpanel/Amplitude/Segment), el nombre del evento (ej.: "Negocio ganado"; puedes usar {{campo}} para interpolar datos del registro) y, opcionalmente, el identificador de la persona (distinct id, cuyo predeterminado es {{email}}). Cuando la regla se dispara, el evento se envía post-commit, best-effort. Si la integración no está activa, la acción simplemente no hace nada (gated).
Mixpanel
- Abre Configuración → Integraciones y localiza la tarjeta "Product analytics (Mixpanel)".
- Pega el Project Token (Mixpanel → Settings → Project Settings → Project Token) y elige la región (UE solo si tu proyecto usa la residencia de datos europea). Haz clic en "Guardar analytics".
- Haz clic en "Activar". Usa "Enviar evento de prueba" con cualquier distinct id para confirmar.
- Para recibir eventos, apunta un webhook/export de Mixpanel a la "URL del webhook". Mixpanel no firma los webhooks de export: la seguridad está en el token impredecible de la URL; trátala como secreta.
Amplitude
- En el CRM, localiza la tarjeta "Product analytics (Amplitude)".
- Pega la API Key (Amplitude → Settings → Projects → API Key) y elige la región. Haz clic en "Guardar analytics" y luego en "Activar".
- Los eventos de salida van a /2/httpapi. Para recibir eventos, apunta un export/webhook de Amplitude a la "URL del webhook" (Amplitude no firma: el token de la URL es el guardián).
Segment
- En el CRM, localiza la tarjeta "Product analytics (Segment)".
- Crea una fuente HTTP API en Segment (Connections → Sources) y pega la Write Key. Opcionalmente, define un secreto de webhook (para exigir la firma en la entrada). Haz clic en "Guardar analytics" y en "Activar".
- Salida: los eventos van a /v1/track autenticados por Basic auth de la write key. Entrada: crea un destino Webhook (o una function) en Segment apuntando a la "URL del webhook". Por defecto Segment no firma; si definiste un secreto, el CRM verifica el header x-signature (HMAC-SHA1); si no, el token de la URL es el guardián.
Trata las URLs de los webhooks y las credenciales como secretas. Si intentas activar sin las credenciales necesarias, la integración queda inerte: no se envía ni recibe nada hasta que todo esté en su lugar.
Cómo probar
- Salida: haz clic en "Enviar evento de prueba" en la tarjeta con cualquier distinct id y confirma, en tu Mixpanel/Amplitude/Segment, que el evento llegó (Live View / Debugger).
- Automatización: crea una regla con la acción "Enviar evento (analytics)" y dispárala; verifica el evento en el proveedor.
- Entrada: haz que el proveedor envíe un evento a la "URL del webhook" para un correo que exista como Contacto y verifica la actividad en el Contacto.
Solución de problemas
- Error 401/el evento no aparece: credencial incorrecta. Mixpanel → Project Token; Amplitude → API Key; Segment → Write Key (autenticada por Basic auth). Vuelve a pegar la credencial correcta.
- Región incorrecta: si tu proyecto usa residencia de datos en la UE, marca la región UE; de lo contrario, los eventos van al endpoint incorrecto y no aparecen.
- La automatización no envía: la acción "Enviar evento (analytics)" es gated: si la integración no está activa, no hace nada. Activa la integración y confirma el proveedor seleccionado en la acción.
- La entrada no se convierte en actividad: si el correo del evento no existe en el CRM, la actividad queda sin vínculo (nada se pierde). Segment: si definiste un secreto, valida el header x-signature (HMAC-SHA1).
- 404 en la URL del webhook: integración desactivada o token cambiado; reactiva y vuelve a copiar la URL.