Integração com Meta Lead Ads
Quando alguém preenche o formulário nativo de um anúncio de geração de cadastro (Lead Ads) no Instagram ou Facebook, o HomeChat recebe o evento da Meta, busca os dados que a pessoa informou e já abre a conversa no WhatsApp com essas informações — sem alguém precisar copiar nada manualmente.
O que essa integração faz
O HomeChat é notificado pela Meta no instante em que alguém envia o formulário do seu anúncio, sem depender de exportação manual.
O aviso da Meta não traz as respostas — o HomeChat faz uma segunda chamada autenticada para buscar exatamente o que a pessoa preencheu (nome, telefone, e-mail e campos personalizados).
O lead entra pelo mesmo fluxo de captação de leads do HomeChat e já abre uma conversa no WhatsApp, com telefone e nome preenchidos.
Cada lead chega identificado como vindo de Lead Ads, com a campanha de origem quando a Meta a informa — útil para saber qual anúncio gerou aquela conversa.
O que você precisa para conectar
Essa integração depende de permissões específicas da Meta para páginas e formulários de anúncio:
- Uma página do Facebook com anúncios de geração de cadastro (Lead Ads) ativos ou planejados
- Um token de acesso da página com a permissão leads_retrieval da Meta — sem essa permissão a Meta avisa que um lead chegou, mas nega o acesso às respostas
- O formulário do anúncio vinculado do lado do HomeChat, para saber para qual organização aquele lead pertence
Como funciona por trás
A Meta envia um webhook (evento "leadgen") assim que alguém preenche o formulário do anúncio — mas esse aviso só traz identificadores, nunca as respostas da pessoa. Para ter os dados reais, o HomeChat faz uma segunda chamada à Graph API da Meta, autenticada com um token de acesso da página que tenha a permissão leads_retrieval.
Esse token de acesso da página fica salvo do lado do HomeChat, associado à página do Facebook de onde o anúncio roda — sem ele, o aviso do lead chega mas os dados não podem ser buscados.
Depois de buscar os dados, o lead segue pelo mesmo mecanismo interno de captação de leads do HomeChat (o mesmo usado por formulários de outras origens), que identifica telefone, nome e e-mail e já inicia a conversa no WhatsApp.
Hoje o vínculo entre a página de anúncios, o formulário específico e a organização do HomeChat é configurado pela nossa equipe durante a implantação — ainda não existe uma tela de autoatendimento para conectar isso sozinho, então esse passo é feito junto com você.
Dúvidas comuns sobre a integração com Meta Lead Ads
Não. O HomeChat é avisado pela Meta assim que o formulário é preenchido e busca os dados automaticamente, sem depender de exportação manual do gerenciador de anúncios.
Sim, para anúncios de geração de cadastro (Lead Ads) que usam o formulário nativo da Meta, seja veiculado no Instagram ou no Facebook.
Não. Os dados que a pessoa preencheu (nome, telefone e demais campos) já chegam junto quando a conversa é aberta automaticamente no WhatsApp.
Hoje esse vínculo entre a página de anúncios e a organização é configurado junto com nossa equipe durante a implantação, não por uma tela de autoatendimento. Fale com a gente para configurar.
A Meta continua avisando que um lead chegou, mas a busca dos dados falha até o token ser renovado. Nossa equipe acompanha esse tipo de falha para agir rápido.
Vamos te mostrar como funciona na prática.
20 minutos, no seu horário, mostrando o HomeChat com o seu jeito de atender.