O que é o App ID do Meta?

O App ID é um identificador único numérico gerado pelo Meta quando você cria um app no Meta for Developers. Junto com o App Secret, é usado para autenticação nas APIs do Meta. O App ID é público — pode ser exposto no código front-end. O App Secret é privado e nunca deve ser exposto publicamente ou em repositórios de código.

Precisa passar por App Review para usar a API do Meta?

Depende do uso. Em modo de desenvolvimento (Development Mode), qualquer permissão funciona para usuários com papel no app (admins, devs, testers) — sem App Review. O App Review é obrigatório quando o app vai ser usado por pessoas sem papel no app — ou seja, para usuários externos. Para automações internas, uso pessoal ou testes, você não precisa passar pela App Review.

Qual é o limite de apps no Meta Developers?

Você pode ter papel de desenvolvedor ou administrador em no máximo 15 apps que não estejam vinculados a um Business Portfolio verificado. Para criar mais apps além desse limite, conecte os apps existentes a um Business Portfolio verificado, remova apps antigos não utilizados (apps arquivados também contam para o limite), ou remova sua função de administrador/desenvolvedor de apps que você não gerencia mais.

Como usar o app do Meta Developers com o n8n?

Para integrar o Meta Developers com n8n: (1) crie o app com o use case 'Access Leads API'; (2) configure o Webhook no Meta para apontar para o URL do trigger de Webhook do n8n; (3) no n8n, use o trigger 'Facebook Lead Ads' com o App ID e App Secret do seu app; (4) use o token de acesso gerado via Explorador da Graph API como credencial. Para CAPI, use o use case de Marketing API e o token de System User do Business Manager.

Meta Developers · API · Tutorial 2026

Como Criar um App no Meta Developers

O App ID do Meta é a chave que conecta tudo — CAPI, leads de formulários, Graph API, Login com Facebook, Webhooks e muito mais. Neste guia você cria do zero, entende cada etapa e já sai configurado para integrar com n8n, Make.com e outras ferramentas.

Atualizado: Abril 2026 · Leitura: ~16 min · Baseado na documentação oficial Meta for Developers

🎯 Resposta direta

Para criar um app no Meta Developers: (1) registre-se em developers.facebook.com; (2) acesse developers.facebook.com/apps/creation/; (3) informe o nome do app e e-mail; (4) selecione os use cases (casos de uso) que definem as permissões; (5) conecte ou não um Business Portfolio; (6) clique em "Go to dashboard". O App ID e o App Secret são gerados imediatamente. O processo completo leva menos de 10 minutos.

📋 Neste artigo

O que é o Meta for Developers e para que serve
Pré-requisitos antes de criar o app
Passo 1 — Criar a conta de desenvolvedor
Passo 2 — Criar o app no painel
Passo 3 — Selecionar os use cases
Passo 4 — Vincular Business Portfolio
Passo 5 — Configurações básicas do app
Passo 6 — Gerar tokens de acesso
Tipos de token: qual usar em cada situação
App Review: quando é necessária
Casos de uso práticos por ferramenta
Erros comuns e como resolver
FAQ — perguntas frequentes

O que é o Meta for Developers e para que serve o app

O Meta for Developers (anteriormente Facebook for Developers) é a plataforma oficial da Meta para criar e gerenciar aplicativos que se integram ao ecossistema Facebook, Instagram, WhatsApp e Messenger via Graph API e outras APIs.

Criar um app não significa construir um aplicativo mobile. Significa registrar uma identidade de integração — um App ID que autoriza sua ferramenta (n8n, Make.com, um script Python, um site) a se comunicar com os sistemas da Meta de forma oficial e rastreável.

Você precisa de um app no Meta Developers para:

