Acciones

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 (20 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.
`assign_load_balanced`	Asigna entre un pool de destinatarios (`assigneePool`: filas usuario, equipo o rol), minimizando carga sobre investigaciones abiertas (no cerradas/archivadas) con el mismo `assignedTo` + `assignedToType`; sigue admitiendo solo `userIds` (retrocompat). `balanceScope`: `all_open` \| `same_category`.
`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`

La sinergia no garantiza datos: una acción puede omitirse (p. ej. KYC en tipo incorrecto). En modo pasos, un create_kyc_validation omitido puede detener el flujo.

Mantenimiento: cambios en acciones → automation-engine, AUTOMATION_ACTION_TYPES, workflow-synergy.ts y esta página.

Comenzando

SDK

Casos de Uso

Webhooks

Workflows

Monitoreo (entidades)

Persona

Mensajería

Empresa

Dispositivos

Eventos

Conozca Su Cliente (KYC)

Transacciones

Métodos de Pago

Reglas

Listas personalizadas

Matriz de Riesgo

Alertas

Investigaciones

Ingesta de Datos

Importaciones masivas

Documentos

Enriquecimiento

Servicios

Integraciones

Tutoriales Interactivos

Catálogo de acciones

Inteligencia e investigaciones

Riesgo, entidad, enriquecimiento

Alertas y transacciones

KYC

Integraciones y mensajería

Contexto: entrada y salida (resumen)

​Catálogo de acciones

​Inteligencia e investigaciones

​Riesgo, entidad, enriquecimiento

​Alertas y transacciones

​KYC

​Integraciones y mensajería

​Contexto: entrada y salida (resumen)

Catálogo de acciones

Inteligencia e investigaciones

Riesgo, entidad, enriquecimiento

Alertas y transacciones

KYC

Integraciones y mensajería

Contexto: entrada y salida (resumen)