Integração com o Facebook

⚙️ CONFIGURAÇÃO COMPLETA DO FACEBOOK PARA INTEGRAÇÃO DE LEADS — GUIA OFICIAL CHAT-BOT

Guia Premium de Configuração empresarial para Lojistas e Fornecedores que utilizam a plataforma Chat-Bot integrada à API Oficial da Meta Business.

Este documento foi otimizado para servir como Página Central de Conhecimento, permitindo consulta contínua sem necessidade de suporte adicional. Inclui instruções detalhadas, padrões técnicos, requisitos, imagens conceituais (descritas) e fluxo operacional completo.

🧭 VISÃO GERAL DO PROCESSO

A integração entre Facebook Lead Ads → Chat-Bot permite capturar leads em tempo real e alimentá-los automaticamente no sistema, garantindo:

• Conversão imediata via WhatsApp

• Automação avançada

• Registro completo de dados

• Rastreamento de origem

• Escalabilidade profissional

O processo é dividido em:

1. Configuração da conta comercial no Facebook

2. Criação e preparação do App Meta Developer

3. Configuração interna no Chat-Bot

4. Configuração de Webhooks no Facebook

5. Conexão de Páginas, permissões e leads

6. Criação e execução de campanhas de Lead Ads

7. Testes, validação e segurança

🏢 1. Configuração de Negócios no Facebook

✔ Pré-requisitos essenciais

Antes de iniciar a integração, certifique-se de possuir:

• Conta comercial do Facebook com acesso de administrador

• Página do Facebook com permissões administrativas

• Conta de anúncios habilitada para Lead Ads

• Campanhas ativas ou planejadas para geração de leads

• Conta de desenvolvedor do Facebook

• Empresa validada (quando exigido pelo país)

✔ Criação da conta de desenvolvedor

Necessário para criar o app de integração.

Passos:

1. Acessar a área de desenvolvedores

2. Criar conta de desenvolvedor

3. Concluir verificações de telefone e e-mail

4. Aceitar os Termos do Desenvolvedor Meta

📱 2. Criação do Aplicativo Facebook (Meta Developer)

Passo 1 – Criar o aplicativo

Imagem conceitual: (Tela mostrando botão “Criar Aplicativo”, com opções de casos de uso e tipo do app.)

Acesse “Meus Apps” e clique em Criar Aplicativo.

Passo 2 – Escolher caso de uso

Selecione:

➡ Outro

Passo 3 – Selecionar tipo de App

Selecione:

➡ Negócios

Recursos liberados:

• Páginas

• Anúncios

• Leads

• Instagram

• WhatsApp

• Messenger

• Eventos, grupos e ferramentas de automação

Passo 4 – Informações do App

Preencher:

• Nome do App

• E-mail de contato

• Associação ao portfólio de negócios

• Aceitar Termos e Políticas

Após criar, você será direcionado ao painel do App.

🔧 3. Configurações Internas do App Meta Developer

Após a criação, configure:

✔ Informações básicas (obrigatórias)

• Ícone profissional 1024x1024

• Descrição completa

• Categoria comercial

• Informações de contato

• Política de Privacidade

• Termos de Serviço

• Instruções para exclusão de dados

• Verificação comercial (se exigido no país)

Imagem conceitual: (Tela com ícone do app, descrição, URLs legais e informações comerciais.)

Observação Importante

As políticas precisam atender legislações como:

✔ GDPR
✔ LGPD
✔ CCPA

🔑 4. Credenciais Essenciais

Acesse:

➡ Configurações > Básico

Anote:

• ID do aplicativo

• Segredo do aplicativo

⚠ Segredo do App deve ser mantido em sigilo absoluto.

Imagem conceitual: (Painel mostrando ID e campo de segredo oculto.)

🛡️ 5. Permissões Necessárias para Lead Ads

O Chat-Bot exige as seguintes permissões:

• ads_management

• pages_manage_ads

• pages_manage_metadata

• pages_read_engagement

• leads_retrieval (CRÍTICA)

Todas devem ser solicitadas à Meta pelo processo de revisão.

⚠ A equipe Chat-Bot não tem autorização para intervir no processo de aprovação.

🔗 6. Configuração do Webhook (Meta → Chat-Bot)

Passo 1 — Adicionar produto Webhook

No painel do app, clique:

➡ Adicionar Produto → Webhooks

Passo 2 — Configurar assinatura de Página

Configure:

• URL de callback → fornecida pelo Chat-Bot

• Token de verificação → gerado pelo Chat-Bot

Clique:

➡ Verificar e Salvar

Passo 3 — Inscrever-se no evento “leadgen”

Habilite:

✔ leadgen

Imagem conceitual: (Lista de eventos: messages, feed, leadgen marcado.)

⚙️ 7. Configuração no Chat-Bot (Lojista / Fornecedor)

Passo 1 – Acessar Configurações

Dentro do painel do Chat-Bot:

➡ Configurações do Aplicativo
➡ Integração de Leads do Facebook

Ative:

✔ Ativar integração de leads do Facebook

Passo 2 – Inserir credenciais

Colar:

• ID do App

• Segredo do App

O sistema gera automaticamente:

• Token de verificação

• URL do Webhook

Passo 3 – Testar conexão

Botão:

➡ Testar Conexão

Deve retornar:

✔ Conexão bem-sucedida

📄 8. Conectar Páginas do Facebook

No painel Chat-Bot:

1. Clique em Buscar Páginas do Facebook

2. O sistema listará todas as páginas conectadas ao app

3. Para cada página desejada, clique:

➡ Inscrever-se para receber leads

O status muda para:

✔ Inscrito

Imagem conceitual: (Tabela com várias páginas, status “Inscrito”.)

📋 9. Configuração de Formulários de Lead Ads

Estrutura recomendada:

• Nome do formulário

• Tela de boas-vindas

• Campos essenciais (nome, telefone, e-mail)

• Campo de qualificação (opcional)

• Política de privacidade

• Tela de agradecimento

Melhores práticas:

• 3 a 5 perguntas

• Linguagem simples

• Evitar excesso de dados

• Testar antes da publicação

📊 10. Sincronização em Tempo Real (Facebook → Chat-Bot)

Fluxo:

1. Usuário envia formulário

2. Facebook dispara Webhook

3. Chat-Bot valida assinatura

4. Lead é salvo

5. Automação é ativada

6. Contato fica disponível imediatamente

Imagem conceitual: (Fluxo linear com: Anúncio → Formulário → Webhook → Chat-Bot → WhatsApp.)

🔐 11. Segurança Avançada

• HTTPS obrigatório

• Token secreto protegido

• Validação da assinatura do Facebook

• Logs de requisições

• IPs permitidos (opcional)

🧪 12. Testes e Validação

Testes recomendados:

• Criar lead de teste

• Conferir recebimento no webhook

• Validar criação de contato

• Verificar automações

• Confirmar origem “Facebook”

Problemas comuns:

• Credenciais incorretas

• Permissões insuficientes

• Domínio sem SSL

• Webhook não verificado

🔧 13. Configuração Avançada

Multi-Conta de Anúncios

Permite:

• Várias contas no mesmo negócio

• Leads provenientes de múltiplas origens

• Escalabilidade internacional

Mapeamento de campos

No Chat-Bot:

➡ Configurações → Mapeamento de Campos

Mapeie:

• Nome

• Telefone

• E-mail

• Campos personalizados