Airtable | ElevenLabs Documentation

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