Pular para o conteúdo principal

Fontes de Leads — Guia de Configuração

O LeadHub pode receber leads de 19 fontes diferentes. A maioria das fontes funciona via webhook — você cola uma URL gerada pelo LeadHub na plataforma externa e os leads chegam automaticamente.

Como Funciona Cada Fonte Baseada em Webhook​

  1. Vá para Integrações → Fontes de Leads e crie uma nova conexão.
  2. Selecione o tipo de fonte e configure o mapeamento de campos.
  3. Copie a URL do Webhook de Entrada gerada.
  4. Cole a URL na plataforma externa (instruções por fonte abaixo).
  5. Teste enviando um lead de teste — ele aparece no seu workspace em segundos.

Facebook Lead Ads (Meta)​

O Facebook Lead Ads permite que usuários enviem um formulário dentro do Facebook/Instagram sem sair do app.

A Meta removeu a opção "Outro" de CRM

A Meta não oferece mais a opção Outro em Integração com CRM nos formulários de leads, então não é mais possível colar uma URL de webhook no nível do formulário. Em vez disso, conecte via OAuth e um webhook no nível do app, conforme descrito abaixo.

Passo 1 — Configure seu App da Meta​

Crie (ou abra) um app do tipo Business em developers.facebook.com:

  1. Adicione o produto Facebook Login.

  2. Configurações do App → Básico → Domínios do App: adicione seu domínio do LeadHub (ex.: crm.example.com).

  3. Facebook Login → Configurações → URIs de Redirecionamento OAuth Válidos: adicione

    https://YOUR-DOMAIN/oauth/meta/callback

    Isso deve corresponder exatamente ao APP_URL da sua instalação, incluindo https.

dica

Adicionar o domínio e a URI de redirecionamento também corrige o erro "Can't load URL. The domain of this URL isn't included in the app's domains."

Passo 2 — Conecte no LeadHub​

  1. Vá para Conexões de Fontes de Leads e adicione uma conexão Meta.
  2. Insira seu App ID e App Secret.
  3. Clique em Conectar via OAuth, aprove as permissões solicitadas e selecione sua Página.
  4. O LeadHub armazena seu token de acesso da Página na conexão automaticamente.

Passo 3 — Configure o Webhook de Leadgen (Nível do App da Meta)​

Isso substitui a opção "Outro" removida do nível do formulário:

  1. No Painel do App → Webhooks, escolha o objeto Page.
  2. Inscreva-se no campo leadgen.
  3. URL de Callback e Token de Verificação: copie ambos da tela da conexão Meta no LeadHub.
  4. Inscreva sua Página.

Os novos leads agora chegam automaticamente — a Meta envia cada lead para o webhook e o LeadHub busca os detalhes completos do lead na Graph API usando seu token de acesso da Página.

Permissões e Análise do App​

A conexão OAuth solicita estes escopos: leads_retrieval, pages_show_list, pages_read_engagement, pages_manage_ads.

Essas permissões exigem Análise do App da Meta (App Review) + Verificação de Negócios (Business Verification) antes de funcionarem para contas que não sejam Administradores, Desenvolvedores ou Testadores do próprio app.

Para testar antes da aprovação:

  • Adicione-se como Administrador / Desenvolvedor / Testador no app da Meta, ou
  • Cole um Page Access Token (gerado no Graph API Explorer da Meta com leads_retrieval) no campo Page Access Token da conexão — o LeadHub lê os leads diretamente com ele.

Exemplo de Mapeamento de Campos​

Campo do FacebookCampo do LeadHub
full_namefirst_name
emailemail
phone_numberphone

Alternativamente, use Zapier ou n8n como ponte se precisar de mais controle sobre o payload.

Instagram Leads​

Os Lead Ads do Instagram compartilham a mesma infraestrutura do Meta Ads que os do Facebook. Siga os mesmos passos acima.

TikTok Lead Generation​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → TikTok Lead Generation.
  2. Copie a URL do Webhook.
  3. No TikTok Ads Manager → Ativos → Lead Generation → Webhook:
    • Clique em Criar Webhook.
    • Cole a URL do Webhook do LeadHub.
    • Selecione os campos a serem enviados.
  4. Envie um lead de teste para verificar a entrega.

LinkedIn Lead Gen Forms​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → LinkedIn Lead Gen Forms.
  2. Copie a URL do Webhook.
  3. No LinkedIn Campaign Manager → Ativos da Conta → Lead Gen Forms → Integrações:
    • Escolha seu formulário Lead Gen.
    • Em Integrações, selecione Outras integrações → Webhook.
    • Cole a URL do Webhook.

WhatsApp Business​

Configuração via API do WhatsApp Business (Cloud API)​

  1. Crie uma Conexão de Fonte de Lead: Tipo → WhatsApp Business.
  2. Copie a URL do Webhook.
  3. No Meta Business → WhatsApp → Configuração → Webhooks:
    • Defina a URL de Callback para a URL do Webhook do LeadHub.
    • Defina o Token de Verificação (mostrado nas configurações de conexão do LeadHub).
    • Inscreva-se em eventos de messages.

Telegram​

