> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com Airtable

> Conecte seu app Base44 ao Airtable para trazer seus dados em tempo real para painéis, ferramentas e fluxos de trabalho.

<Info>
  <u>Nota</u>: A integração com Airtable está disponível no nível Builder e superiores. Se você está no nível Free, precisa atualizar seu app para usar funções de backend e recursos de pagamento.
</Info>

# Configuração passo a passo:

## Parte 1: O lado do Airtable

Se você já tem um token de API e Base ID do Airtable, pode pular para a [**Parte 2: O lado do Base44**](https://docs.base44.com/Integrations/Airtable-integration#part-2%3A-the-base44-side).

<Steps>
  <Step title="Crie um Personal Access Token">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/AirtableBuilderHub.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=76937cf25bdd1fd4c0c868b440a75a8d" alt="Airtable Builder Hub Pn" width="1901" height="944" data-path="images/AirtableBuilderHub.png" />

    * Acesse a [<u>página de criação de tokens do Airtable</u>](https://airtable.com/create/tokens/new).
    * Em "Scopes", crie um token com escopo para o workspace/base correto, com pelo menos:
      * `data.records:read`
      * `schema.bases:read` *(opcional, mas útil para testes)*
    * Nomeie seu token, defina um limite de crédito se usar, e copie o token em um local seguro.
  </Step>

  <Step title="Encontre seu Base ID">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRTable.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b08891d38f2972511b423d5bf467a005" alt="HR Table Pn" width="1891" height="944" data-path="images/HRTable.png" />

    1. Abra sua base do Airtable em um navegador.
    2. Olhe a URL e copie a string que começa com "**app**", pois esse é seu Base ID

       Exemplo: `https://airtable.com/app123XYZ/...`
  </Step>
</Steps>

***

## Parte 2: O lado do Base44

Depois de ter seu token de API e Base ID, você pode conectá-lo ao Base44 de duas maneiras diferentes:

<CardGroup cols={2}>
  <Card icon="sparkle" href="https://docs.base44.com/Integrations/Airtable-integration#option-a%3A-ready-made-integration-create-a-new-app" title="Opção A: Integração pronta (preferida)">
    * Escolha este caminho se você está começando um novo app do zero.
  </Card>

  <Card icon="bolt" href="https://docs.base44.com/Integrations/Airtable-integration#option-b%3A-add-airtable-as-an-instant-integration" title="Opção B: Integração instantânea">
    * Escolha este caminho se você já está no meio da construção e quer integrar o Airtable a um app existente.
  </Card>
</CardGroup>

### Opção A: Integração pronta (criar um novo app)

<Steps>
  <Step title="Adicione o Airtable a partir do catálogo de integrações">
    <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />

    * No catálogo de integrações, selecione Airtable
    * Em seguida, clique em "Use this integration"

          <img src="https://mintcdn.com/base44/-Vklow6W-uVvNnvR/images/image7.png?fit=max&auto=format&n=-Vklow6W-uVvNnvR&q=85&s=041a8013c65236fe5f17e3d7303461ab" alt="Image7 Pn" width="1877" height="878" data-path="images/image7.png" />
  </Step>

  <Step title="Cole seus segredos">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/B44AirtableIntegration.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=591c4433e5721fab7cbb0b82c6d847a9" alt="B44airtable Integration Pn" width="1877" height="867" data-path="images/B44AirtableIntegration.png" />

    * Quando solicitado, cole:
      * `AIRTABLE_API_KEY`
      * `AIRTABLE_BASE_ID`
  </Step>

  <Step title="Construa seu app">
    * Aqui está um prompt de exemplo que você pode usar:

      `"Construa um painel interno. Vamos conectar à minha base do Airtable e mostrar registros reais. Inclua uma página de Status de Sincronização e comece me deixando escolher uma tabela antes de construir visualizações."`
    * O app executa uma chamada de teste no Airtable e lista suas tabelas
    * Você seleciona uma
    * Ele busca registros reais e mostra uma tabela de dados brutos para que o esquema fique claro
  </Step>

  <Step title="Página de status de sincronização">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    Você terá uma página com o seguinte:

    * Um botão **Check Connection** para executar o teste novamente
    * Lista de tabelas
    * Hora da última verificação
    * Status da conexão
  </Step>
</Steps>

***

### **Opção B: Adicione o Airtable como integração instantânea**

Escolha este caminho se você já tem um app em andamento.

<Steps>
  <Step title="Acesse seu app existente">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboard.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=8409b5ee99da7d9ff4dc41c36adbfff4" alt="HR Dashboard Pn" width="1876" height="871" data-path="images/HRDashboard.png" />

    * Aqui está o prompt que digitamos no chat de IA para construir nosso app de exemplo:

      `"Construa um painel interno. Me deixe escolher uma fonte de dados depois."`
  </Step>

  <Step stepNumber={2} title="Conecte ao Airtable pelo chat de IA">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/ConnectAirtableApp.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=124a38233bf1d5dba4f7df5365c14142" alt="Connect Airtable App Pn" width="1874" height="868" data-path="images/ConnectAirtableApp.png" />

    * Aqui está um prompt de exemplo que colamos em nosso chat de IA:

      `Conecte este app ao Airtable. Me pergunte AIRTABLE_API_KEY e AIRTABLE_BASE_ID e salve-os como Secrets. Adicione uma função de backend que possa testar a conexão e buscar registros. Crie uma página de Status de Sincronização com um botão Check Connection.`
    * Clique em "**Set secrets**" no chat de IA
    * Cole sua **API Key** e **Base ID** quando solicitado
  </Step>

  <Step stepNumber={3} title="Busque tabelas e mostre dados">
    * Solicite ao chat de IA que mostre os dados
    * Aqui está um prompt de exemplo que usamos para nosso app:

      `Execute o teste de conexão para listar minhas tabelas, me deixe escolher uma e busque registros e mostre uma visualização de tabela bruta antes de qualquer visualização.`
  </Step>

  <Step stepNumber={4} title="Teste seu app">
    <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/HRDashboardSync.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=b381c4548b5efb2c3135ad1df01d02e3" alt="HR Dashboard Sync Pn" width="1873" height="869" data-path="images/HRDashboardSync.png" />

    * Abra **Sync Status** e clique em **Check Connection**
    * Escolha uma tabela e confirme se você vê linhas em tempo real
  </Step>
</Steps>

***

## **Solução de problemas**

* **403 ou falha de conexão** – O escopo do token está incorreto. Verifique se data.records:read está habilitado. Adicione schema.bases:read se a listagem de tabelas falhar.
* **Base ID incorreto** – Verifique se você copiou a string app... da URL.
* **Sem dados exibidos** – Verifique se a base realmente tem registros e se o token tem acesso.
* **Pré-visualização pública vs sessão do builder** – Permaneça logado no builder durante o teste do Status de Sincronização.

***

## **Casos de uso comuns**

Aqui estão algumas maneiras em que equipes costumam usar o Airtable com o Base44:

* **Painéis** – Importe dados do Airtable e visualize-os em tempo real.
* **Gerenciamento de dados** – Dê aos colegas uma interface amigável para visualizar ou verificar registros do Airtable.
* **Monitores de sincronização** – Crie uma página de Status de Sincronização para testar conexões rapidamente e confirmar atualizações.
* **Ferramentas internas** – Construa apps leves (como visualizações de CRM ou rastreadores de conteúdo) em cima do Airtable sem código personalizado.

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>