Meta Ads API

Ainda não tem conta no Meta for Developers?

1. Acesse developers.facebook.com e clique Começar
2. Faça login com sua conta do Facebook
3. Aceite os termos, confirme e-mail/telefone e preencha as informações solicitadas

Criar o App

1. developers.facebook.com → Meus Apps → Criar aplicativo
2. Detalhes do app — escolha um nome (ex: Meu App Ads Manager), e-mail de contato e clique Avançar
3. Casos de uso — selecione "Criar e gerenciar anúncios com a API de Marketing" e clique Avançar
4. Requisitos — revise os requisitos listados e clique Avançar
5. Visão geral — confira os dados e clique Ir para o painel

Adicionar os 2 casos de uso restantes

No Painel do app, clique em "Adicionar casos de uso" e filtre por Gerenciamento de conteúdo:

1. Selecione "Gerenciar mensagens e conteúdo no Instagram"
2. Selecione "Gerenciar tudo na sua Página"
3. Clique Salvar

Ativar permissões de cada caso de uso

Para cada caso de uso, vá em Casos de uso → Personalizar:

A) Criar e gerenciar anúncios com API de Marketing

1. Clique "Personalizar"
2. Vá em Ferramentas (menu lateral)
3. Em "Selecionar permissões do token", marque: ads_read, ads_management, business_management, pages_read_engagement, pages_show_list
4. Clique "Obter token" e aceite as autorizações — não precisa copiar, este token serve apenas para ativar as permissões

B) Gerenciar mensagens e conteúdo no Instagram

1. Volte em Casos de uso (menu lateral) e clique "Personalizar" em "Gerenciar mensagens e conteúdo no Instagram"
2. No dropdown, selecione "API do Instagram"
3. Vá em "Configuração da API com Login" (menu lateral)
4. Na seção "1. Adicionar permissões obrigatórias de mensagens", clique no botão "Add all required permissions"
5. Na seção "2. Gerar tokens de acesso", clique "Adicionar conta" e conecte sua conta do Instagram Business
6. Vá em Permissões e recursos (menu lateral) e clique "+ Adicionar" em instagram_business_manage_insights

C) Gerenciar tudo na sua Página

1. Volte em Casos de uso (menu lateral) e clique "Personalizar" em "Gerenciar tudo na sua Página"
2. Confirme que pages_read_engagement está ativa — as demais permissões de Página não são necessárias para o Bootcamp

1. No menu superior, vá em Ferramentas → Explorador da Graph API
2. No dropdown, selecione seu App
3. Clique em Add a Permission e marque as permissões abaixo
4. Após selecionar todas, clique Generate Access Token
5. Aceite todas as autorizações e copie o token gerado

Permissões Essenciais (sempre ativar)

Importantes (recomendado)

1. No menu superior, vá em Ferramentas → Depurador de Token de Acesso
2. Cole o token gerado no passo 2 e clique Depurar
3. Confira que as permissões estão corretas na lista exibida
4. Clique em Estender Token de Acesso (botão no final da página)
5. Copie o novo token — este vale por ~60 dias

META_ACCESS_TOKEN=EAAxxxxxxxx
META_AD_ACCOUNT_ID=act_xxxxxxxxx
META_APP_ID=xxxxxxxxx
META_APP_SECRET=xxxxxxxxx

Testar conexão

python -c "
import requests
token = 'SEU_TOKEN'
r = requests.get(f'https://graph.facebook.com/v21.0/me?access_token={token}')
print(r.json().get('name', 'ERRO: ' + str(r.json())))"

Esperado: seu nome ou o nome do System User.

Development vs Live

Pré-requisitos para modo Live

Como ativar

1. Vá em Configurações do app → Básico e preencha: Nome de exibição, Ícone do aplicativo e URL da Política de Privacidade
2. No menu lateral, clique em Publicar
3. Clique no botão para ativar o modo Live