Flow Builder

El Flow Builder es el editor visual para crear y modificar automatizaciones y flujos conversacionales.

Vista General

FLOW BUILDER - Mi Automatizacion

Botones de accion: [Guardar] [Ejecutar]

Componentes del Editor

Palette (Paleta)

La paleta contiene todos los nodos disponibles:

TRIGGERS

• Evento: Dispara por evento del sistema
• Programado: Dispara por horario
• Webhook: Dispara por llamada externa

MENSAJERIA

• Enviar Email
• Enviar SMS
• Enviar WhatsApp
• Enviar Notificacion
• Mensaje In-App

TAREAS

• Crear Tarea
• Mover Etapa
• Asignar Usuario
• Agregar a Proceso
• Actualizar Estado

DOCUMENTOS

• Solicitar Documento
• Validar Documento
• Solicitar Firma
• Crear Onboarding

CALENDARIO

• Crear Evento
• Verificar Disponibilidad
• Agendar Entrevista
• Enviar Recordatorio

IA

• Analizar CV
• Calcular Match
• Generar Respuesta
• Analizar Sentimiento
• Buscar RAG

CONTROL

• Condicion (If/Else)
• Switch
• Delay
• Loop
• Parallel
• Stop

Canvas (Lienzo)

El canvas es donde se construye el flujo:

Acciones:

• Arrastrar nodos desde palette
• Conectar nodos con lineas
• Mover y reorganizar
• Zoom in/out
• Pan (mover vista)
• Seleccionar multiples

Atajos:

• Ctrl+C: Copiar nodo
• Ctrl+V: Pegar nodo
• Del: Eliminar seleccion
• Ctrl+Z: Deshacer
• Ctrl+S: Guardar
• Space+Drag: Pan

Panel de Propiedades

Al seleccionar un nodo, aparece su configuracion:

PROPIEDADES: Enviar Email

Variables:

• name: {{postulant.name}}
• job: {{job.title}}

Avanzado:

• CC: (vacio)
• Delay: 0 minutos
• Reintentos: 3

Crear un Flujo

Paso 1: Agregar Trigger

1. Arrastrar "Evento" al canvas
2. Configurar:
   • Tipo: APPLICATION_CREATED
   • Filtros: (opcional)

El trigger es siempre el primer nodo.

Paso 2: Agregar Acciones

1. Arrastrar acciones deseadas
2. Conectar desde trigger a primera accion
3. Conectar entre acciones en secuencia

Conexion:

• Click en puerto de salida (circulo)
• Arrastrar hasta puerto de entrada
• Soltar para conectar

Paso 3: Agregar Control de Flujo

Para logica condicional:

1. Arrastrar "Condicion"
2. Configurar expresion
3. Conectar rama "Si" (verde)
4. Conectar rama "No" (rojo)
5. Opcionalmente: merge al final

Paso 4: Configurar Nodos

Por cada nodo:

1. Click para seleccionar
2. Configurar en panel de propiedades
3. Usar variables {{}} para datos dinamicos
4. Probar con "Preview"

Tipos de Conexiones

Secuencial

Nodo A -> Nodo B -> Nodo C

Ejecuta A, luego B, luego C.

Condicional

              SI -> [Nodo B]
[Condicion] -|
              NO -> [Nodo C]

Ejecuta B si condicion es verdadera, sino C.

Paralelo

           -> [Nodo B] ->
[Parallel]-|             |->[Merge]
           -> [Nodo C] ->

Ejecuta B y C simultaneamente, luego continua.

Loop

[Loop] -> [Accion] -|
  ^                 |
  |-----------------|

Repite Accion para cada elemento.

Nodos de Trigger

Trigger de Evento

TRIGGER: Evento

Opciones:

• Ejecutar solo una vez por entidad

Trigger Programado

TRIGGER: Programado

Alternativas de frecuencia:

• Hora especifica: 09:00
• Cron personalizado: (expresion cron)

Nodos de Control

Condicion (If/Else)

CONTROL: Condicion

Puertos de salida:

• SI (verde): Cuando es verdadero
• NO (rojo): Cuando es falso

Opcion: [+ Agregar "Else If"]

Switch

CONTROL: Switch

Casos:

• "linkedin" -> Puerto 1
• "referral" -> Puerto 2
• "career_page" -> Puerto 3
• default -> Puerto 4

Delay

CONTROL: Delay

Alternativas:

• Hasta fecha: {{event.date}}
• Horas laborales: 4 horas

Opciones:

• Solo dias habiles

Loop

CONTROL: Loop

Opciones:

• Ejecutar en paralelo

Herramientas del Editor

Toolbar

Botones disponibles:

• [Guardar] [Deshacer] [Rehacer]
• [Zoom +] [Zoom -] [Fit]
• [Ejecutar]

Minimap

Mapa miniatura en esquina inferior derecha:

• Muestra vista actual
• Muestra flujo completo
• Click para navegar rapidamente

Buscar

Ctrl+F para buscar:

Resultados:

• Nodo "Enviar Email" (linea 3)
• Nodo "Email de rechazo" (linea 7)

Validacion y Errores

Validacion Automatica

El editor valida automaticamente:

• Trigger presente
• Todas las conexiones completas
• Nodos configurados correctamente
• No hay ciclos infinitos
• Variables existen

Mensajes de Error

Errores de Validacion:

• Error: Nodo "Email" sin conexion de entrada
• Error: Variable {{usuario.nombre}} no existe
• Advertencia: Delay muy largo (7 dias)

Acciones: [Ir al error] [Ignorar advertencias]

Probar el Flujo

Modo Debug

1. Click en [Debug]
2. Proporcionar datos de prueba
3. Ver ejecucion paso a paso
4. Inspeccionar valores en cada nodo
5. Verificar resultado final

Panel de Debug

DEBUG MODE

Datos de prueba:

• postulant.name: "Juan Perez"
• postulant.email: "juan@test.com"
• matchScore: 85

Ejecucion:

• [OK] Trigger
• [OK] Condicion (score>=80) -> true
• [Ejecutando...] Email
• [Pendiente] Crear Tarea

Controles: [Pausar] [Siguiente] [Continuar]

Exportar e Importar

Exportar Flujo

Click en [...] -> Exportar

Formatos:

• JSON: Para backup o migracion
• Imagen: PNG del diagrama
• PDF: Documentacion

El JSON incluye:

• Configuracion de nodos
• Conexiones
• Variables
• Metadata

Importar Flujo

Click en [...] -> Importar

1. Seleccionar archivo JSON
2. Revisar preview
3. Resolver conflictos si existen
4. Confirmar importacion

Buenas Practicas

Organizacion

DO:

• Nombres descriptivos para nodos
• Agrupar nodos relacionados
• Usar comentarios
• Flujos de izquierda a derecha
• Conexiones claras

DON'T:

• Nodos sin nombre
• Conexiones cruzadas excesivas
• Flujos muy complejos (dividir)
• Variables sin documentar
• Falta de manejo de errores

Performance

Optimizar:

• Usar paralelo cuando posible
• Evitar loops muy grandes
• Minimizar llamadas externas
• Cache de datos repetidos
• Limitar profundidad de anidacion

Proximos Pasos

• Variables y Placeholders - Datos dinamicos
• Ejecucion y Monitoreo - Ver logs
• Ejemplos Practicos - Casos de uso