Editar Flujo

Editar un Flujo

El editor visual de Floogos permite modificar cualquier flujo existente: agregar, mover o eliminar nodos, cambiar conexiones y ajustar configuraciones.

Acceder al editor

1. Ve a la seccion Flujos en el menu lateral
2. Haz clic sobre el flujo que quieres editar
3. Se abre el editor visual con todos los nodos del flujo

Operaciones basicas

Agregar nodos

• Arrastra un nodo desde el panel izquierdo al canvas
• O haz clic derecho en el canvas para ver el menu de nodos

Mover nodos

• Arrastra cualquier nodo para reposicionarlo en el canvas
• Los nodos mantienen sus conexiones al moverlos

Eliminar nodos

• Selecciona el nodo y presiona Delete/Suprimir
• O haz clic derecho sobre el nodo y selecciona Eliminar
• Las conexiones del nodo eliminado se desconectan automaticamente

Modificar conexiones

• Para crear una conexion: arrastra desde el punto de salida de un nodo al punto de entrada de otro
• Para eliminar una conexion: haz clic sobre la linea de conexion y presiona Delete
• Para cambiar una conexion: elimina la existente y crea la nueva

Configurar un nodo

1. Haz doble clic sobre el nodo
2. Se abre el panel de configuracion a la derecha
3. Modifica los campos necesarios
4. Los cambios se aplican al cerrar el panel

Editar con ayuda de FlooIA

Analizar errores de un nodo

Cuando un nodo falla durante la ejecucion, FlooIA puede ayudarte a entender y resolver el problema:

1. Haz doble clic en el nodo que fallo
2. Ve a la pestana Trace para ver el error
3. Haz clic en “Analizar con IA”
4. FlooIA te mostrara:
   • Causa del error
   • Explicacion detallada de por que ocurrio
   • Solucion paso a paso
   • Configuracion corregida (si aplica, con boton para aplicar directamente)
   • Tips de prevencion para evitar el error en el futuro

Chat contextual

Puedes abrir el chat de FlooIA mientras editas para hacer preguntas sobre el flujo:

1. Haz clic en el boton IA del toolbar y activa “Floo AI”
2. Se abre un panel de chat a la derecha
3. FlooIA conoce el contexto de tu flujo actual (nodos, conexiones, errores)

Ejemplos de preguntas utiles:

Pregunta	Lo que FlooIA responde
”Por que falla el nodo Decision?”	Analiza la condicion y los datos de entrada
”Como puedo filtrar solo pedidos de Portugal?”	Sugiere configuracion del nodo Decision
”Que nodo necesito para enviar un email?”	Recomienda Postmark, Email o SMTP segun tu caso
”Como guardo el resultado en un CSV?”	Explica como configurar CSV Create

Optimizar un flujo existente

FlooIA puede analizar tu flujo completo y sugerir mejoras:

1. Abre el menu IA del toolbar
2. FlooIA revisara la estructura del flujo
3. Te indicara posibles mejoras: nodos innecesarios, rutas de error faltantes, optimizaciones de rendimiento

Copiar y pegar nodos entre workflows

Agrupar nodos

El editor permite agrupar nodos relacionados dentro de un contenedor de color con titulo y descripcion opcional. Los grupos son puramente visuales: no afectan la ejecucion del workflow.

Crear un grupo

Opcion A — barra de seleccion multiple:

1. Selecciona dos o mas nodos (Shift+Clic o arrastra una region)
2. Haz clic en Agrupar en la barra de acciones que aparece en la parte inferior de la pantalla
3. Un contenedor envuelve la seleccion automaticamente con 52 px de margen en cada lado

Opcion B — menu contextual:

1. Haz clic derecho sobre cualquier nodo seleccionado mientras hay dos o mas nodos seleccionados
2. Elige Agrupar seleccion

Que hace un grupo

• El contenedor mueve todos los nodos hijos juntos al arrastrarlo
• Los nodos hijos no pueden salir del grupo mientras lo arrastras
• Agregar un nodo desde el panel lateral: arrastralo y sueltalo dentro del area del grupo — el nodo se asigna automaticamente al grupo
• Agregar un nodo desde un handle (+): al conectar desde un nodo que ya pertenece a un grupo, el nuevo nodo se coloca dentro del mismo grupo

Editar el grupo

Accion	Como
Renombrar	Haz clic directamente sobre el texto del titulo dentro del contenedor
Agregar descripcion	Haz clic en el area de descripcion debajo del titulo
Cambiar color	Selecciona el grupo → haz clic en el icono de paleta de colores (esquina superior derecha)
Redimensionar	Arrastra cualquier esquina o borde del contenedor
Desagrupar	Clic derecho en el grupo → Desagrupar, o haz clic en el icono de papelera mientras el grupo esta seleccionado

El nombre y la descripcion tambien estan disponibles en el panel de configuracion de la derecha — haz doble clic en el grupo para abrirlo.

Grupos y ejecucion

Los grupos se excluyen del motor de ejecucion. El workflow_json enviado al motor solo contiene nodos ejecutables; los contenedores de grupo se eliminan automaticamente. Las conexiones entre nodos dentro de un grupo funcionan igual que entre cualquier otro par de nodos.