→ Conversions API (CAPI) — rastreamento server-side de eventos de conversão sem depender de cookies
→ Facebook Lead Ads via Webhook — receber leads de formulários instantâneos em tempo real no n8n ou Make.com
→ Graph API — acessar dados de Páginas, publicar posts, ler métricas de anúncios via Marketing API
→ Login com Facebook — autenticação de usuários em sites e apps via OAuth do Facebook
→ Instagram Graph API — publicar no Instagram, ler comentários e mensagens de contas Business
→ WhatsApp Business API — enviar e receber mensagens via API oficial do WhatsApp

Pré-requisitos antes de criar o app

✓ Conta no Facebook ativa — o Meta Developers é vinculado à sua conta pessoal do Facebook. Use a conta real, não uma conta fake
✓ Número de celular verificado — necessário para confirmar a conta de desenvolvedor
✓ E-mail de contato válido — será o e-mail de suporte do app, visível para usuários que interagirem
✓ Business Manager configurado (recomendado) — para apps que acessam dados de negócios, o vínculo com o BM é obrigatório ou fortemente recomendado
! Limite de apps: você pode ser admin/desenvolvedor em no máximo 15 apps não vinculados a Business Portfolio verificado. Apps sem BM verificado contam para esse limite — inclusive apps arquivados

Criar a conta de desenvolvedor

Antes de criar um app, você precisa se registrar como desenvolvedor no Meta for Developers. O processo é simples e rápido:

developers.facebook.com→ Começar→ Aceitar Termos→ Informar profissão→ Concluir inscrição

1 Acesse developers.facebook.com e clique em "Começar" (ou "Get Started")
2 Leia e aceite os Termos da Plataforma Meta e as Políticas do Desenvolvedor — clique em "Continuar"
3 Confirme seu e-mail se solicitado (um link é enviado para verificação)
4 Selecione sua profissão principal. Caso não esteja listada, escolha "Outro"
5 Clique em "Concluir inscrição". Pronto — sua conta de desenvolvedor está ativa

💡 Se você já tem o Meta Business Manager configurado, sua conta de desenvolvedor estará automaticamente vinculada a ele. Isso facilita o próximo passo de conectar o Business Portfolio ao app.

Criar o app no painel

developers.facebook.com/apps/creation/

Acesse o link acima diretamente ou navegue por Meus Apps → Criar App.

1 Nome do app: escolha um nome descritivo e identificável. Você pode alterar depois, mas o App ID gerado é permanente
2 E-mail de contato do app: e-mail que aparece para usuários que interagem com o app. Pode ser diferente do e-mail da sua conta
3 Clique em "Avançar"

⚠️ O nome do app não pode conter "Facebook", "Meta", "Instagram" ou termos que possam causar confusão com a própria Meta — esses nomes são rejeitados automaticamente. Use o nome da sua empresa, projeto ou produto.

Selecionar os Use Cases

Esta é a etapa mais importante — e a que mais confunde iniciantes. Use cases (casos de uso) definem o que seu app vai fazer. Cada use case adiciona automaticamente as permissões (permissões da API) e produtos necessários para aquela funcionalidade.

⚠️ Atenção crítica: use cases não podem ser removidos depois de criado o app. Use cases incompatíveis são exibidos em cinza e não podem ser selecionados juntos. Se errar, você terá que criar um novo app do zero.

Use Cases mais usados em automações e marketing

Leads & Automação

Access Leads API

Acessa os leads de formulários instantâneos (Lead Ads) via API ou Webhook em tempo real. Essencial para integrar n8n, Make.com e CRMs com campanhas de geração de leads.

+ leads_retrieval, + pages_show_list, + public_profile

Tracking & CAPI

Conversions API (CAPI)

Envia eventos de conversão server-side para o Meta (compras, leads, visualizações) sem depender de cookies ou Pixel no navegador. Mais confiável que o Pixel sozinho.

+ business_management, + ads_management

Facebook Login for Business

Autentica usuários ou sistemas via OAuth da Meta. Permite que usuários conectem suas contas Meta ao seu sistema com permissões específicas.

+ pages_show_list, + public_profile, + email

Páginas

Manage Everything on Your Page

