Ejecutar un Flujo

Ejecutar un Flujo

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

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 botón Test (icono de play en el toolbar)
3. Si el flujo empieza con un Webhook, se mostrará la URL de test para enviar datos
4. Si empieza con Schedule o Start, puedes proporcionar un JSON de prueba
5. Observa la ejecución: 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 configuración.

Interpretar los resultados del Test

Después 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. Verás:
   • Input (data): los datos que recibio el nodo
   • Output (result): los datos que retorno el nodo
   • Config: la configuración con la que se ejecuto
   • Error: mensaje de error si fallo
   • Response time: tiempo de ejecución 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 configuración del nodo
   • El mensaje de error
4. Te mostrará la causa, la solución y en muchos casos un botón para aplicar la corrección directamente

Errores comunes que FlooIA resuelve:

Error	Causa tipica	Solución
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 vacío	Verificar la estructura del data con el trace

Activar el Flujo (Producción)

Cuando el test funciona correctamente, activa el flujo para que se ejecute automáticamente.

Como activar

1. Asegurate de que todos los cambios estan guardados
2. Haz clic en el botón 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 ejecutará automáticamente según su trigger:
   • Webhook: cada vez que se reciba una petición en la URL live
   • Schedule: según la programación 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 producción
Requiere flujo activo	No	Si
Visible en historial	Si (temporal)	Si (permanente)
Recomendado para	Depuración, pruebas	Shopify, Stripe, integraciones reales

Historial de Ejecuciones

Cada ejecución (test o producción) queda registrada en el historial.

Como acceder

1. Desde el editor: haz clic en el icono Historial del toolbar
2. Desde el menú lateral: sección Historial
3. Se muestra una lista con todas las ejecuciones recientes

Que muestra el historial

Campo	Descripción
Fecha	Cuando se ejecuto
Estado	Completado, fallido, en progreso
Duración	Tiempo total de ejecución
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 ejecución para análisis offline haciendo clic en el botón de descarga.

Cola de ejecución y monitoreo en tiempo real

Cuando ejecutas un flujo, la ejecución 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 botón 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 último las ejecuciones manuales. Según 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 ejecución concreta (en curso o en cola), sin desactivar el flujo:

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

La cancelación 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 ejecución	Se corta entre nodos: el nodo actual termina, el siguiente no arranca
Ya terminada	No tiene efecto

Ten en cuenta:

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

Cancelar vs Desactivar

Cancelar detiene una ejecución 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 producción:

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 producción

• Todos los nodos tienen configuración 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 descripción del flujo son claros para el equipo
• Los webhooks de producción (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 producción 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 después de activar
• Desactiva antes de editar si vas a hacer cambios grandes en la lógica del flujo
• Usa FlooIA para diagnosticar errores rápidamente en vez de leer logs manualmente

Páginas 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