Documentación en Desarrollo
Esta guía está actualmente en desarrollo. El contenido puede estar incompleto o sujeto a cambios.
Referencia de Pasos de Flujo
Referencia completa para todos los tipos de pasos de flujo disponibles. Aprende como configurar cada paso para construir poderosos flujos de trabajo multicanal.
Categorias de Pasos
Pasos de Control de Flujo
Los pasos de control de flujo gestionan la ruta de ejecucion de tu flujo de trabajo, incluyendo ramificacion, bucles y tiempos.
Inicio
Punto de entrada del flujo. Todo flujo comienza con un paso de Inicio.
Configuracion:
- Tipo de disparador (manual, programado, entrante)
Fin
Punto de salida del flujo. Marca la finalizacion exitosa.
Configuracion:
- Estado final (completado, fallido)
Condicion
Ramificacion condicional basada en expresiones. Dirige a diferentes caminos segun los datos.
Configuracion:
- Expresion de condicion
- Ramas Verdadero/Falso
- Multiples condiciones (else-if)
ParaCadaFila
Iterar a traves de las filas del dataset. Ejecuta pasos hijos para cada fila.
Configuracion:
- Tamano de lote
- Retraso entre filas
- Manejo de errores
RamaRespuesta
Ramificar segun el contenido de la respuesta del usuario. Incluye coincidencia de auto-respuesta.
Configuracion:
- Condiciones de rama
- Patrones de auto-respuesta
- Rama por defecto
- Manejo de timeout
Retraso
Esperar una duracion especificada antes de continuar.
Configuracion:
- Duracion (segundos, minutos, horas)
- Opcion solo horario laboral
Paralelo
Ejecutar multiples ramas simultaneamente.
Configuracion:
- Ramas paralelas
- Esperar todas vs. esperar cualquiera
Ejemplo de Paso Condicion
// Ejemplos de expresiones de condicion row.balance > 100000 // Comparacion numerica row.status == "active" // Igualdad de cadena row.email != null // Verificacion de nulo row.score >= 80 && row.verified // Condiciones combinadas
Paso RamaRespuesta
El paso RamaRespuesta es poderoso para manejar respuestas de usuarios. Configura:
- Patrones de rama: Palabras clave o frases que activan cada rama
- Auto-respuestas: Respuestas rapidas (1, 2, 3 o A, B, C)
- Coincidencia IA: Usar IA para entender intencion, no solo palabras clave
- Rama por defecto: Manejar respuestas no coincidentes
- Timeout: Que sucede si no se recibe respuesta
Pasos de Mensajeria
Envia y recibe mensajes via WhatsApp Business API.
EnviarMensaje
Enviar un mensaje de texto personalizado via WhatsApp.
Configuracion:
- Texto del mensaje
- Variables {{campo}}
- Seleccion de canal
EnviarPlantilla
Enviar un mensaje de plantilla WhatsApp pre-aprobado.
Configuracion:
- Seleccion de plantilla
- Variables de plantilla
- Media de encabezado (opcional)
EnviarMedia
Enviar imagenes, videos o documentos via WhatsApp.
Configuracion:
- Tipo de media
- URL de archivo o subida
- Titulo (opcional)
EsperarRespuesta
Esperar a que el cliente responda via WhatsApp.
Configuracion:
- Duracion de timeout
- Accion de timeout
- Almacenar respuesta en variable
Configuracion de EnviarMensaje
Usa variables para personalizar mensajes:
Hola {{nombre}}!
Tu cita esta programada para {{fecha_cita}}.
Responde con:
1 - Confirmar
2 - Reagendar
3 - CancelarPaso EnviarPlantilla
Importante: Para el primer contacto con nuevos clientes, debes usar EnviarPlantilla con una plantilla de WhatsApp pre-aprobada. Los mensajes personalizados solo pueden enviarse dentro de una ventana de conversación de 24 horas.
Paso EsperarRespuesta
Pasos de Voz
Realiza y recibe llamadas de voz con IA con capacidades de conversación natural.
LlamadaVoz
Iniciar una llamada de voz saliente con IA.
Configuracion:
- Prompt del sistema (instrucciones de IA)
- Seleccion de voz
- Mensaje de saludo
- Grabacion habilitada
- Duracion maxima
- Acciones de voz
EsperarLlamadaEntrante
Esperar una llamada entrante en DID asignado.
Configuracion:
- DID/Canal
- Timeout
- Reglas de enrutamiento
TransferenciaVoz
Transferir llamada activa a agente, cola o numero externo.
Configuracion:
- Tipo de destino
- Destino (cola/numero)
- Anuncio
- Headers de contexto
ColgarVoz
Finalizar la llamada de voz activa.
Configuracion:
- Mensaje final (opcional)
- Razon de colgar
EsperarResultadoVoz
Esperar a que la llamada de voz complete y capturar resultado.
Configuracion:
- Variable de resultado
- Manejo de timeout
Configuracion de LlamadaVoz
Prompt del Sistema
El prompt del sistema define el comportamiento, personalidad y objetivos del agente de IA:
Eres un representante de servicio al cliente amigable de Acme Corp.
Tu objetivo es confirmar la cita del cliente.
Informacion del Cliente:
- Nombre: {{nombre}}
- Cita: {{fecha_cita}}
Lineamientos:
- Se amable y profesional
- Si quieren reagendar, ofrece horarios disponibles
- Si cancelan, pregunta el motivo
- Manten la llamada bajo 2 minutosSeleccion de Voz
Voces disponibles de OpenAI:
Acciones de Voz
Configura acciones que la IA puede tomar durante la llamada.Aprende mas sobre acciones de voz →
Pasos de IA
Aprovecha la IA para clasificar, extraer y generar contenido dentro de tus flujos.
ClasificacionIA
Categorizar texto o respuestas usando IA.
Configuracion:
- Lista de categorias
- Texto/variable de entrada
- Variable de salida
- Umbral de confianza
ExtraccionIA
Extraer datos estructurados de texto usando IA.
Configuracion:
- Campos a extraer
- Tipos de campos
- Texto de entrada
- Variables de salida
GenerarIA
Generar respuestas o contenido potenciado por IA.
Configuracion:
- Plantilla de prompt
- Variables de contexto
- Variable de salida
- Max tokens
EjecucionAgente
Ejecutar un agente de IA configurado con herramientas y memoria.
Configuracion:
- Seleccion de agente
- Contexto de entrada
- Herramientas disponibles
- Max iteraciones
Ejemplo de ClasificacionIA
Configura las categorias que la IA usara para clasificar respuestas:
Categorias: - interesado: Cliente quiere proceder - no_interesado: Cliente rechaza - llamar_despues: Cliente quiere ser contactado despues - pregunta: Cliente tiene preguntas - reclamo: Cliente tiene un reclamo
Ejemplo de ExtraccionIA
Define campos a extraer de las respuestas de clientes:
Campos: - fecha_preferida (fecha): Cuando quieren reagendar - hora_preferida (hora): Manana, tarde, u hora especifica - motivo (cadena): Por que estan reagendando - preferencia_contacto (enum): llamada, whatsapp, email
Pasos de Datos
Manipula y almacena datos durante la ejecucion del flujo.
EnriquecerDataset
Escribir valores de vuelta a la fila actúal del dataset.
Configuracion:
- Nombre del campo
- Valor (estatico o variable)
- Agregar vs. reemplazar
EstablecerVariable
Establecer una variable de contexto para usar en pasos posteriores.
Configuracion:
- Nombre de variable
- Expresion de valor
- Alcance (fila, flujo, global)
Transformar
Mapear y transformar datos entre formatos.
Configuracion:
- Campos de entrada
- Reglas de transformacion
- Campos de salida
Paso EnriquecerDataset
Usa EnriquecerDataset para guardar resultados de vuelta al dataset para exportacion posterior:
// Ejemplos de enriquecimiento
resultado_clasificacion: {{clasificacion_ia}}
fecha_extraida: {{extraido.fecha_preferida}}
resultado_llamada: {{resultado_voz}}
estado_final: "completado"Pasos de Integracion
Conecta tus flujos a sistemas y servicios externos.
LlamadaApi
Llamar a una API REST externa.
Configuracion:
- Integracion de API
- Endpoint
- Metodo
- Parametros
- Mapeo de respuesta
LlamadaWebhook
Disparar un webhook con datos del evento.
Configuracion:
- URL de webhook
- Plantilla de payload
- Headers
- Politica de reintentos
Notificacion
Enviar notificaciones por email o SMS.
Configuracion:
- Canal (email/SMS)
- Destinatarios
- Asunto/Mensaje
- Plantilla
Configuracion de LlamadaApi
Configura llamadas API para integrarte con sistemas externos:
- Seleccionar integracion: Elige de credenciales API configuradas
- Mapear parametros: Pasa variables del flujo a parametros de API
- Mapear respuesta: Extrae datos de respuesta API a variables del flujo
- Manejo de errores: Define comportamiento en errores de API
Mejores Practicas
Siempre maneja los timeouts
Configura comportamientos de timeout para pasos EsperarRespuesta y EsperarLlamadaEntrante para evitar que las filas queden atascadas indefinidamente.
Usa EnriquecerDataset liberalmente
Guarda resultados intermedios en la fila del dataset para que puedas exportar datos completos despues de la ejecucion.
Prueba con datasets pequenos primero
Antes de ejecutar campanas grandes, prueba tu flujo con 5-10 contactos para verificar que todos los caminos funcionen correctamente.
Maneja la rama por defecto
En pasos RamaRespuesta y Condicion, siempre configura una rama por defecto/else para manejar entradas inesperadas de forma elegante.