Publicar posts, responder comentários e mensagens, ler métricas de uma Página do Facebook. Use para automações de publicação e gestão de presença.

+ pages_manage_posts, + pages_read_engagement

Instagram

Manage Instagram Content

Publica no Instagram Business, lê comentários, acessa mensagens diretas e métricas da conta. Requer conta Business ou Creator vinculada a uma Página.

+ instagram_basic, + instagram_content_publish

Anúncios

Marketing API Access

Cria e gerencia campanhas, conjuntos de anúncios e anúncios programaticamente. Acessa relatórios de performance via Ads Insights API.

+ ads_management, + ads_read, + business_management

📌 Se não encontrar o caso de uso que precisa na lista, selecione "Other" (Outro) e siga o guia de Other App Types da documentação oficial. Isso cria um app sem use case pré-definido, com permissões que você adiciona manualmente.

Vincular Business Portfolio

Nesta etapa, você decide se vai conectar o app a um Business Manager (Business Portfolio no novo nomenclatura). As opções são:

→ Business Portfolio verificado — app vinculado a empresa verificada. Permite acessar dados de terceiros e remove o limite de 15 apps
→ Business Portfolio não verificado — vinculado ao BM mas sem verificação completa
→ "I don't want to connect a business portfolio yet" — pula a etapa. O app fica sem BM vinculado por enquanto (funciona para testes internos)
→ "Create a business portfolio" — cria um novo BM diretamente na tela

💡 Para automações internas (n8n, Make.com com sua própria conta), você pode pular o Business Portfolio por enquanto. Para apps que vão acessar dados de clientes ou terceiros, vincular o BM é obrigatório para as permissões avançadas.

Revisar, criar e configurações básicas

A tela de Overview mostra um resumo do que você configurou. Revise e clique em "Go to dashboard". Você será redirecionado para o painel do app onde o App ID e o App Secret já estão disponíveis.

Painel do App→ Configurações→ Básicas

Preencha os campos obrigatórios nas Configurações Básicas para que o app não seja suspenso por falta de informações:

✓ URL de Política de Privacidade — obrigatório. Use a página de privacidade do seu site. Sem ela, o app fica em modo restrito
✓ URL dos Termos de Serviço — recomendado. Alguns use cases exigem
✓ Descrição do app — explique o que o app faz. Usado na App Review
✓ Ícone do app — 1024×1024px. Necessário para publicar o app
✓ Categoria — selecione a categoria mais próxima do seu caso de uso
! NUNCA exponha o App Secret publicamente — em código front-end, repositórios públicos ou mensagens. Trate como senha

Anote o App ID e o App Secret

Onde encontrar suas credenciais

# No painel do app: Configurações → Básicas

App ID:        1234567890123456   (público — pode aparecer no front-end)
App Secret:    ••••••••••••••••   (PRIVADO — nunca expor)

# Para ver o App Secret: clique em "Mostrar" e confirme com senha do Facebook

Gerar o primeiro token de acesso

Com o app criado, o próximo passo é gerar um token de acesso para fazer chamadas à API. O Explorador da Graph API é a ferramenta oficial para gerar e testar tokens.

Meta for Developers→ Ferramentas→ Explorador da Graph API

Ou acesse diretamente: developers.facebook.com/tools/explorer/

1 No campo "Meta App", selecione o app que você acabou de criar
2 Clique em "Gerar Token de Acesso" — você será redirecionado para autorizar as permissões
3 Selecione as permissões que deseja (as mesmas do use case escolhido) e autorize
4 O token de acesso do usuário aparece no campo. Copie e guarde em local seguro
5 Para tokens de Página, role abaixo e selecione a Página no campo correspondente

⚠️ O token gerado no Explorador é de curta duração (~1 hora). Para uso em produção, converta-o para um token de longa duração (60 dias) ou gere um token de System User permanente pelo Business Manager.

Converter para token de longa duração

GET — Converter token curto em token de 60 dias

