Configurações do complemento de integração e sincronização de leads do Facebook


⚙️ Configurações do complemento de integração e sincronização de leads do Facebook


⚙️ Configurações do Complemento de Integração e Sincronização de Leads do Facebook

📘 Guia Oficial de Configuração — Plataforma Chat-Bot

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.


🏗️ VISÃO GERAL DA CONFIGURAÇÃO

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.


🏢 Fase 2: Configuração do Lojista ou Fornecedor

Abaixo está o fluxo completo que os Lojistas/Fornecedores devem seguir após o complemento ser instalado e ativado pelo administrador da plataforma.


🧩 Etapa 1 — Acessar as Configurações do Aplicativo do Lojista/Fornecedor

  1. Faça login na conta do Lojista/Fornecedor dentro da plataforma Chat-Bot.

  2. Acesse o Painel de Controle.

  3. No menu lateral, clique em Configurações do Aplicativo.

  4. Role até encontrar a seção Integração de Leads do Facebook.


🖼️ Imagem Conceitual (descrição)

"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."


🌐 Etapa 2 — Criar o Aplicativo Meta Developer

Esta etapa é essencial e deve ser executada antes de qualquer tentativa de conexão.

✔️ Requisitos

  • Conta de desenvolvedor Meta ativa

  • Conta comercial do Facebook

  • Ambiente em servidor com SSL válido

  • Endpoint público acessível

🔧 Passos

  1. Acesse o site Meta Developers.

  2. Crie uma conta de desenvolvedor (caso ainda não tenha).

  3. Clique em Criar aplicativo.

  4. Escolha a categoria Empresa.

  5. Insira:

    • Nome do aplicativo

    • E-mail de contato

  6. Clique em Criar Aplicativo.

Após isso:

  • Copie o ID do Aplicativo

  • Copie o Segredo do Aplicativo

Você precisará desses dados na etapa seguinte.


🖼️ Imagem Conceitual (descrição)

"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."


🧩 Etapa 3 — Configuração da Integração dentro da Plataforma Chat-Bot

Agora retorne à plataforma Chat-Bot.

  1. Vá até Configurações do Aplicativo → Integração de Leads do Facebook.

  2. Ative a chave: Ativar Integração de Leads do Facebook.

  3. Preencha:

    • ID do Aplicativo do Facebook

    • Segredo do Aplicativo do Facebook

  4. O sistema irá gerar automaticamente:

    • Token de Verificação do Webhook

    • URL do Webhook

Clique em Salvar Configurações.


🖼️ Imagem Conceitual (descrição)

"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."


🔗 Etapa 4 — Configurar os Webhooks no Aplicativo Meta

🔧 Passos no Meta Developer:

  1. Abra o aplicativo no painel Meta Developer.

  2. Clique em Adicionar Produto → Webhooks.

  3. Dentro de Webhooks → Página, clique em Criar Assinatura.

  4. Preencha:

    • URL de Callback: URL gerada pelo Chat-Bot

    • Token de Verificação: token gerado pelo Chat-Bot

  5. Clique em Verificar e Salvar.

Se apresentar erro, verifique:

  • SSL

  • Token

  • Disponibilidade do servidor

  • Firewall ou restrições de entrada

✔️ Inscrição no Evento “leadgen”

Após validar o webhook:

  1. Localize o evento leadgen

  2. Marque a caixa

  3. Clique em Inscrever-se


🖼️ Imagem Conceitual (descrição)

"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."


🧩 Etapa 5 — Conectar Páginas do Facebook

De volta ao Chat-Bot:

  1. Em Integração de Leads do Facebook, clique em Testar Conexão.

  2. A confirmação deve exibir: Conexão Bem-Sucedida.

  3. Ative: Habilitar Processamento de Leads.

  4. Salve novamente.


🧩 Etapa 6 — Inscrever Páginas para Captura de Leads

  1. Clique em Buscar Páginas do Facebook.

  2. A plataforma listará todas as páginas vinculadas ao aplicativo.

  3. Para cada página desejada, clique em:
    Inscrever-se para Receber Leads

  4. O status deve aparecer como Inscrito.


🕒 Observação importante

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


🧪 Testando a Integração

1. Crie um formulário de teste

  • Objetivo da campanha: Geração de Leads

  • Selecione a página inscrita

  • Crie um formulário com campos básicos

  • Publique a campanha

2. Envie um lead de teste

  • Preencha o formulário com seu próprio contato

3. Valide no Chat-Bot

No painel:

  • Acesse Contatos

  • Filtre por origem: Facebook

  • Valide:

    • Nome

    • Telefone

    • E-mail

    • Campos personalizados


🛠️ Configurações Avançadas

🔧 Mapeamento Personalizado de Campos

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.


⚡ Ações Automáticas

É 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:

  1. Vá até Configurações de Ações

  2. Ative as ações desejadas

  3. Configure parâmetros

  4. Clique em Salvar Configurações


🖼️ Imagem Conceitual (descrição)

"Fluxograma visual mostrando: Facebook Leads → Webhook Meta → Chat-Bot → Contatos → Mensagens Automáticas WhatsApp."


🔚 Finalização

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 ✔️


📄 Paginação

Página Anterior: Instalação
Próxima Página: Integração com o Facebook



** O tempo é base no fuso horário America/New_York