> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Airtable

Sua recepcionista pode consultar um chamador em uma tabela do Airtable e adicionar um novo registro, como um lead ou uma solicitação de retorno. As consultas usam a API do Airtable. Os novos registros passam por uma automação do Airtable, porque a API espera campos aninhados de uma forma que as ferramentas de webhook não conseguem enviar.

## Consultar registros

### Crie um token de acesso pessoal

Acesse [airtable.com/create/tokens](https://airtable.com/create/tokens) e crie um token com o escopo `data.records:read`. Em **Access**, adicione apenas a base de que sua recepcionista precisa.

### Encontre os IDs da base e da tabela

Abra a tabela no navegador. A URL contém o ID da base, que começa com `app`, e o ID da tabela, que começa com `tbl`.

### Crie a ferramenta de webhook

Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                | Valor                                                                                                                                                                                                                        |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `find_airtable_record`                                                                                                                                                                                                       |
| **Description**      | "Consulte o chamador em nossa tabela de clientes. Use quando um chamador perguntar sobre uma reserva, pedido ou conta existente."                                                                                            |
| **Method**           | GET                                                                                                                                                                                                                          |
| **URL**              | `https://api.airtable.com/v0/BASE_ID/TABLE_ID`                                                                                                                                                                               |
| **Request Headers**  | `Authorization`: `Bearer ` seguido do seu token                                                                                                                                                                              |
| **Query Parameters** | `filterByFormula` (string, obrigatório): "Uma fórmula do Airtable que corresponde ao chamador, por exemplo `{Phone} = '+14155550123'`. Use os nomes de campo Phone e Name."  `maxRecords` (number, obrigatório): "Sempre 5." |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                             |

Selecione **Enable**.

Substitua `Phone` e `Name` na descrição pelos nomes dos campos da sua tabela, para que sua recepcionista escreva fórmulas correspondentes.

## Adicionar registros

### Crie uma automação

Na sua base, abra **Automations**, selecione **Create automation** e escolha o gatilho **When webhook received**. Copie a URL do webhook. Os gatilhos de webhook não estão disponíveis em todos os planos do Airtable.

### Crie a ferramenta de webhook

Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**.

| Campo                | Valor                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| **Name**             | `add_airtable_record`                                                                                |
| **Description**      | "Salve um novo lead quando um chamador quiser um orçamento ou um retorno."                           |
| **Method**           | POST                                                                                                 |
| **URL**              | A URL do webhook da automação                                                                        |
| **Body Parameters**  | Um para cada campo a preencher, por exemplo `name`, `phone` e `request` (todos string, obrigatórios) |
| **Assign to agents** | **Receptionist**                                                                                     |

### Envie uma amostra e mapeie os campos

[Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma conversa que acione a ferramenta. Na automação, selecione **Test trigger** para carregar a solicitação, depois adicione uma ação **Create record** e mapeie cada parâmetro do corpo para um campo.

### Ative a automação

Ative a automação.

## Solução de problemas

| Problema                        | O que verificar                                                                                                                |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| 401 ou 403 nas consultas        | O token precisa do escopo `data.records:read` e de acesso a esta base.                                                         |
| 422 `INVALID_FILTER_BY_FORMULA` | Os nomes dos campos na descrição da ferramenta devem corresponder exatamente aos da tabela, incluindo maiúsculas e minúsculas. |
| As consultas não retornam nada  | Os números de telefone devem estar no mesmo formato que sua recepcionista envia, como `+14155550123`.                          |
| Nenhum registro é adicionado    | A automação deve estar ativada, e **Create record** deve mapear os campos do gatilho de webhook.                               |
| 429 do Airtable                 | O Airtable permite 5 solicitações por segundo por base. Reduza outro tráfego de API na base.                                   |