GET https://graph.facebook.com/v21.0/oauth/access_token?
  grant_type=fb_exchange_token&
  client_id=SEU_APP_ID&
  client_secret=SEU_APP_SECRET&
  fb_exchange_token=TOKEN_CURTO_AQUI

A resposta retorna o access_token de longa duração (60 dias) e o expires_in com o prazo de expiração em segundos.

Tipos de token: qual usar em cada situação

👤

Token de Usuário (User Access Token)

Representa um usuário específico. Gerado via OAuth ou Explorador. Acessa dados do usuário autenticado e suas Páginas.

⏱ Vida útil: 1h (curto) ou 60 dias (longo)

📄

Token de Página (Page Access Token)

Representa uma Página específica do Facebook. Usado para publicar posts, ler comentários e gerenciar a Página via API.

⏱ Não expira (se gerado a partir de token longo)

🤖

Token de System User

Representa um "robô" do Business Manager, não um humano. Não expira. Ideal para automações — não depende de um usuário específico.

⏱ Não expira — ideal para produção

🏢

Token de App (App Access Token)

Representa o próprio app, não um usuário. Usado para chamadas que não precisam de contexto de usuário — como validação de webhooks.

⏱ Válido até que o App Secret mude

🎯 Para automações com n8n e Make.com em produção, use sempre o Token de System User gerado pelo Business Manager. Acesse: business.facebook.com → Configurações → Usuários do Sistema → Gerar novo token. É o único token que não expira e não depende de um usuário específico logar.

App Review: quando é necessária e quando não é

Situação	App Review necessária?	Modo
Uso pessoal / automação interna	Não — apenas usuários com papel no app	Development Mode
Sua empresa e seus próprios dados	Não — se todos os usuários têm papel no app	Development Mode
Clientes usando o app (login)	Sim — usuários sem papel no app	Live Mode (após review)
Permissões avançadas (ads_management, etc.)	Sim — para acesso de usuários externos	Live Mode (após review)
CAPI (Conversions API)	Não — usa System User com suas próprias contas	Development Mode
Leads Ads Webhook (sua própria conta)	Não — integração interna	Development Mode

📖 Em Development Mode, o app funciona completamente para até 25 usuários com papel atribuído (admin, desenvolvedor, testador). Para a maioria das automações internas e integrações de marketing digital, você nunca precisará passar pelo App Review.

Casos de uso práticos por ferramenta

⚙️ n8n — Automação de Leads

Crie o app com o use case Access Leads API. Configure o Webhook no app apontando para o URL do trigger do n8n. Use o App ID e App Secret no nó de credencial do n8n "Facebook Lead Ads".

Use case: Access Leads API • Token: Usuário (Página)

🔄 Make.com — Lead Ads Trigger

No módulo "Facebook Lead Ads — Watch New Leads" do Make.com, conecte com as credenciais do app. Mapeie o webhook para a URL gerada pelo Make.com no painel do desenvolvedor.

Use case: Access Leads API • Token: Usuário (Página)

📡 CAPI — Conversions API

Crie o app com Marketing API Access. Gere um Token de System User no Business Manager com permissão de ads_management. Use esse token nos eventos de CAPI enviados server-side.

Use case: Marketing API • Token: System User

📊 Dashboard de Anúncios

Use Marketing API Access para acessar o endpoint /insights da Graph API e puxar métricas de campanhas para planilhas Google, Power BI ou Looker Studio.

Use case: Marketing API • Token: System User

🌐 Login com Facebook

Selecione Facebook Login for Business. Configure o domínio da aplicação e as URIs de redirecionamento OAuth válidas. O usuário autentica e você recebe um token com as permissões aprovadas.

Use case: Facebook Login for Business • Token: Usuário

📷 Instagram Automação

Use Manage Instagram Content. A conta Instagram precisa ser Business ou Creator vinculada a uma Página. Use Token de Página (não expira) para publicações automáticas via n8n ou Make.com.

