triggerType. Quando ocorre um evento compatível (ou o agendamento dispara, ou a API executa o workflow), o motor inicia uma execução com event.data preenchido a partir dessa fonte.
Fonte da verdade: os tipos de trigger estão no schema de automações (
VALID_TRIGGER_TYPES). A UI lista os mesmos valores com rótulos e filtros no Workflow Builder.Catálogo de gatilhos
triggerType | Significado de negócio | Filtros típicos (triggerConfig) |
|---|---|---|
alert_created | Um alerta foi criado para uma entidade. | Opcional: severities, categories, delaySeconds (atraso antes de executar, com teto usual). |
investigation_created | Um caso/investigação foi aberto. | — |
investigation_status_changed | O status da investigação mudou. | — |
investigation_updated | A investigação foi atualizada (ex.: alertas consolidados). | — |
entity_created | Uma pessoa ou empresa foi criada. | entityTypes, countryCodes, opcional automaticFlow (fluxo automático por tax ID onde aplicável). |
create_entity_flow | Onboarding guiado por workflowId (não é um “evento ao vivo” como os demais). | entityTypes, countryCodes, flags opcionais de re-enriquecimento. Invocado via runAutomationById a partir do fluxo de criação. |
transaction_created | Uma transação foi criada ou atualizada de forma a emitir o evento. | — |
rule_triggered | Uma regra AML deu match e escolheu iniciar esta automação (veja Regras e workflows). | — |
kyc_approved | Validação KYC concluída com aprovação. | — |
kyc_rejected | Validação KYC concluída com rejeição. | — |
kyc_validation_finished | Validação KYC concluída (aprovada ou rejeitada). | — |
manual_execution | Alguém chama POST /automations/:id/run com payload. | — |
scheduled | O scheduler executa a automação conforme a cadência. | frequency, hour, minute, timezone, dayOfWeek, dayOfMonth, opcional intervalMinutes no produto. |
Quem emite cada gatilho
- Eventos reativos (alerta, investigação, entidade, transação, KYC): os serviços correspondentes emitem o evento ao motor (
processEvent). rule_triggered: evento sintético quando uma ação de regra executa a automação.manual_execution: apenas ao chamarruncom automação cujo gatilho é manual.scheduled: processo scheduler de automações.create_entity_flow: fluxo de criação / onboarding que chamarunAutomationByIdcom oworkflowIdcorreto.
Contextos de condição por gatilho
O produto só mostra campos de condição coerentes com o gatilho. Cada gatilho mapeia para contextos permitidos (transação, investigação, alerta, entidade, KYC, regra):| Gatilho | Contextos com dados (típico) |
|---|---|
rule_triggered | Regra, transação, entidade, alerta, KYC |
alert_created | Alerta, entidade |
investigation_created | Investigação, entidade |
investigation_status_changed | Investigação, entidade |
investigation_updated | Investigação, entidade |
entity_created | Entidade, KYC |
create_entity_flow | Entidade, KYC |
transaction_created | Transação, entidade |
kyc_approved | Entidade, KYC |
kyc_rejected | Entidade, KYC |
kyc_validation_finished | Entidade, KYC |
manual_execution | Transação, investigação, alerta, entidade, KYC (conforme payload) |
scheduled | Entidade (payload costuma ser restrito) |
Notas
- Automações desativadas ou arquivadas não executam.
- KYC: pode haver sobreposição entre
kyc_approved/kyc_rejected/kyc_validation_finished; desenhe fluxos para não duplicar lógica salvo intenção.
Manutenção: ao adicionar um gatilho no produto, atualize esta página e as tabelas em Sinergia.