Como conectar uma conta do Meta Ads

Conecte a conta de anúncios do Meta Business ao cliente e sincronize campanhas.

Atualizado em 8 de maio de 2026

Hoje a conexão é feita informando o Ad Account ID do Meta e autorizando o System User paiol-api no Business Manager. OAuth completo chega em breve.

Pré-requisitos

  • Você precisa ser admin ou analista da conta de anúncios no Meta Business Manager
  • O Business Manager precisa ter o System User paiol-api adicionado (instruções abaixo)

1. Pegar o Ad Account ID

Acesse o Meta Business → Gerenciador de Anúncios. No topo, ao lado do nome da conta, aparece um ID no formato act_1234567890. Copie apenas o número (sem o act_).

Ad Account ID no Gerenciador de Anúncios
O Ad Account ID fica logo ao lado do nome da conta.

2. Autorizar o System User paiol-api

  1. Em business.facebook.com → Configurações do negócio → Usuários do sistema
  2. Procure paiol-api. Se não existir, peça o token de setup no nosso WhatsApp
  3. Clique em Atribuir ativos → Contas de anúncios
  4. Selecione a conta de anúncios desse cliente e marque Gerenciar campanhas (ou, no mínimo, Ver desempenho)
  5. Salve

3. Conectar no Ag.Hub

  1. Entre no cliente → aba Integrações
  2. Ative Meta Ads
  3. Cole o Ad Account ID no campo
  4. Clique em Testar conexão — o Ag.Hub busca o nome da conta pra confirmar
  5. Clique em Salvar e sincronizar
Formulário de conexão do Meta Ads no Ag.Hub
"Testar conexão" valida antes de salvar.

Tempo da primeira sincronização

A primeira puxada pode levar até 10 minutos pra contas com muito histórico. Depois disso, as atualizações são incrementais (a cada 3h).

Forçar sincronização manual

No módulo Meta Ads do cliente → botão Sincronizar agora. Útil depois de subir uma campanha nova e querer ver no Ag.Hub sem esperar a próxima janela.

Erros comuns

Se aparecer "Sem permissão" ou erro #200, veja sincronização do Meta Ads falhou.

Esse artigo foi útil?