Conectar o Meta Ads aos Anúncios com um token

O app Anúncios conecta o Meta Ads por um token de acesso: uma chave que você gera dentro da sua conta da Meta e cola no Hub. Com ela, o Hub lê suas campanhas e seus números e passa a sincronizar tudo sozinho. Feito do jeito deste guia, o token não expira, então a configuração acontece uma vez só. Na primeira vez, separe de 30 a 45 minutos.

Antes de começar

• Você precisa ser administrador do portfólio empresarial da empresa na Meta (o antigo Business Manager, em business.facebook.com). Se a conta de anúncio está só no seu perfil pessoal do Facebook, ela precisa ser adicionada ao portfólio empresarial antes.
• No Hub, você precisa da permissão de gerenciar conexões do app Anúncios. Sem ela, a tela Conexões mostra “Sem permissão”: peça ao administrador.
• Tenha em mãos a lista das contas de anúncio que vão entrar no Hub.

Você vai criar quatro coisas na Meta, nesta ordem: um app, as permissões da API de Marketing nesse app, um usuário do sistema (um usuário técnico, que não depende de nenhuma pessoa) e o token gerado por esse usuário. Depois, cola o token no Hub.

Os nomes das telas da Meta mudam com frequência

Os caminhos abaixo são os da Meta em outubro de 2026. Se um menu estiver com outro nome, procure pela mesma função: o que importa é a ordem dos passos e as permissões marcadas.

1. Crie o app na Meta

1. Abra developers.facebook.com/apps e clique em Criar app.
2. Dê um nome que identifique o uso, por exemplo Nome da empresa Hub Marvee, e informe o seu e-mail.
3. No tipo, escolha Empresa (Business).
4. No portfólio empresarial, selecione o da empresa. Se a lista aparecer vazia, você não é administrador desse portfólio: peça o acesso antes de seguir.
5. Clique em Criar app. A Meta abre o painel do app.

2. Libere as permissões da API de Marketing

Este é o passo que mais trava quem faz pela primeira vez. Sem ele, as permissões ads_read e ads_management não aparecem na hora de gerar o token.

1. No menu à esquerda do app, abra Casos de uso e clique em Adicionar caso de uso.
2. No filtro, escolha Anúncios e monetização.
3. Marque os dois casos abaixo e deixe os outros desmarcados:
   • Criar e gerenciar anúncios com a API de Marketing
   • Mensurar dados de desempenho do anúncio com a API de Marketing
4. Clique em Salvar.

3. Crie o usuário do sistema e dê acesso às contas

1. Abra business.facebook.com/settings e, se tiver mais de um portfólio, escolha o da empresa.
2. No menu à esquerda, vá em Usuários e depois em Usuários do sistema. Clique em Adicionar.
3. Dê um nome, por exemplo Hub_Marvee, e escolha a função Administrador. Se a Meta avisar que o limite de administradores foi atingido, use Funcionário: funciona igual para o Hub.
4. Com o usuário do sistema selecionado, clique em Adicionar ativos. Na janela, configure uma categoria por vez e só clique em Atribuir ativos no final:
   • Contas de anúncios: selecione todas as contas que vão entrar no Hub e ligue Gerenciar campanhas.
   • Apps: selecione o app do passo 1 e ligue Gerenciar app.
   • Páginas: selecione a página da empresa e ligue Anúncios e Insights.
5. Clique em Atribuir ativos.

Só as contas de anúncio atribuídas aqui chegam ao Hub. Se depois faltar uma conta, é neste passo que você a acrescenta.

4. Gere o token que não expira

1. Ainda na tela do usuário do sistema, clique em Gerar token.
2. Em App, escolha o app do passo 1.
3. Em Validade, escolha Nunca. Com outra validade, o token vence e a conexão para de sincronizar até você trocar o token.
4. Nas permissões, marque:
   • ads_read e ads_management (obrigatórias)
   • business_management e read_insights
5. Clique em Gerar token e copie o valor na hora. É uma sequência longa que começa com EAA. A Meta mostra o token uma vez só: se fechar a janela sem copiar, gere outro.

Guarde o token como guardaria uma senha. Quem tem o token consegue mexer nas campanhas das contas atribuídas.

5. Cole o token no Hub

1. No Hub, abra o app Anúncios e, na barra lateral, vá em Conexões.
2. No card do Meta Ads, clique em Conectar com token.
3. Cole o valor no campo Token de acesso (o campo mostra só pontos, como uma senha) e clique em Validar e conectar. O Hub confere o token com a Meta antes de salvar.
4. Na janela Conectar contas de anúncio, que abre em seguida, marque as contas que você quer acompanhar e confirme em Conectar (o botão mostra quantas contas estão marcadas, por exemplo Conectar 2 conta(s)).

Como saber que deu certo

O card do Meta Ads passa a mostrar Conectado e o selo Método: Token, sem aviso de expiração. As contas que você marcou aparecem em Contas de Anúncio, e as campanhas começam a aparecer no Gerenciador depois da primeira sincronização.

Troque o token

1. Se o token foi gerado com validade, o card do Meta Ads, em Conexões, avisa Expira em ou Acesso expirado.
2. Gere um token novo com validade Nunca (passo 4) e clique em Trocar token, no card.
3. Cole o token novo em Token de acesso e clique em Validar e trocar token. As contas e o histórico continuam conectados.

Problemas comuns

Próximo passo

• Gerenciador de Anúncios: suas campanhas em um lugar só: o que fazer com as contas conectadas.
• Dashboards: leve os números dos anúncios para painéis junto com os outros apps.