Skip to main content

Qué es un workflow

En gu1, los workflows son automatizaciones: CUANDO [ocurre algo] → SI [condiciones opcionales] → ENTONCES [acciones]. Se configuran en la app (Automatizaciones / Workflow Builder) o mediante la API (véase API Reference en el menú).
Estos workflows no son las reglas AML (motor de reglas). Las reglas tienen sus propios disparadores. Una regla puede disparar un workflow con el trigger “cuando la regla hace match”.

Guía (conceptos)

TemaDescripción
DisparadoresCada triggerType, filtros y contextos de condición.
AccionesTodas las acciones del motor y qué leen/escriben en event.data.
SinergiaQué disparadores permiten qué acciones y pares acción → siguiente acción válidos.
Contexto y standbyContexto compartido, refresco al reanudar, límites del standby, patrones KYC, URLs en plantillas.
Construir flujosGrafo vs pasos, ramas, fan-out, validación al guardar, prueba vs ejecución real.
Reglas y workflowsCómo las reglas AML invocan automatizaciones (rule_triggered).

Modos de ejecución (resumen)

ModoDescripción
GrafoFlujo visual: disparador → condiciones (ramas Sí/No) → acciones. Si hay un graph válido, el motor usa el grafo.
PasosBloques en orden; si no se cumplen las condiciones de un bloque, todo el bloque se omite.
Si existen ambos, prioriza el grafo.
  • Cableá salidas verdadero y falso del nodo condición. Si solo hay una arista, el motor la usa para ambos resultados.
  • Varias salidas desde un nodo acción: el motor ejecuta todas esas ramas en secuencia.

Standby (breve)

Pausa una misma ejecución hasta continuar o cancelar. Solo aplica cuando la corrida pasa por runAutomationById (p. ej. POST /automations/:id/run con ejecución manual, reglas, programado). Los eventos solo reactivos (processEvent) no crean ejecución persistente: la opción “espera” no pausa en ese camino. Ver Contexto y standby y la API: Continuar ejecución, Cancelar ejecución.

Crear un workflow (UI)

AutomatizacionesNueva → disparador y filtros → condiciones y acciones → guardar. El producto valida sinergia y forma del grafo (Sinergia).

Prueba vs ejecución real

  • POST .../execute — prueba con processEvent (sin standby).
  • POST .../run — con trigger manual_execution; runAutomationById; standby si aplica.

Documentación relacionada