Pular para o conteúdo principal

Fontes de Leads

O Que É uma Conexão de Fonte de Leads?​

Uma conexão de fonte de leads informa ao LeadHub de onde receber leads. Quando alguém preenche seu Facebook Lead Ad, envia seu formulário do Google Ads, agenda um compromisso no Calendly ou preenche seu formulário web, o LeadHub precisa saber para criar um lead automaticamente.

Uma conexão de fonte é a ponte entre essa plataforma externa e o LeadHub. Você a configura uma vez no painel de administração e, a partir daí, cada nova submissão chega ao LeadHub em tempo real — sem copiar e colar manualmente.

Fontes Suportadas​

O LeadHub suporta conexões de 18 plataformas:

FonteO que captura
Facebook Lead AdsLeads de campanhas Meta Lead Ads no Facebook
Instagram LeadsLeads de campanhas Instagram Lead Ads
TikTok Lead GenerationLeads de formulários TikTok Lead Generation
LinkedIn Lead Gen FormsLeads de campanhas LinkedIn Lead Gen Form
WhatsApp BusinessLeads enviados via webhook do WhatsApp Business
ViberLeads enviados via webhook do Viber
TelegramLeads enviados via webhook do Telegram
Twitter / XLeads de campanhas Twitter/X via webhook
Snapchat Lead AdsLeads do Snapchat Lead Ads
Pinterest Lead AdsLeads do Pinterest Lead Ads
Google Ads Lead FormsLeads de extensões de formulário de leads do Google Ads
YouTube Lead FormsLeads de extensões de anúncios de formulário do YouTube
Microsoft AdvertisingLeads de formulários de leads do Microsoft Ads
Email (IMAP)Leads extraídos de uma caixa de entrada de email conectada
TypeformLeads de submissões de formulários Typeform
JotFormLeads de submissões de formulários JotForm
CalendlyLeads de confirmações de agendamento do Calendly
LeadHub Web FormLeads de formulários que você cria dentro do LeadHub

Como Criar uma Conexão de Fonte​

  1. Vá para Integrações > Fontes de Leads na barra lateral esquerda.
  2. Clique em Nova Fonte de Leads.
  3. Preencha:
    • Nome da Conexão — um nome para esta conexão específica. Seja descritivo, p. ex. "Facebook – Campanha de Verão" ou "Google Ads – Palavras-chave da Marca". Você pode ter várias conexões da mesma fonte.
    • Tipo de Fonte — escolha a plataforma no menu suspenso.
    • Ativo — deixe ativado.
  4. Clique em Criar para salvar a conexão.

Após salvar, o formulário se expande para mostrar opções adicionais dependendo do tipo de fonte:

  • Para fontes baseadas em webhook (a maioria das plataformas), você verá sua URL de Webhook exclusiva. Copie esta URL e cole nas configurações de webhook ou integração da plataforma de origem.
  • Para fontes baseadas em OAuth (Facebook, Instagram, TikTok, LinkedIn, Google Ads, Microsoft Ads), você verá uma seção de Autorização OAuth. Siga as instruções na tela para conectar via OAuth.
  • Para Email (IMAP), você verá campos de credenciais para seu servidor de email.

Atribuir um Pipeline e Estágio Padrão​

Ao editar uma conexão de fonte, role até a seção Configurações para atribuir um pipeline e estágio padrão. Cada lead que chegar por esta conexão será automaticamente colocado no pipeline e estágio que você escolher aqui.

Isso é muito útil se você executa múltiplas campanhas — cada campanha tem sua própria conexão de fonte, cada uma apontando para um estágio de pipeline diferente. Os leads são organizados automaticamente no momento em que chegam.

Fontes Baseadas em Webhook​

A maioria das fontes (Facebook, Google Ads, TikTok, LinkedIn, WhatsApp, Calendly, Typeform, JotForm, etc.) funciona via webhooks.

Como a URL de Webhook Funciona​

Quando você cria uma conexão de fonte, o LeadHub gera uma URL de webhook única e secreta apenas para essa conexão. Ela se parece com isto:

https://yourdomain.com/webhook/inbound/{tenant-id}/{source}/{token}

Esta URL é:

  • Única — cada conexão tem sua própria URL com um token aleatório de 48 caracteres
  • Secreta — somente a plataforma que conhece esta URL pode enviar leads para ela
  • Sempre ativa — aceita dados recebidos automaticamente 24/7

Você copia esta URL da página de edição da conexão (ela aparece na seção "URL de Webhook" após salvar a conexão) e a cola na plataforma de origem.

Onde Encontrar a URL de Webhook​

  1. Vá para Integrações > Fontes de Leads.
  2. Clique no ícone de editar (lápis) na sua conexão.
  3. A seção "URL de Webhook" mostra sua URL exclusiva com um botão de copiar.

Mapeamento de Campos​

Quando um lead chega via webhook, a plataforma de origem envia dados em seu próprio formato. O LeadHub tenta automaticamente mapear os campos recebidos para os campos de lead corretos (nome, email, telefone, etc.).

