API e exportações

Gere chaves só de leitura, acompanhe o uso do mês, agende exportações em CSV e ligue os dados ao Looker Studio e ao Power BI em Configurações › API e integrações.

Disponível em: Scale e Enterprise. No Starter e no Pro, com o complemento API e MCP. Incluído no teste grátis.Atualizado em 14 de outubro de 20266 min de leitura
Neste artigo · 10 seções

A seção API e integrações leva os dados do Relator para fora: painéis no Looker Studio e no Power BI, planilhas e sistemas próprios. Tudo é somente leitura: nenhuma chave cria, edita ou publica nada nas contas dos clientes.

Antes de começar

  • Onde fica: Configurações › grupo Agência › API e integrações. Na conta própria, Configurações › API e integrações, no grupo Sua conta.
  • Quem usa: a equipe da agência (ou o dono da conta própria). Dono e Admin criam e revogam chaves; Membro só vê. Pessoas do cliente não têm acesso a esta seção.
  • Plano: a API vem incluída no Scale e no Enterprise. No Starter e no Pro, ela é liberada pelo complemento API e MCP. Sem o recurso, a seção mostra uma tela de exemplo e o caminho para liberar.

O que tem em cada aba

  • Chaves de API

    Para que serve
    Criar, listar e revogar chaves. Mostra também a URL da API, com o botão Copiar.
  • Exportações agendadas

    Para que serve
    Mandar um CSV por e-mail ou para o Google Drive todo dia, toda semana ou todo mês, sem chave.
  • Looker Studio e Power BI

    Para que serve
    O passo a passo de cada ferramenta e a URL do feed do Power BI, montada por seletores.
  • Uso

    Para que serve
    Quantas requisições a API recebeu no mês, contra o limite do plano.
AbaPara que serve
Chaves de APICriar, listar e revogar chaves. Mostra também a URL da API, com o botão Copiar.
Exportações agendadasMandar um CSV por e-mail ou para o Google Drive todo dia, toda semana ou todo mês, sem chave.
Looker Studio e Power BIO passo a passo de cada ferramenta e a URL do feed do Power BI, montada por seletores.
UsoQuantas requisições a API recebeu no mês, contra o limite do plano.

Criar uma chave

  1. 1
    Passo 1

    Abra API e integrações

    Clique em Configurações na barra lateral e, no grupo Agência, em API e integrações. Clique em Nova chave.

    Tela ilustrativa
    Agência Farol
    Foto de Marina, que usa o Relator
    API e integraçõesSomente leitura · 200.000 requisições por mês
    Chaves de APIExportações agendadasLooker Studio e Power BIUso
    Chaves de acesso
    NomeAcessoClientesÚltimo uso
    Looker Studio · KorraLeitura1 clientehá 2 horas
    Power BI · todosLeitura + metasTodos (6)Nunca usada
    1. 1Nova chave abre a criação em 3 passos.
    2. 2Cada chave mostra o que lê, de quais clientes e quando foi usada pela última vez. Revogar fica na linha.
  2. 2
    Passo 2

    Diga para que é

    Escolha a finalidade: Looker Studio, Power BI, Planilha ou Sistema próprio. Clique em Continuar.

  3. 3
    Passo 3

    Escolha o que a chave lê

    Depois clique em Criar chave.

    • O que pode ler: Métricas de mídia (Meta Ads, Google Ads, GA4), CRM e receita (HubSpot, RD Station), Metas e SEO (Search Console).
    • Clientes: escolha na lista com busca ou marque Todos os clientes (inclui os novos).
    • Validade: 30 dias, 1 ano ou Sem validade.
    • Nome: o RelatorAI sugere um nome a partir da finalidade e dos clientes. Dá para editar.
  4. 4
    Passo 4

    Copie a chave

    A janela Chave criada mostra a chave inteira uma única vez. Clique em Copiar chave e guarde num lugar seguro antes de Concluir.

