Ações

As automações executam ações (o ENTÃO). Cada ação tem um type (abaixo) e um objeto config. O motor valida o tipo e aplica sinergia com Gatilhos e Sinergia.

Lista canônica: AUTOMATION_ACTION_TYPES (20 tipos). Qualquer outra string não é ação de primeira classe no motor.

Catálogo de ações

Inteligência e investigações

ID da ação	O que faz
`create_investigation`	Abre uma investigação sobre a entidade; pode usar contexto de alerta quando existir.
`generate_checklist`	Gera checklist em uma investigação existente.
`start_investigation`	Coloca a investigação em trabalho ativo.
`change_status`	Altera o status da investigação.
`change_priority`	Altera a prioridade.
`assign_to`	Atribui a investigação.
`assign_load_balanced`	Atribui entre um pool de usuários, equipes ou funções (`assigneePool`), minimizando carga pelo mesmo `assignedTo` + `assignedToType`; `userIds` antigo (só usuários) continua válido. `balanceScope`: `all_open` \| `same_category`.
`set_stage_role_access`	Restringe etapa por papel.
`add_note`	Adiciona nota à investigação.

Risco, entidade, enriquecimento

ID da ação	O que faz
`run_basic_enrichment`	Enriquecimento básico conforme entidade/país.
`run_enrichment`	Enriquecimento completo (provedores configurados).
`run_shareholders_flow`	Fluxo de acionistas / estrutura societária.
`run_risk_matrix`	Recalcula risco; atualiza scores e `riskMatrix` no contexto.
`set_entity_status`	Atualiza status comercial/compliance da entidade.

Alertas e transações

ID da ação	O que faz
`create_alert`	Cria alerta de sistema na entidade.
`request_transaction_approval`	Envia fluxo de aprovação (email/SMS/link ou OTP) para a transação.
`set_transaction_status`	Atualiza status da transação (transições válidas conforme o motor).

KYC

ID da ação	O que faz
`create_kyc_validation`	Inicia validação KYC para pessoa quando aplicável; pode ser omitida se o tipo de entidade não for compatível.

Integrações e mensagens

ID da ação	O que faz
`send_webhook`	HTTP para URL com JSON (retentativas em falhas transitórias).
`send_push_notification`	Canais configurados (email, SMS, WhatsApp, Slack, Telegram, etc.); templates podem incluir `continueUrl` / `cancelUrl` com standby.

Contexto: entrada e saída (resumo)

Objetos aninhados entity, transaction, investigation, kyc, alert seguem a mesma forma das tabelas para templates {{entity.status}}, {{transaction.amount}}, etc.

Ação	Precisa no contexto (mínimo)	Adiciona / atualiza em `event.data`
`create_investigation`	`entityId` / `targetEntityId`; opcional alerta/categoria	`investigationId`, `investigation`
`generate_checklist`, `start_investigation`, `change_status`, `change_priority`, `assign_to`, `set_stage_role_access`, `add_note`	`investigationId`	Investigação atualizada no contexto
`create_alert`	`entityId` / `targetEntityId`, tipo entidade	— (efeitos no 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 na entidade
`set_entity_status`	`entityId` / `targetEntityId`	Status, `previousStatus` / `entity.oldStatus`
`set_transaction_status`	Contexto de transação	`transaction.status`
`create_kyc_validation`	`entityId`, `entityType` (pessoa)	`kycValidationId`, `kyc`
`request_transaction_approval`	Contexto de transação	Tokens de aprovação externos (não é `resumeExecution` genérico)
`send_webhook`	—	—
`send_push_notification`	Conforme destinatário	Pode injetar `continueUrl` / `cancelUrl` com `executionId` + `callbackToken`

A sinergia não garante dados: uma ação pode ser omitida (ex.: KYC em tipo errado). No modo passos, um create_kyc_validation omitido pode parar o fluxo.

Manutenção: mudanças em ações → automation-engine, AUTOMATION_ACTION_TYPES, workflow-synergy.ts e esta página.

Começando

SDK

Casos de Uso

Webhooks

Workflows

Monitoramento (entidades)

Pessoa

Mensagens

Empresa

Dispositivos

Eventos

Conheça Seu Cliente (KYC)

Transações

Métodos de Pagamento

Regras

Listas de dados

Matriz de Risco

Alertas

Investigações

Ingestão de Dados

Importações em lote

Enriquecimento

Serviços

Integrações

Tutoriais Interativos

Catálogo de ações

Inteligência e investigações

Risco, entidade, enriquecimento

Alertas e transações

KYC

Integrações e mensagens

Contexto: entrada e saída (resumo)

​Catálogo de ações

​Inteligência e investigações

​Risco, entidade, enriquecimento

​Alertas e transações

​KYC

​Integrações e mensagens

​Contexto: entrada e saída (resumo)

Catálogo de ações

Inteligência e investigações

Risco, entidade, enriquecimento

Alertas e transações

KYC

Integrações e mensagens

Contexto: entrada e saída (resumo)