Airtable | ElevenLabs Documentation

Tu recepcionista puede buscar a quien llama en una tabla de Airtable y añadir un nuevo registro, como un contacto potencial o una solicitud de devolución de llamada. Las búsquedas usan la API de Airtable. Los nuevos registros pasan por una automatización de Airtable, ya que la API espera campos anidados de una forma que las herramientas de webhook no pueden enviar.

Buscar registros

Crea un token de acceso personal

Ve a airtable.com/create/tokens y crea un token con el ámbito data.records:read. En Access, añade solo la base que necesita tu recepcionista.

Busca los ID de la base y la tabla

Abre la tabla en tu navegador. La URL contiene el ID de la base, que empieza por app, y el ID de la tabla, que empieza por tbl.

Crea la herramienta de webhook

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

Campo	Valor
Name	`find_airtable_record`
Description	”Busca a quien llama en nuestra tabla de clientes. Úsala cuando alguien llame para preguntar por una reserva, pedido o cuenta existentes.”
Method	GET
URL	`https://api.airtable.com/v0/BASE_ID/TABLE_ID`
Request Headers	`Authorization`: `Bearer` seguido de tu token
Query Parameters	`filterByFormula` (cadena, obligatorio): “Una fórmula de Airtable que coincida con quien llama; por ejemplo, `{Phone} = '+14155550123'`. Usa los nombres de campo Phone y Name.” `maxRecords` (número, obligatorio): “Siempre 5.”
Assign to agents	Receptionist

Selecciona Enable.

Sustituye Phone y Name en la descripción por los nombres de campo de tu tabla para que tu recepcionista escriba fórmulas que coincidan.

Añadir registros

Crea una automatización

En tu base, abre Automations, selecciona Create automation y elige el activador When webhook received. Copia la URL del webhook. Los activadores de webhook no están disponibles en todos los planes de Airtable.

Crea la herramienta de webhook

Ve a Integrations, selecciona Add integration y elige Webhook Tool.

Campo	Valor
Name	`add_airtable_record`
Description	”Guarda un nuevo contacto potencial cuando alguien llama para pedir un presupuesto o una devolución de llamada.”
Method	POST
URL	La URL del webhook de la automatización
Body Parameters	Uno por cada campo que rellenar; por ejemplo, `name`, `phone` y `request` (todos cadenas, obligatorios)
Assign to agents	Receptionist

Envía un ejemplo y asigna los campos

Prueba tu recepcionista con una conversación que active la herramienta. En la automatización, selecciona Test trigger para cargar la solicitud; después, añade una acción Create record y asigna cada parámetro del cuerpo a un campo.

Activa la automatización

Activa la automatización.

Solución de problemas

Problema	Qué comprobar
401 o 403 en las búsquedas	El token necesita el ámbito `data.records:read` y acceso a esta base.
422 `INVALID_FILTER_BY_FORMULA`	Los nombres de campo de la descripción de la herramienta deben coincidir exactamente con los de la tabla, incluidas las mayúsculas.
Las búsquedas no devuelven nada	Los números de teléfono deben guardarse en el mismo formato que envía tu recepcionista, como `+14155550123`.
No se añaden registros	La automatización debe estar activada y Create record debe asignar campos del activador de webhook.
429 de Airtable	Airtable permite 5 solicitudes por segundo y por base. Reduce otro tráfico de API en la base.