Ejecutar un Flujo

Ejecutar un Flujo

Una vez creado y configurado tu flujo, necesitas probarlo para verificar que funciona correctamente antes de activarlo en produccion.

Modo Test (Pruebas)

El modo Test ejecuta el flujo una sola vez con datos de prueba, sin necesidad de activarlo.

Como probar

1. Abre el flujo en el editor visual
2. Haz clic en el boton Test (icono de play en el toolbar)
3. Si el flujo empieza con un Webhook, se mostrara la URL de test para enviar datos
4. Si empieza con Schedule o Start, puedes proporcionar un JSON de prueba
5. Observa la ejecucion: cada nodo se ilumina conforme se ejecuta
6. Al terminar, revisa el resultado de cada nodo haciendo doble clic y viendo la pestana Trace

Datos de prueba para Webhook

Si tu flujo usa un Webhook, puedes enviar datos de prueba de varias formas:

Desde una herramienta externa (Postman, curl):

curl -X POST https://us1.floogos.com/webhooks-dev/TU_HASH \
  -H "Content-Type: application/json" \
  -d '{"id": 123, "name": "Test Order", "total": 19.90}'

Desde Shopify u otro servicio: configura el webhook de desarrollo (URL webhooks-dev/) para recibir eventos reales en modo test.

Desde el editor: algunos nodos permiten pegar un JSON de prueba directamente en la configuracion.

Interpretar los resultados del Test

Despues de ejecutar un test, cada nodo muestra su estado:

Estado	Color	Significado
Completed	Verde	El nodo se ejecuto correctamente
Failed	Rojo	El nodo fallo - revisa el error en Trace
Skipped	Gris	El nodo fue omitido (rama de Decision no tomada)
Pending	Amarillo	El nodo esta esperando (Delay, Merge)

Inspeccionar datos de cada nodo

1. Haz doble clic en cualquier nodo ejecutado
2. Ve a la pestana Trace
3. Veras:
   • Input (data): los datos que recibio el nodo
   • Output (result): los datos que retorno el nodo
   • Config: la configuracion con la que se ejecuto
   • Error: mensaje de error si fallo
   • Response time: tiempo de ejecucion en milisegundos

Resolver errores con FlooIA

Si un nodo falla durante el test:

1. Abre el nodo fallido (doble clic)
2. En la pestana Trace, haz clic en “Analizar con IA”
3. FlooIA analizara:
   • Los datos de entrada
   • La configuracion del nodo
   • El mensaje de error
4. Te mostrara la causa, la solucion y en muchos casos un boton para aplicar la correccion directamente

Errores comunes que FlooIA resuelve:

Error	Causa tipica	Solucion
Unexpected token '{'	Variable {{}} no resuelta en Decision	Corregir la ruta del campo (ej: {{billing_address.country_code}} sin prefijo data.)
Cannot find module	Nombre de modulo con case incorrecto	El engine auto-corrige case (fix aplicado)
Credenciales no encontradas	credentials_id no configurado	Crear credencial y asignarla al nodo
Timeout	API externa tarda demasiado	Aumentar timeout o agregar retry
No hay datos validos	dataKey apunta a un campo vacio	Verificar la estructura del data con el trace

Activar el Flujo (Produccion)

Cuando el test funciona correctamente, activa el flujo para que se ejecute automaticamente.

Como activar

1. Asegurate de que todos los cambios estan guardados
2. Haz clic en el boton Activar (toggle en la cabecera del editor o desde la lista de flujos)
3. El flujo cambia a estado Online (indicador verde)
4. A partir de ahora, se ejecutara automaticamente segun su trigger:
   • Webhook: cada vez que se reciba una peticion en la URL live
   • Schedule: segun la programacion configurada
   • DataStoreTrigger: cuando se detecten cambios en el DataStore
   • FormTrigger: cuando se envie el formulario asociado

Diferencia entre URL de Test y Live

	URL Test (webhooks-dev)	URL Live (webhooks)
Cuando se usa	Durante desarrollo	En produccion
Requiere flujo activo	No	Si
Visible en historial	Si (temporal)	Si (permanente)
Recomendado para	Depuracion, pruebas	Shopify, Stripe, integraciones reales

Historial de Ejecuciones

