Skip to main content

​
Intercom

Conecta Intercom para recibir datos de atribución cuando se crean contactos. Un webhook de Intercom envía los atributos del contacto — incluido un atributo personalizado “¿Cómo nos encontraste?” — a Finseo, que normaliza la respuesta en un canal de atribución.

​
Requisitos

  • Los webhooks de Intercom se configuran mediante una app del Developer Hub (una app interna gratuita para tu workspace).
  • Un atributo personalizado en los contactos que capture la respuesta de atribución.

​
Obtén tu URL de webhook

  1. En Finseo, abre Integrations → Intercom → Connect.
  2. Copia tu URL de webhook personal (contiene el ID de tu proyecto, ?source=intercom y un token secreto):

​
Configura el webhook de Intercom

  1. Abre el Developer Hub de Intercom y crea una app interna (o abre una existente).
  2. Bajo Configure → Webhooks, pega tu URL de Finseo como endpoint. Intercom valida la URL con una petición HEAD.
  3. Suscríbete a topics como contact.user.created y contact.lead.created (añade conversation.admin.closed si capturas la respuesta en conversaciones).
  4. En la página Authentication de la app, habilita los permission scopes que requieren los topics (p. ej. “Read and write users”) — sin ellos el webhook no se dispara.
  5. Guarda.
Consulta la guía de configuración de webhooks de Intercom para más detalles.

​
Prueba y mapea los campos

  • Usa el live listener en el diálogo de conexión de Finseo: crea un contacto de prueba e inspecciona el payload recibido.
  • Selecciona tu atributo personalizado de atribución bajo Field Mapping si no se detecta automáticamente.

​
Troubleshooting

Comprueba que los permission scopes que requiere el topic están habilitados en la página Authentication de la app — los topics sin scopes correspondientes se omiten silenciosamente.
Los topics disponibles dependen de la versión de la API que usa tu app. Actualiza la versión de la API de la app en el Developer Hub si es necesario.