Se o mapeamento automático não capturar um campo que você precisa, você pode configurar o mapeamento de campos personalizado nas configurações da conexão. Esta é uma lista de chave-valor onde você diz ao LeadHub: "Quando os dados recebidos tiverem um campo chamado full_name, coloque-o no campo first_name do lead."

Fontes Baseadas em OAuth​

Algumas plataformas (Facebook, Instagram, TikTok, LinkedIn, Google Ads, Microsoft Ads) usam OAuth para autorizar a conexão. Isso significa que, em vez de copiar uma URL de webhook, você clica em um botão e faz login na plataforma para conceder ao LeadHub permissão para receber seus leads.

Como conectar via OAuth:

  1. Crie e salve primeiro a conexão de fonte.
  2. Volte para a lista de Fontes de Leads.
  3. Clique no botão Conectar via OAuth na linha da conexão.
  4. Você será redirecionado para a página de login da plataforma.
  5. Faça login e clique em Permitir ou Autorizar.
  6. Você é redirecionado de volta ao LeadHub. O status da conexão muda para Conectado.

Suas credenciais de API (token de acesso, token de atualização) são armazenadas automaticamente e criptografadas. Você nunca precisa copiar e colar tokens manualmente.

Fonte de Email (IMAP)​

A fonte de Email conecta o LeadHub a uma caixa de entrada de email. Quando alguém envia um email para essa caixa de entrada, o LeadHub lê o email e cria um lead a partir dele.

Como configurar:

Quando você cria uma conexão de fonte de Email, verá campos de credenciais na seção Credenciais de API:

  • Host IMAP — o endereço do seu servidor de email (p. ex. imap.gmail.com)
  • Porta IMAP — normalmente 993 para SSL
  • Nome de usuário — o endereço de email (p. ex. [email protected])
  • Senha — a senha da conta de email ou senha de aplicativo

Como funciona: O LeadHub verifica periodicamente sua caixa de entrada em busca de novos emails (em um horário regular). Quando encontra novos emails, extrai o nome e o endereço de email do remetente e cria um lead. O assunto e o corpo do email são armazenados como notas do lead.

Dica para Gmail: O Google exige que você use uma "Senha de aplicativo" em vez de sua senha de conta regular. Acesse as configurações de segurança da sua Conta do Google e crie uma Senha de aplicativo para o LeadHub.

Dica: Crie um endereço de email dedicado apenas para leads (p. ex. [email protected]) em vez de conectar sua caixa de entrada principal de negócios. Isso mantém as coisas organizadas e evita que o LeadHub processe emails que não são consultas de leads.

Mapeamento de Campos Explicado​

O mapeamento de campos é como o LeadHub sabe qual parte dos dados recebidos vai para qual campo de lead.

Quando o Facebook envia um lead, pode enviar um campo chamado full_name. O LeadHub precisa saber para dividir isso em first_name e last_name. Quando o Calendly envia uma reserva, pode enviar invitee_email. O LeadHub precisa saber que vai para o campo email.

Mapeamento automático: O LeadHub tem mapeamento integrado para nomes de campos comuns de cada plataforma. Na maioria das vezes simplesmente funciona.

Mapeamento personalizado: Se você tiver perguntas personalizadas no seu formulário de leads (p. ex. "Qual é o seu orçamento?"), pode dizer ao LeadHub onde colocar a resposta. Na seção Configurações da conexão, adicione uma entrada de mapeamento:

  • Nome do campo recebido — exatamente como a plataforma o envia (p. ex. question_budget)
  • Campo do lead — onde armazená-lo (p. ex. uma chave de campo personalizado que você configurou)

Análise de Desempenho de Fontes​

Vá para Relatórios > Desempenho de Fontes para ver o desempenho de cada conexão de fonte. O relatório mostra:

  • Total de leads recebidos por fonte
  • Taxa de conversão por fonte
  • Leads ao longo do tempo por fonte

Você pode usar isso para ver quais de seus canais de publicidade estão realmente entregando leads de qualidade, não apenas quantidade.

Desativar e Editar Conexões de Fonte​

Para pausar temporariamente uma conexão (parar de receber leads sem excluí-la):

  1. Vá para Integrações > Fontes de Leads.
  2. Clique no ícone de editar (lápis) na conexão.
  3. Desative Ativo.
  4. Clique em Salvar.

A conexão está pausada. Leads enviados para sua URL de webhook serão ignorados até que você a reative.

Para editar uma conexão (renomeá-la, atualizar credenciais, alterar mapeamento de campos):

  1. Vá para Integrações > Fontes de Leads.
  2. Clique no ícone de editar (lápis).
  3. Faça suas alterações e clique em Salvar.

Para excluir uma conexão permanentemente: Clique no ícone de lixeira na linha da conexão. A conexão é excluída. Os leads já recebidos por ela permanecem no seu sistema — não são excluídos.