Componentes
Componentes
Entender estos componentes te ayuda a diseñar workflows más fáciles de mantener y depurar.
Workflow
El workflow es el contenedor principal. Guarda:
- nombre y descripción
- estado (
draftopublished, que en el dashboard verás comoBorradoryLive) - bloque inicial
- bloques conectados
- configuración del workflow, como alertas por falla
Puedes crear y actualizar workflows desde el dashboard de workflows. Si además necesitas integrarlo vía API, revisa Crear un workflow y Actualizar un workflow.
Trigger inicial
Todo workflow empieza con un trigger. El trigger define cuándo y con qué contexto se inicia la ejecución.
Hoy puedes iniciar workflows desde:
- un webhook público
- un evento interno de Soyio
- una solicitud de derecho (DSR) que entra en procesamiento
- una programación diaria, semanal o mensual
Si agregas un trigger más adelante dentro del flujo, ese bloque deja de funcionar como inicio y pasa a funcionar como punto de espera.
En ese caso, cuando la ejecución llega a ese bloque:
- Soyio pausa la ejecución actual
- guarda el estado del workflow en esa versión
- espera a que ese trigger vuelva a dispararse para reanudar desde ese punto
Este comportamiento es útil cuando una parte del proceso debe quedar detenida hasta recibir una nueva señal externa o interna.
Bloques
Los bloques definen lo que pasa dentro del flujo. En el editor se agrupan en cuatro categorías:
- triggers
- condiciones
- acciones
- paralelo
Cada bloque puede leer contexto, escribir resultados y decidir cuál será el siguiente paso.
Profundiza en Tipos de bloques.
Contexto y metadata
Cada ejecución mantiene un contexto que avanza con el workflow. Ese contexto puede incluir:
- datos del evento que inició el flujo
- payload del webhook
- datos de una solicitud de derecho
- respuestas de formularios
- resultados de llamadas HTTP
- variables globales resueltas
Las condiciones, templates y algunos bloques leen valores desde ese contexto.
Variables globales y secrets globales
Usa variables globales para valores reutilizables no sensibles, como correos de soporte, nombres de equipo o etiquetas operativas.
Usa secrets globales para valores sensibles que solo deben resolverse al interpolar templates, por ejemplo tokens o credenciales de terceros.
Gestiona ambos desde la configuración de workflows del dashboard. Si quieres hacerlo vía API, revisa:
Ejecuciones
Cada vez que un workflow corre, Soyio crea una ejecución con:
- estado actual
- resultados por bloque
- metadata de contexto
- historial de eventos de la ejecución
- versión del workflow usada en ese momento
Si una ejecución queda detenida esperando un formulario, un delay o un trigger intermedio, Soyio puede reanudarla después usando la versión del workflow con la que esa ejecución comenzó.
Puedes revisar ejecuciones desde la pestaña correspondiente del editor en el dashboard de workflows. Si también necesitas consumirlas vía API, revisa:
Versiones
Cuando modificas y guardas un workflow, Soyio genera una nueva versión. Esto te permite revisar cambios previos y restaurar una versión anterior si hace falta.
Puedes revisar versiones desde el editor del workflow en el dashboard de workflows. Si también necesitas esa información vía API, revisa:
Formularios pendientes
Cuando usas Solicitud de formulario, la ejecución puede quedar detenida hasta que la persona destinataria complete el formulario.
Cuando la respuesta llega:
- Soyio guarda los valores en el contexto
- la ejecución se reanuda desde el siguiente paso
Si además necesitas completar este paso vía API, revisa Enviar un formulario pendiente de workflow.
Alertas por falla
Activa alertas por falla cuando quieras recibir un correo si una ejecución falla.
Esto es útil para:
- detectar integraciones caídas
- revisar workflows críticos
- responder más rápido a errores operativos