Skip to main content

Intercom

Ligue o Intercom para receber dados de atribuição quando são criados contactos. Um webhook do Intercom envia os atributos do contacto — incluindo um atributo personalizado “Como nos encontrou?” — para o Finseo, que normaliza a resposta num canal de atribuição.

Requisitos

  • Os webhooks do Intercom são configurados através de uma app do Developer Hub (uma app interna gratuita para o seu workspace).
  • Um atributo personalizado nos contactos que capture a resposta de atribuição.

Obter o seu URL de webhook

  1. No Finseo, abra Integrations → Intercom → Connect.
  2. Copie o seu URL de webhook pessoal (contém o ID do seu projeto, ?source=intercom e um token secreto):

Configurar o webhook do Intercom

  1. Abra o Intercom Developer Hub e crie uma app interna (ou abra uma existente).
  2. Em Configure → Webhooks, cole o seu URL do Finseo como endpoint. O Intercom valida o URL com um pedido HEAD.
  3. Subscreva tópicos como contact.user.created e contact.lead.created (adicione conversation.admin.closed se capturar a resposta em conversas).
  4. Na página Authentication da app, ative os scopes de permissões que os tópicos exigem (p. ex. “Read and write users”) — sem eles o webhook não dispara.
  5. Guarde.
Consulte o guia de configuração de webhooks do Intercom para mais detalhes.

Testar e mapear campos

  • Use o live listener na janela de ligação do Finseo: crie um contacto de teste e inspecione o payload recebido.
  • Selecione o seu atributo personalizado de atribuição em Field Mapping se não for detetado automaticamente.

Resolução de problemas

Verifique que os scopes de permissões exigidos pelo tópico estão ativados na página Authentication da app — tópicos sem os scopes correspondentes são ignorados silenciosamente.
Os tópicos disponíveis dependem da versão da API que a sua app usa. Se necessário, atualize a versão da API da app no Developer Hub.