Webhook personalizado
Use o endpoint de webhook genérico para enviar dados de atribuição a partir de qualquer integração personalizada — o seu próprio backend, um handler de formulários ou uma ferramenta interna. O Finseo deteta automaticamente formatos de payload conhecidos (HubSpot, Salesforce, Typeform, Jotform, …) e também aceita JSON simples.Obter o seu URL de webhook
- No Finseo, abra Integrations → Custom Webhook → Connect.
- Copie o seu URL de webhook pessoal (contém o ID do seu projeto e um token secreto):
Enviar um pedido
Faça POST de JSON com, no mínimo, umchannelId (ou um freetextResponse que o Finseo categoriza):
channelId, channelLabel, channelCategory, subChannel, freetextResponse, respondentEmail, respondentName, respondentExternalId, dealValue, dealCurrency, pageUrl, formId, metadata.
Testar e mapear campos
- A janela de ligação tem um live listener: ative-o, envie um pedido e o Finseo mostra o payload recebido com o resultado do parsing.
- Para payloads fora do padrão, use o Field Mapping para indicar ao Finseo qual o campo que contém a resposta de atribuição.
Segurança
- O parâmetro de query
tokenautentica os pedidos — trate o URL como um segredo. Pode regenerar o token na janela de ligação a qualquer momento (o URL antigo deixa de funcionar de imediato). - Opcionalmente, configure um webhook de saída nas definições de Attribution para ser notificado sobre novas respostas nos seus próprios sistemas.
Resolução de problemas
Os pedidos são rejeitados
Os pedidos são rejeitados
Verifique que o URL inclui o
token atual — depois de regenerar, os URLs antigos ficam inválidos. O corpo tem de ser JSON (ou form-encoded para fornecedores conhecidos).A resposta cai no canal errado
A resposta cai no canal errado
Envie um
channelId explícito em vez de depender da categorização de texto livre, ou ajuste o Field Mapping.