Integración de URL CSV

Importa documentos directamente desde archivos CSV accesibles públicamente a través de URL en la base de conocimientos de tu asistente de IA.

---

Inicio Rápido

Comienza en 3 pasos:

1. Navegar: Administración → Mis Asistentes → [Nombre del Asistente] → Integraciones → URL CSV
2. Agregar URL: Ingresa tu URL CSV pública y selecciona el tipo de importación (FAQ/Producto/Predeterminado)
3. Importar: Haz clic en "Agregar URL" y monitorea el estado

Consejo: Prueba primero con un archivo CSV pequeño para familiarizarte con el proceso.

---

Lo Que Puedes Hacer

• ✅ Importar desde URLs CSV públicas HTTP/HTTPS
• ✅ Importar múltiples URLs a la vez
• ✅ Detección automática de la estructura CSV (FAQ, Producto o Genérico)
• ✅ Asignar categorías y mapear columnas personalizadas
• ✅ Rastrear el estado y el historial de importación

---

Requisitos Previos

• Acceso de administrador a tu asistente AI SmartTalk
• Archivos CSV accesibles públicamente (sin autenticación requerida)
• Estructura CSV adecuada con encabezados de columna
• Se recomienda codificación UTF-8

---

Tipos de Importación

1. Importación de FAQ

Mejor para: Documentación de soporte, bases de conocimientos

Columnas requeridas:

• question
• answer

Ejemplo:

question,answer
"¿Cómo restablezco mi contraseña?","Haz clic en 'Olvidé mi contraseña' y sigue las instrucciones."
"¿Cuáles son sus horarios?","De lunes a viernes, de 9 AM a 6 PM."

2. Importación de Producto

Mejor para: Catálogos de comercio electrónico, inventario

Columna requerida:

• idProduct (o columna mapeada personalizada)

Opcional:

• name (o columna mapeada personalizada)

Ejemplo:

idProduct,name,description,price
"PROD001","Widget Premium","Widget de alta calidad","99.99"
"PROD002","Widget Estándar","Widget básico","49.99"

3. Importación Predeterminada

Mejor para: Contenido general, datos mixtos

• Detecta automáticamente la estructura de FAQ o Producto
• Recurre a la importación de documentos genéricos
• Maneja varios formatos CSV

---

Guía Paso a Paso

Paso 1: Acceder a la Integración

1. Inicia sesión en AI SmartTalk
2. Ve a Administración → Mis Asistentes → [Tu Asistente]
3. Haz clic en Integraciones → CSV URL

Paso 2: Agregar URL CSV

URL Única:

1. Haz clic en Agregar Nueva URL CSV
2. Ingresa la URL del archivo CSV
3. Proporciona un nombre opcional
4. Selecciona el tipo de importación (FAQ/Producto/Predeterminado)
5. Elige categoría (opcional)
6. Haz clic en Agregar URL

Importación Masiva:

1. Haz clic en Importar URLs Masivamente
2. Ingresa URLs (una por línea)
3. Configura ajustes compartidos
4. Haz clic en Importar Todas las URLs

Paso 3: Configurar Mapeo de Columnas (Solo Producto)

Mapea tus columnas CSV a los campos esperados:

• Columna ID Producto: Predeterminado idProduct → Mapea a product_id, sku, etc.
• Columna Nombre: Predeterminado name → Mapea a product_name, title, etc.

Paso 4: Monitorear Importación

Rastrea el estado en el Historial de Importación:

• Pendiente: Esperando para procesar
• Importado: Completado con éxito
• Error: Fallido (ver detalles)

Paso 5: Re-importar (Actualizar Datos)

1. Encuentra la URL en el historial
2. Haz clic en Re-importar
3. Confirma la acción
4. Monitorea el estado actualizado

Paso 6: Verificar Importación

1. Revisa la Base de Conocimientos para nuevos documentos
2. Prueba el chatbot con preguntas sobre el contenido importado

---

Requisitos de CSV

URLs Válidas

✅ https://example.com/data/products.csv
✅ https://cdn.company.com/catalog.csv
✅ https://raw.githubusercontent.com/user/repo/main/data.csv

❌ ftp://files.company.com/data.csv (FTP no soportado)
❌ https://private.site.com/auth-data.csv (Se requiere autenticación)
❌ file:///local/data.csv (Archivos locales no soportados)

Requisitos del Archivo

• Acceso: Accesible públicamente a través de HTTP/HTTPS
• Encabezados: La primera fila debe contener nombres de columnas
• Delimitadores: Coma (,) o punto y coma (;)
• Codificación: Se recomienda UTF-8
• Tamaño: Máximo 10MB por archivo

---

Solución de Problemas

Errores Comunes

Error	Solución
URL No Accesible	Verifica que la URL sea pública y válida
Formato Inválido	Revisa el delimitador y los encabezados
Columnas Faltantes	Asegúrate de que existan las columnas requeridas (pregunta/respuesta o idProduct)
Tiempo de Espera de Archivo Grande	Divide el archivo o reduce el tamaño por debajo de 10MB

Pasos de Resolución

1. Prueba la URL en el navegador
2. Valida la estructura y codificación del CSV
3. Revisa los mensajes de error en el historial de importación
4. Prueba con un archivo de muestra más pequeño
5. Contacta al soporte si el problema persiste

---

Mejores Prácticas

Gestión de URL

• Utiliza URLs estables y permanentes
• Prueba las URLs mensualmente para verificar su accesibilidad
• Usa CDN para un mejor rendimiento
• Incluye la versión en los nombres de archivo: products-v2024.csv

Organización de Datos

• Utiliza nombres de categoría claros
• Mantén formatos CSV consistentes
• Limpia los datos antes de la importación (elimina filas vacías)
• Mantén los archivos por debajo de 10MB

Rendimiento

• Prueba primero con muestras pequeñas
• Procesa grandes importaciones durante horas no pico
• Usa importación masiva para múltiples URLs relacionadas
• Monitorea la tasa de éxito de importación regularmente

---

Seguridad

• ✅ Transferencias en HTTPS cifradas
• ✅ Validación de URL
• ✅ Control de acceso basado en permisos
• ✅ Procesamiento de archivos temporales (sin almacenamiento permanente)
• ✅ Limpieza automática de datos antiguos
• ✅ Registros de auditoría para todas las actividades

---

Después de la Importación

Una vez importados, tus datos:

1. Se vuelven buscables en la base de conocimientos
2. Potencian las respuestas del chatbot de inmediato
3. Aparecen organizados por categorías
4. Pueden ser verificados en la sección de Base de Conocimientos

Verifica tu importación:

• Revisa la Base de Conocimientos para nuevos documentos
• Prueba el chatbot con preguntas sobre el contenido importado
• Revisa las categorías y la organización

---

Soporte

¿Necesitas ayuda?

• 📧 Correo electrónico: contact@aismarttalk.tech
• 📚 Documentos: https://docs.aismarttalk.tech/

---

Resumen

Ahora puedes:

• ✅ Importar datos CSV desde URLs públicas
• ✅ Manejar tipos de datos de FAQ, Producto y genéricos
• ✅ Importar múltiples fuentes de forma masiva
• ✅ Mapear columnas personalizadas para productos
• ✅ Monitorear y gestionar importaciones
• ✅ Actualizar datos a través de re-importaciones

Próximos pasos:

1. Prueba con un CSV de muestra
2. Importa tus datos de producción
3. Configura categorías
4. Programa re-importaciones regulares
5. Monitorea el rendimiento

¿Preguntas? Contacta a nuestro equipo de soporte en cualquier momento.