> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/airtable.md). # Airtable {% hint style="warning" %} Esta integração está indisponível no momento. Estamos trabalhando para resolver o problema.\ Assine a newsletter para receber atualizações sobre nossa correção. {% endhint %} Com esta integração, você pode pesquisar, ler e atualizar dados no seu banco de dados do Airtable muito mais facilmente do que tendo que criar uma API. Você pode conectar seu aplicativo Airtable de 2 maneiras: 1\. [Via bloco de ação b](#a.-via-action-bot-dialog)loqueie quando estiver construindo seu bot 2\. [No menu da página inicial do Chatlayer](#b.-from-chatlayers-homepage-menu): principalmente antes de construir seu bot, quando você sabe que vai criar requisições para uma ou mais tabelas do Airtable {% hint style="warning" %} Dependendo do seu [plano do Airtable](https://support.airtable.com/docs/airtable-plans), você terá um número máximo diferente de linhas que poderá ter. Certifique-se de que seu plano atenda às suas necessidades antes de construir seu banco de dados. {% endhint %} ## 1 – Via bloco de ação Configure seu aplicativo Airtable diretamente em um bloco de ação clicando na opção 'Adicionar ação' e depois em 'Integração': ![](/files/d2968006bbd0d796610812b463dd87944fbfc1e2) Se ainda não houver nenhum aplicativo Airtable configurado (como descrito na parte 2 deste guia), aparecerá uma janela pop-up: ![](/files/bc341a58bb5143213b41ceed0893800c56ca3a1f) Você pode encontrar sua Chave de API na página da sua conta Airtable. Saiba mais [d](https://support.airtable.com/hc/en-us/articles/219046777-How-do-I-get-my-API-key-). ![](/files/4b910ef00011fa7096b6fc2921f81921dbe286ac) Ou você também pode gerar novamente a chave: ![](/files/19859dd38754f4f75552143df0da8019bd924825) Ao clicar na Chave de API, você poderá vê-la. Então clique, selecione, copie e cole-a no campo correspondente da janela pop-up: ![](/files/d36fb5eb8d804943597d685fc91ee4d54c6dd7f7) Você verá um novo campo para selecionar integrações. Escolha 'Airtable' ![](/files/eb816adadb7d73db1e138327466e813ced1bc90c) No campo da Conta Airtable, você verá todos os Apps que talvez já tenha criado seguindo as etapas da segunda parte deste guia, ou poderá criar um novo clicando em 'Conectar nova conta': ![](/files/b7e6ba83af2fa0e089f095a40e15ef1ba2c141a1) Depois de escolher o App integrado que você já tem (ou criar um novo), você verá o campo 'Selecionar ação'. Existem três ações possíveis: Pesquisar, Criar e Atualizar registros do seu Airtable ![](/files/ec7daca49621dc0ccedc3cd30c91ac05fb37dbbf) Três novos campos vazios aparecerão nesta tela. Veja como preenchê-los: ![](/files/b6587bef7c7f9eea4625de1edcf1348d991da8bb) Você obterá as informações do campo “Base” a partir da URL do Airtable. A sintaxe da URL é: isto para “Base”]\*\*/**tblYYYYYY\[use isto para “Tabela”]**/… ![](/files/8ed13285f545fdca871a7ea7eb28f5657b0ed736) ![](/files/40919e5ffa5dbb07ac69419bad376be1e892ecca) É assim que seu bloco de ação ficará depois de preenchido: ![](/files/f15cde4f05f187fe514f7198e23972942ac6555b) Para a ação de Pesquisa, preencha o 'Campo de pesquisa' (use o nome da coluna da sua tabela) e o Valor de pesquisa (um [variável ](/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr.md)que o usuário inserirá, que deve corresponder a um dos pontos de dados do Campo de pesquisa) **ou** crie sua própria Fórmula de pesquisa.
Mais informações sobre o que preencher se você quiser usar a opção 'Fórmula de pesquisa' [aqui](https://support.airtable.com/hc/en-us/articles/203255215-Formula-field-reference). Agora construa a sintaxe da sua resposta: ![](/files/f8ec7a59c931dc5e98ec5123bbcc18460a4de75e) Você saberá que está certo quando seu bot exibir os dados corretos da sua tabela: ![](/files/94a058d2ebe6581f8da58898a766d0ec012e2856) ## 2. No menu da página inicial do Chatlayer Você pode configurar a integração com o Airtable diretamente no menu lateral esquerdo em [app.chatlayer.ai](https://app.chatlayer.ai/) ![](/files/8957cf4d21f802b14636b152f891a67961251a95) ![](/files/57a25c39cf0b8e6ccdc7ab7b9c9b3cf81d329776) Você também pode criá-la clicando no botão '+ Adicionar conta', após o qual você verá este pop-up: ![](/files/bc341a58bb5143213b41ceed0893800c56ca3a1f) Você pode encontrar sua Chave de API na página da sua conta Airtable. Saiba mais [aqui](https://support.airtable.com/hc/en-us/articles/219046777-How-do-I-get-my-API-key-) ![](/files/4b910ef00011fa7096b6fc2921f81921dbe286ac) Ou você pode gerar novamente uma chave: !\[Interface gráfica do usuário, texto, aplicativo, e-mail Descrição gerada automaticamente]\(<../../.gitbook/assets/17 (1)>) Ao clicar na Chave de API, você poderá vê-la. Clique, selecione, copie e cole-a no campo correspondente da janela pop-up: ![](/files/d36fb5eb8d804943597d685fc91ee4d54c6dd7f7) É assim que ficará quando você tiver conectado com sucesso ![](/files/7b057154e1491812e3b976f03604bbc38f385940) Ao clicar nos três pontos à direita, você pode gerenciar a integração do seu aplicativo. Existem quatro ações: ![](/files/20c01d1d71fa8f106e799742f26c820c1ef9545b) * Reconectar: abrirá uma nova janela pop-up permitindo que você altere a Chave de API * Testar conexão (em breve) * Alterar nome da conta: abrirá uma janela pop-up para que você possa renomear seu aplicativo integrado * Remover: **Atenção!** Ao clicar neste botão, a integração do seu aplicativo será **imediatamente** removida ![Reconectar](/files/a9a4af973190ac08d63ad5e6113b23a28bf9a7c5) ![Alterar nome da conta](/files/d0a53077267e6fd79ef4b0da7d18c83e1fed768c) ![Remova](/files/3f2cb19750ca020650b70c5267167e96484a486f) ## Como usar cada tipo de ação possível na integração do aplicativo Airtable Pesquisar, Criar e Atualizar registro são as ações possíveis: ![](/files/04c55ce813a9e37ee949a680b1c85024847b97ce) ### Criar registro Para criar um registro, você deve selecionar o aplicativo Airtable e a conta Airtable (conectando-se a uma existente ou a outra), escolher a ação Criar registro, informar Base e Tabela, conforme explicado em A.8.1(link). A próxima etapa é preencher os campos do registro. No espaço em branco do lado esquerdo, deve ser informado o nome da coluna no seu Airtable, e no espaço em branco do lado direito, deve ser informado o valor “fixo” ou variável (entre chaves). No exemplo abaixo, a coluna a ser atualizada se chama ‘Number’ e a variável se chama `numberChosen`. A variável informada pelo usuário foi salva em uma etapa anterior por meio de uma [Validação de entrada](https://docs.chatlayer.ai/bot-answers/dialog-state/user-input-bot-dialog) bloco. ![](/files/75bd767d2e699f7abf0a3d1e5dcd7360d81c022b) ### Atualizar registro Para atualizar um registro, você deve selecionar o aplicativo Airtable e a conta Airtable (conectando-se a uma existente ou a outra), escolher a ação Atualizar registro, informar Base e Tabela, conforme explicado em A.8.1(link). Leia sobre os campos ID do registro e Valores das células abaixo da imagem. ![](/files/7751ea791af7d11025a82bc16108660616936911) #### ID do registro do Airtable O ID do registro é o que está destacado na URL na captura de tela abaixo – você não pode usar apenas o valor informado pelo cliente; para se referir ao ID correto, você coleta o ID informado pelo cliente em uma variável (por meio de uma Validação de entrada xv). ![](/files/240201f45b23dcfa8e62c95921c847b91f94bad9) A sintaxe correta para recuperar o ID do registro é `{apps.airtable.read_record._id}` Em Valores das células, o nome da coluna onde o valor será atualizado é informado no espaço em branco do lado esquerdo, neste caso ‘Number’, e a variável que tem o novo valor salvo nela no espaço em branco do lado direito, neste exemplo `{numberUpdate}` A captura de tela a seguir mostra um exemplo do fluxo que é explicado na tabela mais abaixo. ![](/files/c0ae8ccff214e21501ec0ea206972fc0c2f8305b) | **Diálogo do bot** | **Variável ou ação realizada** | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Criar atualização | O usuário informa o ponto de dados atual que gostaria de atualizar, que será salvo sob a variável `{ticketToUpdate}` | | Obter ID do ticket | A ação realizada é a Search Record, com Search Value como o `{ticketToUpdate}` variável | | Obter valor de atualização | O usuário informa o valor atualizado que será salvo sob a variável `{numberUpdate}` | | Ler e atualizar ticket |

O ID do registro é recuperado do Airtable usando {apps.airtable.read\_record.\_id}

Os valores das células informados são o nome da coluna (neste caso, Number) e a variável salva na etapa anterior {numberUpdate} é passado como o novo valor para esse ticket.

| Agora você está pronto para criar uma experiência de bot personalizada para seus clientes! --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/app-integrations/airtable.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.