> 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

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](https://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](/docs/es/reception-ai/receptionist/testing) 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.                                       |