Este documento técnico foi cuidadosamente desenvolvido para orientar Fornecedores e Lojistas na configuração avançada do complemento de Integração e Sincronização de Leads do Facebook, destinado à automação de captura de leads gerados em anúncios do Facebook e à integração inteligente com a plataforma Chat-Bot, que opera conectada à API oficial da Meta Business.
O objetivo deste módulo é fornecer um passo a passo altamente profissional, claro e eficiente, que permita aos usuários configurar o sistema com segurança, autonomia e precisão — aproveitando ao máximo a poderosa união entre Facebook Leads Ads → Webhooks Meta → Chat-Bot → WhatsApp.
Após instalar o complemento, esta etapa concentra-se totalmente na configuração operacional, que envolve:
Preparação do ambiente Meta Developer
Autorização do aplicativo
Configuração de Webhooks
Conexão de páginas
Sincronização de leads em tempo real
Mapeamento de campos e ações automáticas
👉 Todas as funcionalidades descritas aqui são 100% compatíveis com a arquitetura multiusuário da plataforma Chat-Bot.
IMPORTANTE
Nenhuma informação original foi removida. Todo o conteúdo foi aprimorado, expandido e reorganizado para máxima clareza e profundidade técnica, conforme solicitado.
Abaixo está o fluxo completo que os Lojistas/Fornecedores devem seguir após o complemento ser instalado e ativado pelo administrador da plataforma.
Faça login na conta do Lojista/Fornecedor dentro da plataforma Chat-Bot.
Acesse o Painel de Controle.
No menu lateral, clique em Configurações do Aplicativo.
Role até encontrar a seção Integração de Leads do Facebook.
"Tela do Painel de Controle Chat-Bot com a opção 'Configurações do Aplicativo' destacada em azul, e a seção 'Integração de Leads do Facebook' sinalizada com ícone de Facebook e engrenagem."
Esta etapa é essencial e deve ser executada antes de qualquer tentativa de conexão.
Conta de desenvolvedor Meta ativa
Conta comercial do Facebook
Ambiente em servidor com SSL válido
Endpoint público acessível
Acesse o site Meta Developers.
Crie uma conta de desenvolvedor (caso ainda não tenha).
Clique em Criar aplicativo.
Escolha a categoria Empresa.
Insira:
Nome do aplicativo
E-mail de contato
Clique em Criar Aplicativo.
Após isso:
Copie o ID do Aplicativo
Copie o Segredo do Aplicativo
Você precisará desses dados na etapa seguinte.
"Interface da Meta Developers mostrando o botão 'Criar Aplicativo', com três cartões representando possíveis categorias e o cartão 'Empresa' selecionado com borda azul brilhante."
Agora retorne à plataforma Chat-Bot.
Vá até Configurações do Aplicativo → Integração de Leads do Facebook.
Ative a chave: Ativar Integração de Leads do Facebook.
Preencha:
ID do Aplicativo do Facebook
Segredo do Aplicativo do Facebook
O sistema irá gerar automaticamente:
Token de Verificação do Webhook
URL do Webhook
Clique em Salvar Configurações.
"Tela de configuração com campos preenchidos para ID do Aplicativo, Segredo do Aplicativo, Webhook URL e Token de Verificação, com botão 'Salvar Configurações' destacado."
Abra o aplicativo no painel Meta Developer.
Clique em Adicionar Produto → Webhooks.
Dentro de Webhooks → Página, clique em Criar Assinatura.
Preencha:
URL de Callback: URL gerada pelo Chat-Bot
Token de Verificação: token gerado pelo Chat-Bot
Clique em Verificar e Salvar.
Se apresentar erro, verifique:
SSL
Token
Disponibilidade do servidor
Firewall ou restrições de entrada
Após validar o webhook:
Localize o evento leadgen
Marque a caixa
Clique em Inscrever-se
"Tela de Webhooks Meta com o item 'Página' expandido, mostrando os campos de Callback URL e Verify Token preenchidos, e o checkbox 'leadgen' ativado."
De volta ao Chat-Bot:
Em Integração de Leads do Facebook, clique em Testar Conexão.
A confirmação deve exibir: Conexão Bem-Sucedida.
Ative: Habilitar Processamento de Leads.
Salve novamente.
Clique em Buscar Páginas do Facebook.
A plataforma listará todas as páginas vinculadas ao aplicativo.
Para cada página desejada, clique em:
→ Inscrever-se para Receber Leads
O status deve aparecer como Inscrito.
Pode existir um atraso entre 5 e 15 minutos para que novos leads apareçam, devido a:
Fila de processamento Webhook
Tarefas Cron configuradas no servidor
Objetivo da campanha: Geração de Leads
Selecione a página inscrita
Crie um formulário com campos básicos
Publique a campanha
Preencha o formulário com seu próprio contato
No painel:
Acesse Contatos
Filtre por origem: Facebook
Valide:
Nome
Telefone
Campos personalizados
Acesse:
Configurações → Integração com Facebook → Mapeamento de Campos
Lá você poderá associar:
Campos do formulário
→ aos
Campos internos do contato do Chat-Bot
Após mapear, clique em Salvar.
É possível ativar automações como:
Envio automático de mensagem WhatsApp
Atribuição do lead a um membro da equipe
Criação de tarefas internas
Disparo de notificações internas
Configuração:
Vá até Configurações de Ações
Ative as ações desejadas
Configure parâmetros
Clique em Salvar Configurações
"Fluxograma visual mostrando: Facebook Leads → Webhook Meta → Chat-Bot → Contatos → Mensagens Automáticas WhatsApp."
Após concluir essas etapas, seu ambiente estará totalmente integrado e pronto para:
Capturar leads em tempo real ✔️
Estruturar contatos automaticamente ✔️
Iniciar conversas inteligentes via WhatsApp ✔️
Nutrir leads com fluxos avançados Chat-Bot ✔️
Página Anterior: Instalação
Próxima Página: Integração com o Facebook