Fontes de leads e webhooks: receber contatos de anúncios e páginas externas

O que é uma fonte de leads

Uma fonte identifica de onde os contatos chegam ao Teha e define o destino padrão de cada lead. Ela é indicada para integrações de Meta Ads, Google Ads, TikTok Ads, landing pages, Elementor e sistemas próprios.

O formulário e quiz nativos do Teha já fazem essa captura sem webhook externo. Crie uma fonte quando outro sistema precisa enviar os dados para o CRM.

Criar uma fonte

1. Abra Configurações → Integrações → Captação.
2. Em Fontes de leads, clique em Nova fonte de leads.
3. Dê um nome que deixe a origem inequívoca, como Meta Ads - Diagnóstico comercial.
4. Escolha o tipo de origem.
5. Escolha o funil e a etapa padrão. Esta escolha determina onde o negócio será criado quando a fonte não tiver um vínculo mais específico no Tráfego.
6. Opcionalmente, defina tags automáticas, fluxo de boas-vindas e o mapeamento de campos.
7. Salve e copie a URL de captura exibida pela fonte.

Mapear os campos do sistema externo

O Teha reconhece nome, telefone, e-mail e empresa. Quando o site usa outro nome de campo, mapeie-o na própria fonte, por exemplo:

• nome_completo → Nome;
• celular → Telefone;
• email_profissional → E-mail;
• razao_social → Empresa.

Faça um envio de teste depois de cada mapeamento. Sem nome e telefone ou e-mail, o Teha não deve criar um contato identificado.

Enviar pelo webhook

O endpoint da fonte aceita JSON, formulário tradicional, multipart/form-data e campos enviados pelo Elementor. Um exemplo mínimo é:

{
  "name": "João Silva",
  "phone": "5511999999999",
  "email": "[email protected]",
  "company": "Empresa X"
}

Também envie, quando disponíveis, utm_source, utm_medium, utm_campaign, utm_content, utm_term, utm_id, fbclid, gclid e ttclid. Eles formam o histórico de aquisição do contato e permitem analisar o resultado no módulo Tráfego.

Trate a URL de captura como segredo operacional: não a exponha em capturas de tela, e não a publique em documentos abertos ou repositórios. Se suspeitar de uso indevido, desative a fonte e crie outra.

Diagnosticar antes de colocar verba

Abra a fonte e clique em Executar diagnóstico. O diagnóstico verifica se:

• a fonte está ativa;
• funil e etapa ainda existem;
• o responsável pertence à organização;
• os segredos obrigatórios da integração estão configurados.

Ele não exibe o valor dos segredos. Corrija tudo que aparecer como falha antes de ativar campanhas ou automações.

Como o destino é escolhido

O Teha usa esta ordem:

1. Vínculo específico do módulo Tráfego, quando houver e o formulário/fonte permitir roteamento por tráfego.
2. Funil e etapa escolhidos na fonte.
3. Funil padrão da organização e sua primeira etapa aberta.

Por isso, use nomes claros para fontes e não apague etapas usadas em integrações ativas. Quando quiser mudar o caminho dos novos leads, altere a fonte ou o vínculo; não mova manualmente cada contato que já chegou.

Teste operacional

Envie um lead de teste com uma tag de teste e uma UTM identificável. Em seguida, confira contato, negócio, funil, etapa, tags e histórico de origem. Só depois remova a tag e ligue a campanha real.