> 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/code-action/retrieving-data-from-airtable-get.md).

# \[Exemplo] Recuperando dados do Airtable (GET)

Bots são frequentemente usados para mostrar dados de fontes externas ao usuário. Uma maneira fácil de gerenciar esses dados é usando [Airtable](https://airtable.com). Airtable é uma ferramenta que permite criar uma planilha com a qual você pode se comunicar por meio de uma API.

Neste tutorial, vamos configurar uma integração com o Airtable. Por causa de todo o código, parece bem técnico, mas, na verdade, é bem fácil.

{% hint style="info" %}
Se você é novo no uso de variáveis no Chatlayer.ai, siga [este](broken://pages/88adc3005e539a863d5e8169aba21855faaabcd6) o tutorial primeiro.
{% endhint %}

Como exemplo, vamos construir um bot que mostra informações sobre encontros de chatbots.

* A primeira coisa que precisamos fazer é criar alguns dados de encontros. Neste exemplo, vamos usar [este Airtable](https://airtable.com/shrJGHyo1RZuJf72Z). Fique à vontade para reutilizá-lo!

![](/files/f56b11d219633fed44057fe9f9648e1037bff4fd)

* Comece criando um fluxo curto que explique o propósito do bot e pergunte de qual mês o usuário quer saber informações sobre encontros.

![](/files/9b3a0593d21dd70427f10498025acf3f1fc86967)

* Para a pergunta sobre o mês, certifique-se de usar uma [validação de entrada](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md) que salva a resposta como a`mês` variável e que continue para a próxima etapa: um bloco de Ação.

![](/files/eeff28920f34c3b5a20ddd46f22159b172675edd)

* Configure o bloco de Ação que é acionado após a validação de entrada com um plug-in de código. Adicione a variável "month" como argumento, conforme mostrado na captura de tela:

![](/files/d12bf434a8b2c6b72698392a635d01fee5f11200)

{% hint style="info" %}
Quer saber mais sobre as possibilidades do plug-in de Código? Você pode encontrá-lo [aqui](/chatlayer-documentation-pt-br/integrateandcode/code-action.md).
{% endhint %}

* Em seguida, adicione este trecho de código:

```javascript
const { month } = args;

const { records = [] } = await fetch(
  "https://api.airtable.com/v0/(yourAppId)/(yourTableName)",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer (insert token here)",
    },
  }
).then((res) => res.json());

const found = records.filter((rec) => rec.fields.Month === month.toLowerCase());

const builder = ChatlayerResponseBuilder();

if (found.length) {
  builder.addSessionVariable("meetups", found);
} else {
  builder.addSessionVariable("nomeetups", found);
}

builder.send();
```

{% hint style="warning" %}
Lembre-se de obter o app id, o nome da tabela e o bearer token corretos para o seu Airtable. Você pode encontrá-los [aqui](https://airtable.com/api).
{% endhint %}

* Este bloco de código pesquisa na tabela por um encontro no mês informado pelo usuário e, se encontrar um, retorna essas informações para o Chatlayer.ai. Se nenhum encontro for encontrado, a `nomeetups` variável é salva na sessão do usuário.
* Se você seguir o fluxo até este ponto, ele ficará mais ou menos assim:

![](/files/16c164dc44e2b6f838d416fae6da9bb42c15dc7c)

* E os seguintes dados são salvos na sessão:

![](/files/69ea0183d2cc8702197eff78b4eae9aa99543e00)

* Agora tudo o que precisamos fazer é mostrar esses dados! Adicione um Go To ao final do bloco de Ação onde você adicionou o bloco de código.
* Configure este Go To da seguinte forma:

![](/files/9c225d99e7bd8978eb26d2e1bd71b4244756fc59)

* Dessa forma, o usuário receberá uma resposta diferente se não houver encontros no mês sobre o qual ele perguntou.
* Por fim, configure as mensagens em "show meetup info" para exibir as informações recuperadas da planilha do Airtable.

![](/files/cef53a71ffbd779be808d3e751a4208bc06b1c57)

* Pronto! Agora você pode testar o fluxo completo.

![](/files/3a50dc2731504986da4dcd1557df4db618662ee2)


---

# 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/code-action/retrieving-data-from-airtable-get.md?ask=<question>&goal=<endgoal>
```

`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.