Documentación en Desarrollo
Esta guía está actualmente en desarrollo. El contenido puede estar incompleto o sujeto a cambios.
Gestion de Datasets
Domina el ciclo de vida completo de datasets - desde subir listas de contactos hasta monitorear el progreso de ejecucion y exportar resultados enriquecidos.
En esta guia
Entendiendo Datasets
Un dataset es una coleccion de registros de contacto que tu flujo procesara. Cada fila representa un contacto a alcanzar via WhatsApp, Voz, o ambos.
Ciclo de Vida del Dataset
Dataset vs Base de Datos
Datasets son para alcance - cada fila se procesa una vez a traves de tu flujo. Bases de Datos son para datos persistentes - usadas para consultas y enriquecimiento a traves de multiples ejecuciones.Aprende mas sobre bases de datos →
Subiendo un Dataset
Requisitos del Archivo
- Formatos: CSV o Excel (.xlsx)
- Requerido: Columna de numero de telefono
- Opcional: Identificador, nombre, email y columnas personalizadas
- Tamano maximo: 50,000 filas por archivo
Pasos:
- Navega a la pestana Datasets de tu campana
- Haz clic en "Subir Dataset"
- Selecciona tu archivo CSV/Excel
- Mapea la columna de Telefono (requerido)
- Opcionalmente mapea columnas de identificador, nombre y email
- Establece codigo de pais por defecto si los numeros no lo incluyen
- Configura el cruce con base de datos (si aplica)
- Haz clic en "Procesar"
Cascada de Codigo de Pais
Si los numeros de telefono no incluyen codigos de pais, el sistema los aplica en este orden:
- Nivel de dataset: Codigo de pais establecido durante la carga
- Nivel de campana: Codigo de pais por defecto en configuracion de campana
- Nivel de cliente: Pais por defecto de la organizacion
Validacion y Normalizacion de Telefono
Despues de la carga, el sistema valida y normaliza tus datos automaticamente.
Validacion Automatica
Validacion de Telefono
Los numeros de telefono se validan por formato y se normalizan al formato E.164 (+56912345678). Los numeros invalidos se marcan para revision.
Deteccion de Duplicados
Los duplicados se detectan tanto dentro del archivo como contra datasets existentes de la campana. Puedes elegir omitir o incluir duplicados.
Cruce con Base de Datos
Si esta configurado, las filas se cruzan contra la base de datos de la campana. Puedes previsualizar las tasas de cruce antes de procesar.
Resultados de validacion con correcciones
Captura de pantalla proximamente
Sugerencias de Correccion
El sistema sugiere correcciones para problemas comunes:
- Codigos de pais faltantes
- Espacios extra o caracteres especiales
- Formatos de numero de telefono incorrectos
Seguimiento de Estado de Filas
Cada fila del dataset tiene un estado que rastrea su progreso a traves de la ejecucion del flujo.
Tipos de Estado
Pendiente
Aun no procesado, esperando en cola
En Progreso
Actualmente ejecutando pasos del flujo
Esperando Respuesta
Esperando respuesta del cliente
Completado
Finalizo exitosamente todos los pasos
Fallido
Ocurrio error durante la ejecucion
Omitido
Telefono invalido o filtrado
Cancelado
Usuario cancelo la ejecucion
Reemplazado
Reemplazado por dataset mas nuevo
Monitoreo de Ejecucion
Monitorea el progreso de ejecucion en tiempo real con actúalizaciones en vivo via SignalR.
Resumen de Progreso
- Barra de progreso: Indicador visual del porcentaje de completado
- Desglose de estado: Conteo por estado (completado, fallido, pendiente, etc.)
- Paso actúal: Que paso del flujo se esta ejecutando
- Metricas de velocidad: Mensajes/llamadas por minuto
Cuadricula Fila por Fila
Ve el estado de filas individuales en una cuadricula con busqueda y filtros:
- Filtrar por estado (mostrar solo fallidos, mostrar solo completados)
- Buscar por numero de telefono o identificador
- Ordenar por tiempo de ejecucion o estado
- Clic en cualquier fila para ver historial detallado
Detalles de Fila e Historial de Interaccion
Haz clic en cualquier fila para ver sus detalles completos de ejecucion e historial de interaccion.
Modal de detalle de fila individual
Captura de pantalla proximamente
Estado de Mensaje
Para mensajes de WhatsApp, rastrea el estado de entrega:
Linea de Tiempo de Ejecucion
Ve una linea de tiempo cronologica de todos los eventos para una fila:
Linea de tiempo de historial de ejecucion
Captura de pantalla proximamente
- Transiciones de pasos del flujo con marcas de tiempo
- Mensajes enviados y recibidos
- Eventos de llamadas de voz (conectada, transferida, finalizada)
- Resultados de clasificacion y extraccion de IA
- Errores y reintentos
Enriquecimiento de Datos
Durante la ejecucion del flujo, los datos se enriquecen y almacenan de vuelta en la fila del dataset.
Tipos de Enriquecimiento
Resultados de Clasificacion IA
Categorias asignadas por pasos de IA (ej. "interesado", "no_interesado", "callback").
Resultados de Extraccion IA
Datos estructurados extraidos por IA (ej. fecha de cita, razon de llamada).
Datos Cruzados de Base de Datos
Campos de la base de datos de campana que coincidieron con esta fila.
Variables de Flujo
Variables personalizadas establecidas durante la ejecucion del flujo usando el paso DatasetEnrich.
Seccion de enriquecimientos de fila
Captura de pantalla proximamente
Exportando Datos Enriquecidos
Exporta tu dataset con todos los enriquecimientos incluidos:
- Ve a la pagina de detalle del dataset
- Haz clic en "Exportar"
- Selecciona columnas a incluir (originales + enriquecimientos)
- Elige formato (Excel o CSV)
- Descarga el archivo enriquecido
Reemplazo de Datasets
Cuando subes un nuevo dataset que contiene numeros de telefono ya presentes en un dataset anterior, el sistema maneja esto mediante "reemplazo".
Como Funciona el Reemplazo
- Nuevo dataset se sube con numeros de telefono superpuestos
- Las filas del dataset antiguo con telefonos coincidentes se marcan como "Reemplazadas"
- Las filas reemplazadas no se procesan (se omiten durante la ejecucion)
- Las filas del nuevo dataset tienen prioridad
Importante: El reemplazo solo afecta a filas que aun no han sido procesadas. Las filas completadas o en progreso no se reemplazan.
Gestionando Multiples Oleadas
Para campanas con multiples oleadas de alcance:
- Sube nuevos datasets para cada oleada
- Las filas del dataset anterior se reemplazan automaticamente si hay superposicion de telefonos
- Usa identificadores unicos para rastrear que oleada alcanzo a cada contacto