Passos de Configuração​

  1. Crie um bot do Telegram via @BotFather:
    • Envie /newbot para o BotFather.
    • Escolha um nome e nome de usuário.
    • Copie o Token do Bot.
  2. No LeadHub, crie uma Conexão de Fonte de Lead: Tipo → Telegram.
  3. Insira o Token do Bot na configuração da conexão.
  4. O LeadHub registra um webhook na API do Telegram automaticamente.
  5. Quando um usuário envia /start ou qualquer mensagem ao seu bot, um lead é criado.

O que o LeadHub Captura do Telegram​

Campo TelegramCampo LeadHub
first_namePrimeiro Nome
last_nameÚltimo Nome
usernamearmazenado em Notas
message textarmazenado em Notas

Viber​

Passos de Configuração​

  1. Crie uma Conta Empresarial Viber em partners.viber.com.
  2. Obtenha seu Token do Bot Viber.
  3. No LeadHub, crie uma Conexão de Fonte de Lead: Tipo → Viber.
  4. Insira o Token do Bot — o LeadHub configura o webhook automaticamente.

Twitter / X​

Configuração via Zapier (Recomendado)​

  1. No Zapier, crie um Zap: Gatilho → Twitter → Nova Mensagem Direta.
  2. Ação → Webhooks by Zapier → POST para sua URL do Webhook do LeadHub.
  3. Mapeie sender_screen_name para um campo personalizado e text para Notas.

Snapchat Lead Ads​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → Snapchat Lead Ads.
  2. Copie a URL do Webhook.
  3. No Snapchat Ads Manager → Negócios → Snap Pixel e APIs → Lead Webhook:
    • Cole a URL do Webhook.
    • Selecione quais formulários de Lead Attachment conectar.

Pinterest Lead Ads​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → Pinterest Lead Ads.
  2. Copie a URL do Webhook.
  3. No Pinterest Ads Manager → Lead Ads → Webhook (ou via Zapier):
    • Cole a URL do Webhook ou configure uma ponte Zapier.

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → Google Ads Lead Forms.
  2. Copie a URL do Webhook.
  3. No Google Ads → Extensão de Formulário de Lead → Editar → Integração de Webhook:
    • Cole a URL do Webhook.
    • Insira a Chave do Webhook (mostrada na conexão do LeadHub — deixe em branco se não necessário).

YouTube Lead Forms​

Os Lead Forms do YouTube (parte do Google Ads) funcionam de forma idêntica às Lead Form Extensions do Google Ads. Siga os mesmos passos acima.

Microsoft Advertising (Bing Ads)​

Configuração via Zapier​

  1. No Zapier, crie um Zap: Gatilho → Microsoft Advertising → Novo Lead.
  2. Ação → Webhooks by Zapier → POST para sua URL do Webhook do LeadHub.
  3. Mapeie os campos: first_name, last_name, email, phone.

Typeform​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → Typeform.
  2. Copie a URL do Webhook.
  3. No Typeform → Seu Formulário → Conectar → Webhooks:
    • Clique em Adicionar um webhook.
    • Cole a URL do Webhook do LeadHub.
    • Ative o webhook.

JotForm​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → JotForm.
  2. Copie a URL do Webhook.
  3. No JotForm → Seu Formulário → Configurações → Integrações → Webhooks:
    • Cole a URL do Webhook.
    • Clique em Concluir Integração.

Calendly​

Passos de Configuração​

  1. Crie uma Conexão de Fonte de Lead: Tipo → Calendly.
  2. Copie a URL do Webhook.
  3. No Calendly → Integrações → Webhooks → Criar Novo Webhook:
    • Cole a URL do Webhook.
    • Selecione o evento invitee.created.
    • Escolha quais Tipos de Eventos monitorar.

Formulário Web do LeadHub​

Quando alguém envia um formulário criado com o Construtor de Formulários do LeadHub, um lead é criado automaticamente — sem necessidade de configuração de webhook. Consulte o Construtor de Formulários.

E-mail (IMAP)​

Passos de Configuração​

  1. Crie um endereço de e-mail dedicado para captura de leads (ex.: [email protected]).
  2. Vá para Integrações → Fontes de Leads e crie uma nova conexão: Tipo → E-mail (IMAP).
  3. Insira:
    • Host IMAP — seu servidor de e-mail
    • Porta IMAP — geralmente 993 (SSL) ou 143
    • Usuário — o endereço de e-mail
    • Senha — a senha do e-mail
    • Pasta — geralmente INBOX
  4. O LeadHub verifica a caixa de entrada a cada 5 minutos (via cron job) e cria um lead para cada novo e-mail.

Entrada Manual​

Crie leads diretamente no LeadHub sem nenhuma integração externa. Vá para Leads → Todos os Leads → Novo Lead.

Webhook Genérico (Qualquer Plataforma)​

Para qualquer plataforma não listada acima, use o tipo de conexão Webhook Genérico. Você recebe uma URL que aceita qualquer payload JSON e configura o mapeamento de campos para extrair dados do lead.

curl -X POST https://seudominio.com/inbound/SEUTOKEN \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","first_name":"Teste","last_name":"Lead","phone":"+5511999999999"}'