Como integrar o Airtable no Reportei

Agora você pode integrar o Airtable ao Reportei e levar para os relatórios e dashboards os dados que você organiza nas suas bases. Assim, leads, vendas, conteúdos, projetos e campanhas aparecem junto com as outras métricas do cliente.

👉🏻 A integração com o Airtable está disponível a partir do plano Premium.

O que é o Airtable

O Airtable é uma plataforma que mistura planilha e banco de dados. Nele, você organiza as informações em bases, e cada base reúne tabelas. Cada tabela guarda registros com campos como texto, número, data e seleção.

Além disso, o Airtable tem as views, que são visualizações salvas de uma tabela, com filtros e ordenações próprias. Por exemplo, uma view só com os leads deste mês.

👉🏻 Diferente das outras integrações, o Airtable não tem métricas fixas, porque cada empresa organiza a própria base do seu jeito. Por isso, no Reportei ele funciona como o Google Sheets: uma integração de dados personalizados, em que você cria as métricas.

🔑 Como criar o token de acesso no Airtable

A conexão usa um token de acesso pessoal do Airtable. Para criar o token:

  1. No Airtable, acesse Builder hub > Personal access tokens e clique em Create new token.
  2. Adicione as permissões de leitura dos registros, da estrutura das bases e do e-mail: data.records:read, schema.bases:read e user.email:read.
  3. Libere o acesso do token às bases que você vai usar nos relatórios.
  4. Copie o token.

👉🏻 O Airtable mostra o token uma única vez, no momento em que ele é criado. Por isso, guarde o token antes de fechar a tela.

🔗 Como conectar o Airtable ao Reportei

  1. Vá em Gerenciar integrações e escolha o Airtable.
  2. Cole o token no formulário de integração.
  3. Escolha a tabela ou a view que vai para o relatório.

Na lista de seleção, aparecem as tabelas e as views de todas as bases liberadas para o token. Ao lado, aparece o e-mail do dono do token. No entanto, views do tipo formulário não aparecem, porque elas não guardam dados para relatório.

📊 Como criar as métricas

Depois de escolher a tabela ou a view, o caminho é o mesmo do Google Sheets:

  1. O Reportei lê a tabela e identifica as colunas.
  2. Você confere como cada coluna deve ser lida: número, data, texto e assim por diante.
  3. Você cria as métricas no mesmo editor do Google Sheets, manualmente ou com o Criar métricas, que usa IA para sugerir métricas a partir dos dados.

Como o Airtable já informa o tipo de cada campo (número, data, texto, seleção), o Reportei já começa com as colunas classificadas. Ou seja, você só precisa conferir. Depois basta avançar para criar as métricas.

Com as métricas criadas, você usa o Airtable em relatórios e dashboards como qualquer outra fonte. Ou seja, você monta números, gráficos e tabelas e filtra pelo período analisado.

Limites e cuidados

Até 2.500 registros por vez: O Reportei lê até 2.500 registros de uma vez. Quando a tabela ou a view passa disso, o relatório mostra um aviso, em vez de números parciais. Para bases maiores, use uma view com filtro, por exemplo só com os registros do ano atual. Quando as métricas usam a mesma coluna de data, o limite vale só para os registros do período analisado.

Plano Free do Airtable: Workspaces no plano Free do Airtable têm apenas 1.000 chamadas de API por mês. Por isso, esse limite pode não ser suficiente para relatórios atualizados com frequência.

Limite de requisições: Quando o Airtable atinge o limite de requisições, aparece um aviso pedindo para aguardar 30 segundos e clicar em Tentar novamente.

Atualização dos dados: Os dados do Airtable podem levar até um minuto para aparecer atualizados no relatório.

Fuso horário. O filtro de período usa as datas da tabela no fuso horário do projeto no Reportei.

Avisos que podem aparecer

  • Tabela não encontrada: aparece quando a tabela é apagada ou quando o token perde o acesso a ela.
  • Campo apagado: se você apagar um campo no Airtable, só as métricas que usam esse campo deixam de funcionar. As demais continuam normalmente.
  • Reintegração: o Reportei só pede a reintegração quando o token é revogado ou deixa de ser válido.

Perguntas frequentes

Por que o Airtable não tem métricas prontas?
Porque cada empresa organiza a base do próprio jeito. Por isso, assim como no Google Sheets, você cria as métricas a partir das colunas da tabela.

Posso usar uma view em vez da tabela inteira?
Sim. Inclusive, essa é a melhor saída para bases com mais de 2.500 registros: crie uma view com filtro e use essa view no relatório.

Perdi o token. E agora?
O Airtable mostra o token só uma vez. Nesse caso, crie um novo token no Airtable e use esse token na integração.

Artigos relacionados

Este artigo foi útil?00