Traffic AI · Conexão Meta Ads

Como gerar seu token de acesso

Você vai criar um Usuário do Sistema no Meta Business e gerar um token que não expira. Leva cerca de 5 minutos. Faça tudo logado como administrador do Business Manager dono da conta de anúncios.

Antes de começar: a conta de anúncios e a Página já precisam estar dentro de um Business Manager (não em conta pessoal solta), e o App usado para gerar o token precisa estar vinculado a esse Business.
1

Abra as Configurações do Negócio

Vá em business.facebook.com/settings. No topo, confirme que está no Business Manager certo (o que tem a conta de anúncios a conectar).

2

Crie o Usuário do Sistema

Usuários→Usuários do sistema→Adicionar
  • Nome: token-traffic-ai (ou outro identificável)
  • Função: Administrador
3

Atribua os ativos ao Usuário do Sistema

Com o usuário selecionado → Adicionar ativos → marque Controle total em cada um:

  • Conta de anúncios → a conta do cliente
  • Página → a Página vinculada às campanhas
  • Catálogo e Pixel → se você usa

Sem isso, o token gera mas a API responde "sem permissão na conta".

4

Gere o token

Ainda no Usuário do Sistema → Gerar novo token.

  • App: o App vinculado ao Business
  • Validade: Nunca expira

Permissões: marque exatamente estas cinco:

ads_managementads_readbusiness_managementpages_show_listpages_read_engagement

Clique em gerar e copie o token na hora (ele só aparece uma vez).

5

Cole no Traffic AI

Configurações→Contas de Anúncio→Atualizar token

Cole o token no campo e salve. O sistema valida e cifra a chave automaticamente.

4 armadilhas comuns (token + criação de anúncios)

  1. 1.Advanced Access. Em developers.facebook.com → seu App → Revisão do App → Permissões, o ads_read e o ads_management precisam estar com o selo Advanced Access. Se estiverem em "Standard Access", o token só funciona em contas de teste. É o motivo nº 1 de token que retorna vazio.
  2. 2.Não mexa no Usuário do Sistema depois. Renomear, trocar a função ou remover o App do Business invalida o token na hora (erro subcode 1870227). Se acontecer, é só gerar um novo.
  3. 3.Página obrigatória. Se as campanhas usam uma Página e ela não foi atribuída ao Usuário do Sistema, as chamadas de criativos e insights de página falham, mesmo com a conta de anúncios certa.
  4. 4.App em modo Ativo (Live). Em developers.facebook.com → seu App, o botão no topo precisa estar em "Ativo", não "Em desenvolvimento". Um app em dev mode lê dados, mas a Meta recusa criar anúncios que rodam (erro "app em modo de desenvolvimento"). Publicar exige Política de Privacidade + categoria — não precisa de Revisão do App pra subir anúncio.

Publicar o app (sair de "Em desenvolvimento")

App em modo de desenvolvimento lê os dados, mas a Meta recusa criar anúncios que rodam. Publicar é rápido, feito uma única vez, e não precisa de Revisão do App.

  1. 1.Em developers.facebook.com → seu App → Configurações → Básico, preencha e salve:
    • URL da Política de Privacidade (obrigatório): https://vtgroup.com.br/privacidade
    • URL dos Termos de Serviço: https://vtgroup.com.br/termos
    • Exclusão de dados → "URL de instruções": https://vtgroup.com.br/exclusao-dados
    • Categoria: "Negócios" (e ícone 1024×1024 se pedir).
  2. 2.Publicar: menu lateral "Publicar" → botão "Ativar" / "Go live"; ou, em apps mais antigos, o seletor no topo "Em desenvolvimento" → "Ativo".
  3. 3.Volte no Traffic AI, na fila, e aprove a campanha de novo. O token continua o mesmo — não precisa gerar outro.