Como criar e configurar o app da Meta que liga os anúncios no FarejaLeads
Atualizado em · feito pelo dono da plataforma (admin)
Os clientes conectam a conta de anúncio pelo login do Facebook de um app da Meta da plataforma. Este guia cria o app, liga o login e as permissões de anúncio, e cola o ID e a chave secreta no admin. O passo a passo técnico do painel fica também em /admin/meta-ads.
O que você ganha
- O botão Conectar com o Facebook em Anúncios
- As ferramentas meta_ads_* do MCP
Antes de começar
- Ser administrador do portfólio empresarial (business.facebook.com) da empresa.
- Para abrir a todos os clientes: verificação da empresa e App Review da Meta (dias a semanas).
Passo a passo
1. Crie o app
Em developers.facebook.com/apps → Criar app, escolha o tipo Empresa (Business) e ligue ao portfólio da empresa. Pode ser o mesmo app do WhatsApp.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
2. Adicione a Marketing API e o login para empresas
No painel do app, em Adicionar produtos (ou Casos de uso), adicione Marketing API e Login do Facebook para Empresas (Facebook Login for Business).
Em Login do Facebook para Empresas → Configurações, ponha em URIs de redirecionamento do OAuth válidos: https://farejaleads.com/api/public/meta-ads/callback.
Em Configurações (Configurations) → Criar configuração, marque ads_management, ads_read, business_management e as permissões de páginas (pages_show_list, pages_read_engagement, pages_manage_ads). Copie o ID da configuração.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
3. Copie o ID e a chave secreta
No app → Configurações do app → Básico: copie o ID do app e, em Chave secreta do app, clique em Mostrar e copie.
4. Cole no FarejaLeads
No FarejaLeads: app → Admin → Compras e integrações → Anúncios na Meta (farejaleads.com/app/admin/integracoes/…). Segredo fica cifrado e não aparece de novo.
META_ADS_APP_ID = ID do app, META_ADS_APP_SECRET = chave secreta, META_ADS_CONFIG_ID = ID da configuração. Depois ligue "Anúncios na Meta ligados" (META_ADS_ATIVO).
Enquanto o app não passa no App Review, deixe META_ADS_PUBLICO desligado: só admins, desenvolvedores e testadores do app conectam.
5. App Review e verificação da empresa (para abrir a todos)
business.facebook.com/settings → Central de segurança → Verificação da empresa: envie os documentos do CNPJ.
No app → Revisão do app → Permissões e recursos: peça Acesso Avançado para ads_management, ads_read, business_management e as de páginas, com vídeo do fluxo de conexão. Aprovado, ligue META_ADS_PUBLICO.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
6. Teste
Em farejaleads.com/app/anuncios, clique em Conectar com o Facebook com uma conta de admin do app. Pelo MCP, meta_ads_pendencias mostra o que ainda falta.
Regras que valem sempre
- A chave secreta do app nunca vai no navegador nem em conversa: só no admin ou na variável de ambiente.
- A Meta desliga versões da Graph API uns 2 anos depois: troque META_GRAPH_VERSAO quando o painel do app avisar.