Airtable
Conecte una base y una tabla de Airtable con un token de acceso personal para que un agente pueda registrar llamadas y buscar filas.
Qué conseguirá
Una tabla de Airtable mostrará Connected.
Descripción general y casos de uso
La conexión puede añadir y actualizar filas y buscar filas, que es la base para registrar las llamadas en una tabla.
Requisitos previos
- Una cuenta de Airtable y una base con una tabla.
Configuración de la cuenta externa (en Airtable)
Airtable controla estas pantallas. La guía de Airtable: Web API.
- Cree un personal access token en airtable.com/create/tokens.
- Dele los ámbitos
data.records:readydata.records:write. - Añada la base que quiera usar a la lista de acceso del token.
- Copie el token, después copie el Base ID de la URL de la base (empieza por
app) y anote el nombre de la tabla o su id (tbl…).
Conéctelo en Phynxa
- Integrations, Connect en Airtable.
- Escriba el Personal access token, el Base ID y la Table.
- Elija Check and connect.
Permisos y ajustes
| Campo | Significado |
|---|---|
| Personal access token | Obligatorio. |
| Base ID | Obligatorio. Empieza por app. |
| Table | Obligatorio. El nombre de una tabla o su id. |
Airtable permite unas 5 solicitudes por segundo y base; si responde 429, espere 30 segundos.
Úselo en una llamada
En la pestaña Tools de un agente, Add tool, Integration, Airtable:
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Find records | Encuentra registros en los que una columna es igual a un valor, como un teléfono. Necesita field y value; max_records es opcional (hasta 100). | Espera |
| Get record | Lee un registro. Necesita record_id (empieza por rec) de una búsqueda. | Espera |
| Create record | Añade un registro. fields es una línea Nombre de columna: valor por campo, con los nombres de columna exactamente como los tiene la tabla. | En segundo plano |
| Update record | Cambia campos de un registro. Necesita record_id y fields (mismo formato). | En segundo plano |
El agente trabaja siempre en la base y la tabla guardadas con la conexión; no puede nombrar otras.
Pruébelo
Test connection debe responder «Airtable is responding.»
Resultado esperado
La tarjeta muestra Connected.
Solución de problemas
- 403 o no encontrado. La base no se añadió al token, o faltan los ámbitos.
- Tabla equivocada. Use el nombre exacto de la tabla, o su id
tbl….
Seguridad y credenciales
El token se almacena cifrado. Elimínelo en Airtable para revocar el acceso; Remove lo elimina aquí.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.