Las automatizaciones ejecutan acciones (el ENTONCES). Cada acción tiene un type (abajo) y un objeto config. El motor valida el tipo y aplica las reglas de sinergia con Disparadores y Sinergia.
Lista canónica: AUTOMATION_ACTION_TYPES (19 tipos). Cualquier otra cadena no es acción de primera clase del motor.
Catálogo de acciones
Inteligencia e investigaciones
| ID de acción | Qué hace |
|---|
create_investigation | Abre una investigación sobre la entidad; puede usar contexto de alerta si existe. |
generate_checklist | Genera checklist sobre una investigación existente. |
start_investigation | Pasa la investigación a trabajo activo. |
change_status | Cambia el estado de la investigación. |
change_priority | Cambia la prioridad. |
assign_to | Asigna la investigación. |
set_stage_role_access | Restringe etapa por rol. |
add_note | Agrega una nota a la investigación. |
Riesgo, entidad, enriquecimiento
| ID de acción | Qué hace |
|---|
run_basic_enrichment | Enriquecimiento básico según entidad/país. |
run_enrichment | Enriquecimiento completo (proveedores configurados). |
run_shareholders_flow | Flujo de accionistas / estructura societaria. |
run_risk_matrix | Recalcula riesgo; actualiza scores y riskMatrix en contexto. |
set_entity_status | Actualiza estado comercial/compliance de la entidad. |
Alertas y transacciones
| ID de acción | Qué hace |
|---|
create_alert | Crea una alerta de sistema sobre la entidad. |
request_transaction_approval | Envía flujo de aprobación (email/SMS/link u OTP) para la transacción. |
set_transaction_status | Actualiza estado de la transacción (transiciones válidas según el motor). |
KYC
| ID de acción | Qué hace |
|---|
create_kyc_validation | Inicia validación KYC para persona cuando aplica; puede omitirse si el tipo de entidad no corresponde. |
Integraciones y mensajería
| ID de acción | Qué hace |
|---|
send_webhook | HTTP a una URL con JSON (reintentos ante fallos transitorios). |
send_push_notification | Canales configurados (email, SMS, WhatsApp, Slack, Telegram, etc.); plantillas pueden incluir continueUrl / cancelUrl con standby. |
Contexto: entrada y salida (resumen)
Los objetos anidados entity, transaction, investigation, kyc, alert siguen la misma forma que las tablas para plantillas {{entity.status}}, {{transaction.amount}}, etc.
| Acción | Requiere en contexto (mínimo) | Aporta / actualiza en event.data |
|---|
create_investigation | entityId / targetEntityId; opcional alerta/categoría | investigationId, investigation |
generate_checklist, start_investigation, change_status, change_priority, assign_to, set_stage_role_access, add_note | investigationId | Investigación actualizada en contexto |
create_alert | entityId / targetEntityId, tipo entidad | — (efectos en BD) |
run_basic_enrichment | entityId, entityType, countryCode | enrichment |
run_enrichment, run_shareholders_flow | entityId / targetEntityId | enrichment |
run_risk_matrix | entityId, entityType | newScore, riskScore, riskScoreRaw, riskMatrix, scores en entidad |
set_entity_status | entityId / targetEntityId | Estado, previousStatus / entity.oldStatus |
set_transaction_status | Contexto de transacción | transaction.status |
create_kyc_validation | entityId, entityType (persona) | kycValidationId, kyc |
request_transaction_approval | Contexto de transacción | Tokens de aprobación externos (no es un resumeExecution genérico) |
send_webhook | — | — |
send_push_notification | Según destinatario | Puede inyectar continueUrl / cancelUrl con executionId + callbackToken |
create_kyc_validation omitido puede detener el flujo.
Mantenimiento: cambios en acciones → automation-engine, AUTOMATION_ACTION_TYPES, workflow-synergy.ts y esta página. 
