Airtable
Sincroniza tus tablas de Airtable en la base de conocimientos de AI SmartTalk. Convierte tus datos estructurados en conocimiento consultable por IA—perfecto para catálogos de productos, preguntas frecuentes, directorios de equipos y más.
Descripción general
La integración de Airtable te permite:
- Conectar tu base de Airtable a través de la clave API
- Sincronizar los datos de la tabla como entradas de la base de conocimientos
- Consultar tus datos de manera conversacional a través de la IA
- Mantener los datos actualizados con sincronizaciones manuales o programadas
Requisitos previos
Antes de comenzar, asegúrate de tener:
- Una cuenta activa de AI SmartTalk
- Una cuenta de Airtable con al menos una base
- Una clave API de Airtable (Token de Acceso Personal)
Configuración paso a paso
Paso 1: Genera tu clave API de Airtable
- Inicia sesión en tu cuenta de Airtable
- Ve a Configuración de la cuenta → Centro de desarrolladores
- Haz clic en Crear nuevo token
- Configura tu token:
- Nombre:
AI SmartTalk Integration - Alcances: Selecciona
data.records:readyschema.bases:read - Acceso: Elige las bases específicas que deseas conectar
- Nombre:
- Haz clic en Crear token y cópialo inmediatamente
Importante: ¡Guarda tu token de forma segura—Airtable solo lo muestra una vez!
Paso 2: Conéctate a AI SmartTalk
- Inicia sesión en tu cuenta de AI SmartTalk
- Navega a Configuración → Integraciones
- Busca Airtable y haz clic en Conectar
- Pega tu clave API en el campo Token de Acceso Personal
- Haz clic en Validar
Paso 3: Selecciona las tablas para sincronizar
Después de la validación, verás tus bases y tablas disponibles:
- Explorar bases: Haz clic para expandir cada base
- Seleccionar tablas: Marca las tablas que deseas sincronizar
- Configurar campos: Elige qué columnas incluir
- Haz clic en Iniciar sincronización
Paso 4: Verifica la importación
- Ve a Conocimiento en AI SmartTalk
- Tus registros de Airtable aparecen como entradas individuales de conocimiento
- Prueba tu IA haciendo preguntas sobre tus datos
Qué se sincroniza
| Tipo de dato | Cómo se procesa |
|---|---|
| Campos de texto | Sincronizados como contenido buscable |
| Campos numéricos | Incluidos en el contexto del registro |
| Seleccionar/Múltiples selecciones | Tratados como categorías/etiquetas |
| Registros vinculados | Referencias incluidas |
| Adjuntos | URLs referenciadas (archivos no descargados) |
| Fórmulas | Valores calculados sincronizados |
Ejemplo: Catálogo de productos
Si tienes una tabla de "Productos":
| Nombre | Descripción | Precio | Categoría |
|---|---|---|---|
| Widget Pro | Widget de calidad profesional... | $99 | Herramientas |
| Widget Lite | Widget de nivel de entrada... | $49 | Herramientas |
Tu IA puede responder:
- "¿Qué productos tienes?"
- "Cuéntame sobre Widget Pro"
- "¿Cuál es tu herramienta más barata?"
Configuración de sincronización
Selección de campos
Para cada tabla, puedes configurar:
- Campo principal: Identificador principal para cada registro
- Campos de contenido: Campos a incluir en la base de conocimientos
- Excluir campos: Campos internos a omitir (IDs, marcas de tiempo, etc.)
Frecuencia de sincronización
| Opción | Descripción |
|---|---|
| Manual | Haz clic en "Sincronizar ahora" cuando sea necesario |
| Al importar | Sincroniza cuando inicias una importación |
| Programada | Configurada a través de SmartFlow (ver abajo) |
Programación con SmartFlow
Para sincronizar automáticamente tus datos de Airtable:
- Crea un nuevo SmartFlow
- Agrega un disparador Programado (diario, semanal, etc.)
- Agrega la acción Sincronizar → Selecciona Airtable
- Guarda y activa el flujo de trabajo
Casos de uso
Catálogo de productos/servicios
Sincroniza tu base de datos de productos para que los clientes puedan preguntar:
- "¿Qué productos tienes por menos de $100?"
- "Compara Widget Pro y Widget Lite"
- "¿Tienes algo en la categoría de Herramientas?"
FAQ / Base de conocimientos
Almacena preguntas frecuentes en Airtable con columnas de Pregunta/Respuesta:
- "¿Cómo restablezco mi contraseña?"
- "¿Cuál es tu política de reembolsos?"
- "¿Dónde puedo encontrar mi factura?"
Directorio de equipo
Sincroniza los datos de los miembros del equipo para consultas internas:
- "¿Quién maneja el soporte al cliente?"
- "¿Cuál es el rol de Sarah?"
- "Lista a todos en el equipo de Ingeniería"
Datos de eventos/programación
Sincroniza tablas de eventos para consultas de programación:
- "¿Qué eventos se avecinan?"
- "¿Cuándo es el próximo seminario web?"
- " ¿Qué sucedió en la reunión del mes pasado?"
Solución de problemas
Problemas de conexión
| Problema | Solución |
|---|---|
| "Clave API inválida" | Regenera el token en el centro de desarrolladores de Airtable |
| "Base no encontrada" | Asegúrate de que el token tenga acceso a esa base |
| "Permiso denegado" | Agrega el alcance data.records:read a tu token |
Problemas de sincronización
| Problema | Solución |
|---|---|
| Registros faltantes | Verifica que los registros no estén filtrados/ocultos en la vista |
| Datos obsoletos | Haz clic en Sincronizar ahora para actualizar |
| Sincronización de campos incorrectos | Revisa la selección de campos en la configuración de integración |
La IA no puede encontrar datos
| Problema | Solución |
|---|---|
| Sin resultados para consultas | Espera a que la sincronización se complete y la IA procese |
| Respuestas parciales | Asegúrate de que todos los campos relevantes estén incluidos en la sincronización |
Gestión de la conexión
| Acción | Cómo |
|---|---|
| Actualizar clave API | Configuración → Integraciones → Airtable → Actualizar Token |
| Agregar tablas | Editar conexión → Seleccionar tablas adicionales |
| Eliminar tablas | Desmarcar tablas que ya no deseas sincronizar |
| Desconectar | Configuración → Integraciones → Airtable → Desconectar |
Mejores prácticas
- Estructura para IA: Usa nombres de campo claros y descriptivos
- Eliminar duplicados: Elimina registros duplicados antes de sincronizar
- Usar campos principales sabiamente: Elige identificadores únicos y descriptivos
- Sincronizaciones regulares: Mantén los datos actualizados, especialmente para contenido cambiante
- Limitar el alcance: Sincroniza solo las tablas que tu IA necesita para responder preguntas
Documentación relacionada
- Descripción general de integraciones
- Gestión de la base de conocimientos
- Importación de URL CSV — Alternativa para datos estáticos
- Disparadores programados de SmartFlow — Automatiza las sincronizaciones