Cada ejecucion (test o produccion) queda registrada en el historial.

Como acceder

1. Desde el editor: haz clic en el icono Historial del toolbar
2. Desde el menu lateral: seccion Historial
3. Se muestra una lista con todas las ejecuciones recientes

Que muestra el historial

Campo	Descripcion
Fecha	Cuando se ejecuto
Estado	Completado, fallido, en progreso
Duracion	Tiempo total de ejecucion
Nodos ejecutados	Cuantos nodos se procesaron
Detalle	Click para ver el trace completo de cada nodo

Exportar historial

Puedes descargar el JSON completo de una ejecucion para analisis offline haciendo clic en el boton de descarga.

Cola de ejecución y monitoreo en tiempo real

Cuando ejecutas un flujo, la ejecucion entra en una cola y el sistema la procesa en segundo plano. El editor no se bloquea: la respuesta es inmediata y sigues el progreso en vivo.

• Cada nodo se ilumina conforme se ejecuta (iniciado, completado o fallido).
• El panel Monitoreo muestra los eventos en tiempo real hasta el evento final (completado, fallido o cancelado).
• Al terminar, el boton vuelve solo a Ejecutar y el resultado queda en el Historial.

Las ejecuciones se atienden por prioridad: los webhooks y llamadas de API van primero, luego los programados (Schedule) y por ultimo las ejecuciones manuales. Segun la politica de concurrencia del flujo, varias ejecuciones del mismo flujo pueden correr a la vez, esperar su turno, o rechazarse si ya hay una en curso.

Detener una ejecución (Cancelar)

Para detener una ejecucion concreta (en curso o en cola), sin desactivar el flujo:

1. Mientras el flujo se ejecuta, aparece el boton rojo Cancelar junto a Ejecutar
2. Haz clic en Cancelar

La cancelacion es suave y su efecto depende del estado:

Estado	Que ocurre al cancelar
En cola (aun no empezo)	Se descarta: no llega a ejecutarse
En ejecucion	Se corta entre nodos: el nodo actual termina, el siguiente no arranca
Ya terminada	No tiene efecto

Ten en cuenta:

• La cancelacion no revierte lo que ya se ejecuto (mails enviados, filas escritas o pagos hechos permanecen).
• No cuenta como fallo: una ejecucion cancelada no se reintenta ni va a la cola de errores.
• Cualquier usuario de tu organizacion con acceso al flujo puede cancelar una ejecucion, incluso una lanzada por otra persona.

Cancelar vs Desactivar

Cancelar detiene una ejecucion puntual. Desactivar (abajo) impide que el flujo reciba nuevas ejecuciones, pero no afecta a las que ya estan corriendo.

Desactivar un Flujo

Para detener un flujo en produccion:

1. Ve a la lista de Flujos
2. Haz clic en el toggle de Activar/Desactivar junto al flujo
3. El flujo deja de recibir ejecuciones (los webhooks retornaran un error hasta que se reactive)

Checklist antes de activar en produccion

• Todos los nodos tienen configuracion completa (sin campos requeridos vacios)
• Las credenciales de APIs externas estan configuradas y probadas
• Las condiciones de Decision estan verificadas con datos reales
• Los nodos de error tienen una ruta alternativa (no dejar caminos sin End)
• El flujo completo se ha probado con Test al menos una vez con datos reales
• El nombre y descripcion del flujo son claros para el equipo
• Los webhooks de produccion (URL live) estan configurados en los servicios externos

Recomendaciones

• Prueba con datos reales antes de activar. Los datos de prueba inventados pueden no cubrir todos los casos
• Revisa los traces de las primeras ejecuciones en produccion para detectar problemas
• Usa Decision para errores: si un nodo externo (API, BD) puede fallar, agrega un camino alternativo
• Monitorea el historial los primeros dias despues de activar
• Desactiva antes de editar si vas a hacer cambios grandes en la logica del flujo
• Usa FlooIA para diagnosticar errores rapidamente en vez de leer logs manualmente

Paginas relacionadas

• Crear un Flujo - Como construir flujos desde cero
• Editar un Flujo - Como modificar flujos existentes
• Historial - Consultar ejecuciones pasadas
• Buenas Practicas - Patrones y recomendaciones avanzadas