> 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/airtable.md).

# \[Exemplo] Enviando dados para o Airtable (POST)

Dados coletados dentro dos bots frequentemente são enviados para um banco de dados externo. Uma maneira fácil de fazer isso é integrando com [Airtable](https://airtable.com). Airtable é uma ferramenta que permite criar uma planilha com a qual você pode se comunicar via API.

{% hint style="info" %}
Por favor, note que o termo *estado do diálogo* refere-se à mesma coisa que *bloco*, no contexto de ferramentas de desenvolvimento.
{% endhint %}

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 %}

* Comece construindo um fluxo curto que você use para coletar alguns dados sobre seu usuário, por exemplo:

![](/files/56b508b7dd3bff7eb4595de1c0d149a39080a1db)

* Este fluxo adiciona as variáveis "customerType" e "firstName" à sessão do usuário.

![](/files/9b5882a7f618e7e897ee73589cd940ed523cb91e)

* Configure um Airtable que tenha uma coluna para cada variável que você deseja salvar. Linhas serão adicionadas para cada cliente.

![](/files/7c46dee06a47d8c3aa2e70b66b3ceffee9e36846)

{% hint style="info" %}
Neste tutorial, usaremos [este Airtable](https://airtable.com/invite/l?inviteId=invSGcyaorwSSPjLi\&inviteToken=a6d2dc90da0a95019886b059a10323d827520aa1b46dcf2c528756c3e120189c). Fique à vontade para reutilizá-lo!
{% endhint %}

* No ponto do fluxo onde você deseja enviar os dados para o Airtable, adicione uma Ação contendo um plugin de Código.

{% 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 %}

* No nosso exemplo, queremos enviar o tipo do cliente e o primeiro nome. Além disso, queremos pular para outro diálogo do bot assim que os dados forem enviados. Comece adicionando esses parâmetros no topo do seu editor de código.

![](/files/666101578edddb6fbea22f1a41fee9ec733398f1)

* Em seguida, adicione o código abaixo ao plugin e salve seu diálogo de Ação.

```javascript
const body = {
    "records": [{
        "fields": {
            "First Name": args.firstName,
            "Customer Type": args.customerType
        }
    }]
}
const airtableResult = await fetch('https://api.airtable.com/v0/(yourAppId)/(yourTableName)', {
    method: 'POST',
    body: JSON.stringify(body),
    headers: {
        'Authorization': 'Bearer (insert token here)',
        'Content-Type': 'application/json'
    }
}).then(r => r.json())

ChatlayerResponseBuilder()
    .setNextDialogState(args.nextDialogState)
    .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 %}

* Et voilà! Agora, toda vez que um usuário passar pelo seu fluxo, seus dados serão enviados para o Airtable e ele continuará para o diálogo de bot Success.
* Se houver quaisquer erros com sua conexão ao Airtable, você pode encontrá-los na aba de Logs de Erro no Chatlayer.ai.

![](/files/d9638a5cabbb11546b290bf844b6f8ac8cc9e3ff)


---

# 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/airtable.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.