---

El editor permite copiar uno o varios nodos seleccionados y pegarlos en cualquier otro workflow, incluidos workflows de clientes distintos que compartan el mismo navegador. El portapapeles persiste en localStorage hasta que copies algo nuevo.

Seleccionar nodos

Accion	Como hacerlo
Seleccionar un nodo	Clic sobre el nodo
Seleccionar varios nodos	Shift + Clic sobre cada nodo adicional
Seleccionar region	Arrastra el cursor sobre un area vacia del canvas
Seleccionar todos	Ctrl + A
Deseleccionar	Clic en un area vacia del canvas

Copiar nodos — Ctrl + C

1. Selecciona uno o varios nodos
2. Pulsa Ctrl + C (o haz clic en el boton Copiar de la barra de herramientas)
3. Aparece un aviso: “N nodo(s) copiado(s)”

Que se guarda en el portapapeles:

• La configuracion completa de cada nodo (tipo, label, campos)
• Las conexiones internas entre los nodos seleccionados (las conexiones hacia nodos no seleccionados se descartan)

Pegar nodos — Ctrl + V

1. Abre el workflow de destino (puede ser el mismo u otro workflow)
2. Pulsa Ctrl + V
3. Los nodos se pegan desplazados 40px respecto a su posicion original, seleccionados y listos para mover
4. Las conexiones internas entre los nodos copiados se restauran con nuevos IDs

El portapapeles persiste entre workflows: puedes copiar en un workflow, navegar a otro y pegar. Los nodos pegados tienen nuevos IDs para no colisionar con los existentes.

Duplicar nodos en el mismo workflow — Ctrl + D

Para duplicar sin pasar por el portapapeles:

1. Selecciona los nodos que quieres duplicar
2. Pulsa Ctrl + D
3. Se crea una copia desplazada inmediatamente en el mismo canvas

Atajos de teclado del editor

Atajo	Accion
Ctrl + C	Copiar nodos seleccionados al portapapeles
Ctrl + V	Pegar nodos del portapapeles
Ctrl + D	Duplicar nodos seleccionados
Ctrl + Z	Deshacer
Ctrl + Y / Ctrl + Shift + Z	Rehacer
Ctrl + S	Guardar workflow
Ctrl + A	Seleccionar todos los nodos
Ctrl + Shift + L	Ver ultima ejecucion
Delete / Supr	Eliminar nodos o conexiones seleccionados

Flujo tipico: reutilizar logica entre workflows

Workflow A (procesamiento de pedidos)
  → Selecciona los nodos de validacion (Decision + HTTP + SendMail)
  → Ctrl + C

Workflow B (procesamiento de devoluciones)
  → Ctrl + V
  → Reposiciona y reconecta segun la nueva logica

Consejo: antes de pegar, guarda el workflow destino para evitar conflictos si el navegador se cierra inesperadamente.

Operaciones avanzadas

Clonar un flujo

Si necesitas una variante de un flujo existente:

1. En la lista de flujos, haz clic en el menu (tres puntos) del flujo
2. Selecciona Clonar
3. Se crea una copia editable con un nuevo nombre

Trabajar con variables dinamicas

Dentro de cualquier campo de configuracion puedes usar:

Sintaxis	Descripcion	Ejemplo
{{campo}}	Campo del data actual	{{email}}
{{campo.subcampo}}	Campo anidado	{{billing_address.name}}
{{@NombreNodo.campo}}	Dato de un nodo especifico	{{@Webhook_1.order_id}}
{{#1.campo}}	Dato del nodo anterior (1 atras)	{{#1.total}}
{{var.nombre}}	Variable de memoria	{{var.contador}}
{{$guid}}	UUID unico	a1b2c3d4-...
{{$timestamp}}	Timestamp actual en ms	1712345678000
{{$datetime}}	Fecha ISO actual	2026-04-07T10:30:00Z

Ver el historial de ejecuciones

Desde el editor, haz clic en el icono de Historial para ver las ejecuciones anteriores del flujo. Puedes inspeccionar los datos de entrada y salida de cada nodo en cada ejecucion.

Precauciones

• Flujo activo: si el flujo esta activo y recibe datos mientras lo editas, las ejecuciones en curso usan la version guardada. Tus cambios no afectan hasta que guardes.
• Desactivar antes de cambios grandes: si vas a reorganizar nodos o cambiar logica, desactiva primero el flujo para evitar ejecuciones con configuracion incompleta.
• Credenciales: al agregar nodos que requieren credenciales (APIs, bases de datos), asegurate de configurarlas antes de probar.
• Guardar frecuentemente: no hay autoguardado. Usa Ctrl+S o el boton de guardar.

Recomendaciones

• Prueba despues de cada cambio importante usando el modo Test
• Nombra los nodos de forma descriptiva para que el equipo entienda el flujo
• Agrega nodos Decision para manejar errores en nodos criticos (APIs externas, bases de datos)
• Usa el trace para inspeccionar que datos pasan entre nodos
• No elimines nodos activos sin verificar que no rompen otras conexiones del flujo

Siguiente paso

Cuando termines de editar, consulta Ejecutar un Flujo para probar y activar tus cambios.