triggerType. Cuando ocurre un evento compatible (o salta un schedule, o llamás a la API), el motor inicia una ejecución con event.data cargado desde esa fuente.
Fuente de verdad: los tipos de trigger están en el esquema de automatizaciones (
VALID_TRIGGER_TYPES). La UI lista los mismos valores con etiquetas y filtros en el Workflow Builder.Catálogo de disparadores
triggerType | Significado de negocio | Filtros típicos (triggerConfig) |
|---|---|---|
alert_created | Se creó una alerta asociada a una entidad. | Opcional: severities, categories, delaySeconds (retraso antes de ejecutar, con tope habitual). |
investigation_created | Se abrió una investigación / caso. | — |
investigation_status_changed | Cambió el estado de la investigación. | — |
investigation_updated | Se actualizó la investigación (p. ej. alertas consolidadas). | — |
entity_created | Se creó una persona o empresa. | entityTypes, countryCodes, opcional automaticFlow (flujo automático por tax ID donde aplique). |
create_entity_flow | Onboarding guiado por workflowId (no es un “evento en vivo” como los demás). | entityTypes, countryCodes, flags opcionales de re-enriquecimiento. Se invoca con runAutomationById desde el flujo de alta. |
transaction_created | Se creó o actualizó una transacción que emite el evento. | — |
rule_triggered | Una regla AML hizo match y eligió iniciar esta automatización (véase Reglas y workflows). | — |
kyc_approved | La validación KYC terminó aprobada. | — |
kyc_rejected | La validación KYC terminó rechazada. | — |
kyc_validation_finished | La validación KYC terminó (aprobada o rechazada). | — |
manual_execution | Alguien llama POST /automations/:id/run con un payload. | — |
scheduled | El scheduler ejecuta la automatización según cadencia. | frequency, hour, minute, timezone, dayOfWeek, dayOfMonth, opcional intervalMinutes en el producto. |
Quién emite cada trigger
- Eventos reactivos (alerta, investigación, entidad, transacción, KYC): los servicios correspondientes emiten el evento al motor (
processEvent). rule_triggered: evento sintético cuando una acción de regla ejecuta la automatización.manual_execution: solo al llamarruncon automatización cuyo trigger es manual.scheduled: el proceso scheduler de automatizaciones.create_entity_flow: flujo de alta / onboarding que llamarunAutomationByIdcon elworkflowIdcorrecto.
Contextos de condición por disparador
El producto solo muestra campos de condición coherentes con el trigger. Cada trigger se mapea a contextos permitidos (transacción, investigación, alerta, entidad, KYC, regla):| Disparador | Contextos con datos (típico) |
|---|---|
rule_triggered | Regla, transacción, entidad, alerta, KYC |
alert_created | Alerta, entidad |
investigation_created | Investigación, entidad |
investigation_status_changed | Investigación, entidad |
investigation_updated | Investigación, entidad |
entity_created | Entidad, KYC |
create_entity_flow | Entidad, KYC |
transaction_created | Transacción, entidad |
kyc_approved | Entidad, KYC |
kyc_rejected | Entidad, KYC |
kyc_validation_finished | Entidad, KYC |
manual_execution | Transacción, investigación, alerta, entidad, KYC (según payload) |
scheduled | Entidad (payload suele ser acotado) |
Notas
- Las automatizaciones deshabilitadas o archivadas no se ejecutan.
- KYC: puede haber solapamiento entre
kyc_approved/kyc_rejected/kyc_validation_finished; diseñá flujos para no duplicar lógica salvo que sea intencional.
Mantenimiento: al agregar un trigger en producto, actualizar esta página y las tablas de Sinergia.