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

Bots são frequentemente usados para mostrar dados de fontes externas ao seu 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 via API.

Neste tutorial configuraremos uma integração com o Airtable. Por causa de todo o código parece bastante 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, usaremos [este Airtable](https://airtable.com/shrJGHyo1RZuJf72Z). Fique à vontade para reutilizá-lo!

![](/files/f56b11d219633fed44057fe9f9648e1037bff4fd)

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

![](/files/9b3a0593d21dd70427f10498025acf3f1fc86967)

* Para a pergunta sobre o mês, certifique-se de que está usando um [validador de entrada](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md) que salva a resposta como a`variável mês` e que continua para o próximo passo: 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 aprender 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 id do app, o nome da tabela e o token bearer corretos para o seu Airtable. Você pode encontrá-los [aqui](https://airtable.com/api).
{% endhint %}

* Este bloco de código procura na tabela um encontro no mês que o usuário informou e, se encontrar, retorna essa informação 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á algo 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 Ir Para ao final do bloco de Ação onde você adicionou o bloco de código.
* Configure este Ir Para da seguinte forma:

![](/files/9c225d99e7bd8978eb26d2e1bd71b4244756fc59)

* Dessa maneira, o usuário receberá uma resposta diferente se não houver encontros no mês sobre o qual perguntou.
* Finalmente, configure as mensagens em "mostrar informações do encontro" para exibir as informações recuperadas da planilha do Airtable.

![](/files/cef53a71ffbd779be808d3e751a4208bc06b1c57)

* Tudo pronto! Agora você pode testar o fluxo completo.

![](/files/3a50dc2731504986da4dcd1557df4db618662ee2)


---

# Agent Instructions: 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:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/code-action/retrieving-data-from-airtable-get.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.