Usar a chave

  • Looker Studio

    Como conectar
    Crie a chave com a finalidade Looker Studio, abra o conector do Relator no Looker Studio, autorize e cole a chave quando ele pedir. Se o botão Abrir conector do Looker Studio estiver desligado com o aviso Conector em publicação, use o Power BI, o CSV ou as exportações agendadas até o conector sair.
  • Power BI

    Como conectar
    Na aba Looker Studio e Power BI, escolha o cliente, a fonte e o formato e copie a URL do feed (últimos 30 dias, uma linha por dia). No Power BI, use Obter dados › OData (ou Web), cole a URL e escolha autenticação Básica: qualquer usuário e a chave como senha.
  • Excel e planilhas

    Como conectar
    Use a mesma URL do feed no formato CSV para Excel e planilhas, ou agende o CSV na aba Exportações agendadas.
  • Sistema próprio

    Como conectar
    Chame a URL da API mandando a chave no cabeçalho Authorization: Bearer. Para baixar uma tabela, use /metrics com format=csv.
FerramentaComo conectar
Looker StudioCrie a chave com a finalidade Looker Studio, abra o conector do Relator no Looker Studio, autorize e cole a chave quando ele pedir. Se o botão Abrir conector do Looker Studio estiver desligado com o aviso Conector em publicação, use o Power BI, o CSV ou as exportações agendadas até o conector sair.
Power BINa aba Looker Studio e Power BI, escolha o cliente, a fonte e o formato e copie a URL do feed (últimos 30 dias, uma linha por dia). No Power BI, use Obter dados › OData (ou Web), cole a URL e escolha autenticação Básica: qualquer usuário e a chave como senha.
Excel e planilhasUse a mesma URL do feed no formato CSV para Excel e planilhas, ou agende o CSV na aba Exportações agendadas.
Sistema próprioChame a URL da API mandando a chave no cabeçalho Authorization: Bearer. Para baixar uma tabela, use /metrics com format=csv.

Limites e uso

  • Cada plano tem um teto mensal de requisições, mostrado no topo da seção e na aba Uso: 50.000 por mês no Starter e no Pro (com o complemento) e 200.000 no Scale. No Enterprise, o limite é de contrato.
  • A aba Uso mostra o total do mês, a data em que renova e a projeção no ritmo atual.
  • Ao passar de 90% do limite, aparece um aviso no topo da seção e os donos da agência recebem um e-mail.
  • Acima do limite, a API responde com erro 429 até a renovação. As exportações agendadas não usam chave.
  • Chaves sem uso há 90 dias expiram sozinhas, além da validade escolhida.
  • Uma chave para de funcionar se a pessoa que a criou sair da agência ou deixar de ser Dono ou Admin.

Exportações agendadas

  1. 1
    Passo 1

    Crie a exportação

    Na aba Exportações agendadas, clique em Nova exportação.

  2. 2
    Passo 2

    Escolha destino e conteúdo

    • Destino: E-mail (CSV), escolhendo em Quem recebe as pessoas da agência, ou Google Drive. Para o Drive, conecte a conta antes em Conectar Google Drive; o Relator só enxerga a pasta que ele mesmo cria.
    • Fonte: Meta Ads, Google Ads, Google Analytics 4, Search Console, HubSpot ou RD Station.
    • Linhas: por dia ou por campanha.
    • Clientes e Nome, como na chave.
  3. 3
    Passo 3

    Defina a frequência e agende

    Escolha Todo dia, Toda semana (com o dia da semana) ou Todo mês (com o dia do mês) e o Horário, no fuso mostrado na tela. Clique em Agendar exportação.

  • Por e-mail, chega um link Baixar o CSV. O link vale 7 dias e exige login no Relator com a mesma agência.
  • Link vencido, de outra conta ou de exportação apagada abre a tela Este link de download não vale mais. A próxima entrega manda um link novo.
  • Quando um envio falha, a linha mostra Falhou com o motivo e o botão Tentar de novo. Se o Drive perdeu o acesso, use Reconectar Google Drive.
  • Excluir para os próximos envios. Os arquivos já enviados continuam onde estão.

Revogar uma chave

Na aba Chaves de API, clique em Revogar na linha da chave e confirme. O acesso para na próxima requisição e os painéis que usam a chave deixam de atualizar. Revogue sempre que alguém que conhece a chave sair da agência ou quando a chave aparecer num lugar que não devia.

E os webhooks?