Use case: Manage Instagram Content • Token: Página

Erros comuns e como resolver

✗ "Reached the app limit" — você atingiu o limite de 15 apps sem BM verificado. Conecte apps existentes a um Business Portfolio verificado ou remova apps não utilizados
✗ Token expirando a cada hora — você está usando um token de curta duração. Converta para longa duração (60 dias) ou gere um System User Token permanente pelo Business Manager
✗ Webhook não recebe eventos — verifique se a URL do Webhook está correta no painel do app, se o "Verify Token" bate com o configurado na ferramenta e se o app está em modo ativo (não arquivado)
✗ Permissão negada na API (code 200 ou 190) — o token usado não tem a permissão necessária. Verifique as permissões do token no Explorador da Graph API e regere com as permissões corretas
✗ App em modo de desenvolvimento não acessa dados de usuários externos — esperado. Em Development Mode, apenas usuários com papel no app conseguem usar. Para produção, passe pelo App Review ou adicione o usuário como testador
✗ App Secret exposto acidentalmente — regenere o App Secret imediatamente em Configurações → Básicas → App Secret → Resetar. Todos os tokens existentes serão invalidados
✓ Como adicionar testadores ao app: vá em Configurações → Funções → Testadores e adicione pelo nome de usuário do Facebook. Os testadores podem usar o app em modo de desenvolvimento

Perguntas frequentes (FAQ)

Como criar um app no Meta for Developers?

Acesse developers.facebook.com/apps/creation/, informe nome do app e e-mail de contato, selecione os use cases que definem o que o app vai fazer, conecte (ou não) um Business Portfolio e clique em "Go to dashboard". O App ID e o App Secret são gerados imediatamente. O processo completo leva menos de 10 minutos.

Para que serve um app no Meta Developers?

Um app no Meta Developers é uma identidade de integração que autoriza sistemas externos (n8n, Make.com, scripts) a acessar as APIs da Meta: leads de formulários via Webhook, CAPI, Graph API, Marketing API, Login com Facebook, Instagram Graph API e WhatsApp Business API.

Preciso passar pelo App Review?

Não para uso interno. O App Review é obrigatório apenas quando o app vai ser usado por pessoas sem papel atribuído no app (usuários externos). Para automações internas, leads da sua própria conta, CAPI e Marketing API com sua própria conta de anúncios, o Development Mode é suficiente.

O que é o App ID e o App Secret?

O App ID é o identificador único público do app — pode aparecer no código front-end sem risco. O App Secret é privado — é a "senha" do app, usada para gerar tokens de acesso. Nunca exponha o App Secret em repositórios públicos, código front-end ou mensagens. Se exposto, regenere imediatamente em Configurações → Básicas.

Qual token usar para automações em produção?

Use o Token de System User, gerado pelo Business Manager (business.facebook.com → Configurações → Usuários do Sistema). É o único tipo de token que não expira e representa um "usuário robô" — não depende de nenhum funcionário específico estar logado. Ideal para n8n, Make.com e qualquer automação de longa duração.

Quantos apps posso criar no Meta Developers?

Você pode ter papel de admin ou desenvolvedor em no máximo 15 apps não vinculados a Business Portfolio verificado. Para criar mais além desse limite: conecte apps existentes a um Business Portfolio verificado (remove do limite), remova apps antigos não utilizados (apps arquivados também contam), ou remova seu papel de admin em apps que você não gerencia mais.

App ID gerado — agora a integração começa

Criar o app no Meta Developers é o primeiro passo de qualquer integração séria com o ecossistema Facebook e Instagram. Com o App ID em mãos, você destrava automações de leads, CAPI, publicações, dashboards e muito mais.

A dica mais importante: use sempre o Token de System User para automações em produção — é o único que não expira e não depende de um usuário específico. E nunca exponha o App Secret em lugar nenhum público.

Gostou do guia? Compartilhe com quem está começando com automações no Meta! 🔧