Você investe em anúncios no Facebook e precisa monitorar os resultados no Power BI — mas a única forma que encontrou até agora é baixar planilha, abrir Excel, limpar coluna por coluna e importar tudo de mão. Toda semana. Isso soa familiar?

Essa rotina cansa qualquer analista. E ela tem solução: a API de Marketing do Facebook entrega todos esses dados de forma automática, sem exportação manual, sem copy-paste, sem sofrimento. O que você precisa para começar é exatamente o que vamos resolver hoje — gerar o token de autenticação, aquele código que permite ao Power BI conversar com a sua conta de anúncios.

Bora lá. Esse tutorial é curto, direto e resolve de uma vez.

O que é o token e por que ele é necessário

A API do Facebook Ads usa autenticação via token de acesso — um código único que prova que você tem permissão para ler os dados daquela conta. Sem ele, qualquer requisição é recusada.

Pense no token como uma chave de API: você gera uma vez, guarda em lugar seguro e usa sempre que o Power BI precisar buscar dados de campanhas, conjuntos de anúncios, métricas de alcance, custo, conversões, etc.

⚠️ Atenção antes de começar

Você precisa ter uma Conta de Anúncios ativa no Meta Business Suite e ser administrador dela. Sem isso, o token gerado não vai ter permissão para ler as métricas que você quer.

1 Acesse o Facebook Developers

Vá para developers.facebook.com e faça login com a sua conta do Facebook pessoal (a mesma que tem acesso ao Meta Business Suite).

No menu superior, clique em "Meus apps". Se nunca usou o Facebook Developers antes, o painel vai estar vazio — é normal.

2 Crie um novo aplicativo

Clique em "Criar app". Vai aparecer uma tela perguntando qual o objetivo do seu aplicativo.

Selecione a opção "Empresa" — essa é a categoria correta para quem vai usar a API de Marketing. As outras opções (Consumidor, Gaming) não dão acesso às métricas de anúncios.

💡 Por que "Empresa"?

O tipo "Empresa" libera o produto API de Marketing, que é exatamente o que dá acesso às métricas de campanhas, conjuntos de anúncios e criativos. As outras categorias não têm esse produto disponível.

3 Nomeie e vincule ao seu portfólio

Na próxima tela, preencha:

  • Nome do app: pode ser qualquer coisa. Exemplo: PowerBI-FacebookAds
  • E-mail de contato: seu e-mail
  • Portfólio de negócios: selecione o Business Manager onde estão suas contas de anúncio

Clique em "Criar app" e confirme sua senha do Facebook se solicitado.

4 Adicione o produto: API de Marketing

Após criar o app, você cai no painel de configuração. Role a página até encontrar a seção "Adicionar produtos ao seu app".

Localize o card "API de Marketing" e clique em "Configurar". Isso vai ativar o produto e liberar o painel de geração de token.

Depois de ativar, vai aparecer no menu lateral esquerdo a opção "API de Marketing" com submenus: Guia de início rápido, Ferramentas e Registro de webhooks.

5 Gere o token de acesso

No menu lateral, clique em API de Marketing → Ferramentas. Isso abre o Explorador da API do Graph.

Nessa tela:

  1. No campo "Aplicativo do Facebook", selecione o app que você acabou de criar
  2. Clique em "Gerar token de acesso"
  3. Uma janela vai abrir pedindo permissões — autorize o acesso
  4. O token vai aparecer no campo "Token de acesso"

Copie esse token e guarde em lugar seguro. Não compartilhe com ninguém — ele dá acesso de leitura à sua conta de anúncios.

💡 Anote a versão da API que aparece no Explorador

Antes de gerar o token, você vai ver a versão atual no campo superior — algo como v25.0. Esse número muda a cada lançamento do Facebook (geralmente a cada 3 meses). Sempre use a versão que aparece lá, não copie uma URL com versão antiga de tutorial.

⚠️ Esse token tem prazo de validade

Por padrão, o token gerado pelo Explorador da API do Graph expira em poucas horas (geralmente 1 a 2 horas). Para usar no Power BI em produção, você precisa de um token de longa duração — explico como no bônus abaixo.

6 Use o token no Power BI

Com o token em mãos, abra o Power BI Desktop e siga:

  1. Clique em Obter Dados → Web
  2. No campo de URL, cole a chamada da API do Facebook com o token:
⚠️ Verifique a versão antes de copiar

A versão da Graph API muda a cada lançamento do Facebook — atualmente está na v25.0 (abr/2026), mas pode estar diferente quando você ler isso. Sempre confirme a versão atual no changelog oficial ou olhe o número que aparece no Explorador da API do Graph.

https://graph.facebook.com/vXX.0/act_SEU_AD_ACCOUNT_ID/insights
  ?fields=campaign_name,spend,impressions,clicks,cpc
  &date_preset=last_30d
  &access_token=SEU_TOKEN_AQUI

Substitua vXX.0 pela versão atual (ex: v25.0), SEU_AD_ACCOUNT_ID pelo ID da sua conta de anúncios (começa com act_ — você encontra no Meta Business Suite) e SEU_TOKEN_AQUI pelo token gerado.

O Power BI vai receber um JSON com as métricas de campanhas. A partir daí é só transformar com o Power Query e montar seu dashboard.

Dica Bônus

Token de 60 dias: como gerar e não ficar renovando toda hora

O token padrão do Explorador dura poucas horas. Pra produção, você quer um token de longa duração — que dura até 60 dias.

A forma mais prática: use a própria API do Facebook para fazer a troca. Com o token de curta duração que você gerou, faça a seguinte chamada (pode testar direto no Explorador da API do Graph):

GET /oauth/access_token
  ?grant_type=fb_exchange_token
  &client_id=SEU_APP_ID
  &client_secret=SEU_APP_SECRET
  &fb_exchange_token=SEU_TOKEN_CURTO

O App ID e o App Secret estão em Configurações → Básico no painel do seu app. A resposta vai trazer o token de 60 dias pronto para usar.

💡 E depois dos 60 dias?

Você vai precisar renovar. Não existe token permanente para usuários comuns — a Meta toma isso como medida de segurança. A solução para automação completa é usar um token de Sistema via Meta Business Suite, mas isso fica para um próximo artigo.

Pronto — seus dados de campanha no Power BI

Com o token gerado e a URL da API configurada no Power BI, você para de exportar planilha manualmente. Dá pra agendar refresh automático, cruzar com outras fontes de dados e montar um dashboard que abre já atualizado toda manhã.

Se travar em algum passo, especialmente na parte de permissões do Explorador da API, comenta aqui — esse é um ponto que costuma pegar bastante dependendo das permissões da sua conta.

E se quiser aprender a montar o relatório completo de Facebook Ads no Power BI — estrutura de dados, relacionamentos, métricas calculadas em DAX — esse conteúdo está na formação Chora API Revolution.

Quer dominar integrações de API no Power BI?

Facebook Ads, Bling, Omie, Open Finance — tudo isso na formação completa Chora API Revolution, com n8n e Supabase inclusos.

Ver a Formação →