O Relator ainda não envia webhooks. Em Configurações › Notificações, o Webhook assinado aparece em Próximos canais, marcado como Em breve. Para ser avisado de problemas, use os alertas e as notificações por e-mail.

Disponibilidade por plano

RecursoStarterProScaleEnterprise
Preço mensal (cartão)R$ 59/mêsR$ 199/mêsR$ 499/mêsA partir de R$ 1.499/mês
Anual no cartão (12 meses pelo preço de 10)R$ 590R$ 1.990R$ 4.990A partir de R$ 1.499/mês
Espaços de cliente1515Sob contrato
Fontes de dados conectadas52575Sob contrato
Pessoas da equipe2515Sob contrato
Atualização completa dos dados1 vez por diaA cada 6 horasA cada horaA cada 15 minutos
Mensagens do RelatorAI por mês1003001.000Sob contrato
Histórico disponível12 meses24 meses36 mesesSob contrato
Dashboards personalizadosNão incluídoIncluídoIncluídoIncluído
Relatórios agendadosNão incluídoIncluídoIncluídoIncluído
Modelos de relatórioNão incluídoIncluídoIncluídoIncluído
CRM e ROAS realIncluídoIncluídoIncluídoIncluído
Metas e alertasNão incluídoIncluídoIncluídoIncluído
Marca branca no portal e nos relatóriosNão incluídoIncluídoIncluídoIncluído
Acesso à APINão incluídoNão incluídoIncluídoIncluído
Edição em lote de campanhasNão incluídoNão incluídoIncluídoIncluído
Suporte prioritárioNão incluídoNão incluídoIncluídoIncluído
Assistentes de IA (MCP)Não incluídoNão incluídoIncluídoIncluído
Gerenciador de campanhasNão incluídoNão incluídoIncluídoIncluído
Gerente de conta dedicadoNão incluídoNão incluídoNão incluídoIncluído
SSO (login único)Não incluídoNão incluídoNão incluídoNão incluído
Preços em reais. Valores e limites desta tabela vêm direto do catálogo de planos, então estão sempre atualizados.
Add-onPreço mensal
Espaço de cliente extraR$ 29/mês
Pessoa extra na equipeR$ 15/mês
Gerenciador de campanhas (Meta Ads e Google Ads)R$ 99/mês
API e MCPR$ 49/mês
Atualização de hora em horaR$ 79/mês
Pacote de 200 mensagens do RelatorAIR$ 49 compra única
Add-ons são cobrados por mês junto com o plano e podem ser removidos a qualquer momento.

Problemas comuns

  • Não vejo Nova chave. Seu papel é Membro. Peça a um Dono ou Admin da agência.
  • A seção mostra “Disponível a partir do” um plano. O plano não inclui a API. Contrate o complemento API e MCP ou mude para o Scale. Veja Complementos.
  • O painel parou de atualizar. A chave foi revogada, expirou (validade ou 90 dias sem uso) ou quem a criou saiu da agência. Crie uma chave nova e troque no painel.
  • Erro 429. O limite do mês acabou. A aba Uso mostra quando renova.
  • A URL do feed não aparece. Nenhum cliente tem fonte conectada. Conecte uma fonte no cliente primeiro.

Perguntas frequentes

A chave consegue alterar campanhas ou dados?

Não. Toda chave é somente leitura.

Posso dar uma chave só com os dados de um cliente?

Pode. Ao criar, escolha só aquele cliente em Clientes. Um cliente fora da lista responde como se não existisse.

Preciso de chave para receber o CSV toda semana?

Não. As exportações agendadas mandam o CSV por e-mail ou para o Google Drive sem chave.

Posso conectar o Relator ao Zapier ou ao Make?

Não há integração pronta com essas ferramentas. Elas podem chamar a API com a chave no cabeçalho Authorization: Bearer, como qualquer sistema próprio.

E para perguntar no Claude ou no ChatGPT?

Use os assistentes de IA (MCP), liberados pelo mesmo complemento. Veja Assistentes de IA (MCP).

Leia também

Chat

Não achou? Fale com a gente.

O chat fica no canto da tela aqui no site e, dentro do app, no menu da sua foto.

E-mailsuporte@relator.digital

Para dúvidas de conta e de dados. Pedidos de privacidade e exclusão vão para privacidade@relator.digital.