📋
Passo a passo
Passo 1
Abrir o Explorador da Graph API
O Graph API Explorer é a ferramenta oficial da Meta para gerar tokens de acesso. Acesse pelo link abaixo.
ℹ
Você precisa estar logada com a conta de Facebook que tem acesso ao Business Manager e à conta de anúncios. Se pedir login, use a mesma conta da aula anterior.
Passo 2
Selecionar o App que você criou no Passo 1
No campo "App da Meta" (no canto superior direito do Explorer), clique no dropdown e selecione o app que você criou na aula anterior.
┌─ Graph API Explorer ─────────────────────────────┐
│ │
│ App da Meta: [Seu App Business] ▼ │
│ Usuário ou Página: [Token do usuário] ▼ │
│ │
│ ┌─ Permissions ────────────────────────────────┐ │
│ │ ads_management ✓ │ │
│ │ ads_read ✓ │ │
│ └──────────────────────────────────────────────┘ │
│ │
│ [Gerar token de acesso] │
└────────────────────────────────────────────────────┘
⚠️
Se o app não aparecer na lista, verifique se você criou ele pelo Business Manager (aula 0.1) e se ele está em modo Live.
Passo 3
Selecionar "Token do usuário"
No campo "Usuário ou Página", selecione "Token do usuário". Esse tipo de token autentica como você — a dona da conta — e tem acesso às suas campanhas.
ℹ
Token do usuário vs Token de página: o token do usuário é o que você precisa para gerenciar campanhas no Gerenciador de Anúncios. Token de página é para gerenciar a Página do Facebook — diferente.
Passo 4
Clicar em "Permissions" e abrir o dropdown
Na aba "Permissions", clique no dropdown que diz "opções selecionadas" ou "selected options". Vai aparecer a lista de todas as permissões disponíveis.
Passo 5
Marcar TODAS as permissões disponíveis
Marque todas as permissões disponíveis. Existe uma opção de "selecionar tudo" — use ela para facilitar. As permissões mais importantes para gerenciar campanhas são:
ads_management — criar/editar/pausar campanhas
ads_read — ler dados e métricas
business_management — gerenciar o Business Manager
read_insights — acessar dados de performance
pages_manage_ads — gerenciar anúncios da Página
pages_read_engagement — ler dados da Página
ℹ
Selecione tudo para garantir que o Claude Code (e os agentes do Olimpo) tenham acesso a tudo que precisam. Você pode revogar permissões individuais depois se quiser.
Passo 6
Gerar o token de acesso
Após marcar as permissões, clique no botão "Gerar token de acesso" (ou "Generate Access Token").
⚠️
Uma janela do Facebook vai abrir pedindo confirmação das permissões. Clique em "Continuar" ou "OK" para cada permissão solicitada. Não feche a janela antes de concluir.
Passo 7
Copiar o token gerado
Após confirmar, o token vai aparecer no campo de texto do Explorer. É um texto longo — começa com EAABs... ou similar. Copie todo o token.
Seu token de acesso:
EAABsZCuGQCpsBANXMwCt4ZCvJ7uX9pHzJ8dKvL2mPqR5sT6wY3xZ...
[texto muito longo — copie tudo]
⚠️
Nunca compartilhe seu token! Quem tiver esse token pode gerenciar suas campanhas. Trate como uma senha. Não cole no WhatsApp, email ou em qualquer lugar público.
Passo 8
Salvar o token em ~/.senhas/meta-token.md
Abra o terminal e salve o token no arquivo seguro. Esse é o local padrão que todos os agentes do Olimpo vão buscar o token.
$ nano ~/.senhas/meta-token.md
# Token Meta Ads
TOKEN=SEU_TOKEN_AQUI
APP_ID=SEU_APP_ID
APP_SECRET=SEU_APP_SECRET
ℹ
O App ID e o App Secret estão em Configurações > Básico dentro do seu app no developers.facebook.com. Você vai precisar deles na próxima etapa (token de longa duração).
Passo 9
Entender a validade do token e como renovar
O token gerado pelo Graph API Explorer tem validade de 1 hora (token de curta duração). Para usar com o Claude Code no dia a dia, você precisa de um token de longa duração.
⏱
Token Curto (1h)
Gerado pelo Graph API Explorer. Excelente para testar, mas expira em 1 hora. Não serve para uso diário.
📅
Token Longo (60 dias)
Gerado via chamada de API usando o App Secret. Dura 60 dias — é o que o Claude Code usa no dia a dia.
curl -X GET "https://graph.facebook.com/oauth/access_token?
grant_type=fb_exchange_token&
client_id=SEU_APP_ID&
client_secret=SEU_APP_SECRET&
fb_exchange_token=SEU_TOKEN_CURTO"
✅
Com o token de 60 dias salvo em ~/.senhas/meta-token.md, o Zeus e todos os agentes do Olimpo já conseguem gerenciar suas campanhas automaticamente. Repita o processo a cada 60 dias para renovar.