Skip to main content
Cada automação tem exatamente um 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

​
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 chamar run com automação cujo gatilho é manual.
  • scheduled: processo scheduler de automações.
  • create_entity_flow: fluxo de criação / onboarding que chama runAutomationById com o workflowId correto.

​
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): Veja também Contexto e standby.

​
investigation_status_changed em detalhe

O evento é emitido em toda transição de status do caso, independentemente de onde tenha se originado: O evento não é emitido se o status não mudou. Uma chamada que reenvia o status atual (por exemplo CLOSED em um caso já fechado) atualiza a linha mas não dispara automações, então não gera notificações duplicadas.

​
Status e status anterior

Os status produzidos pelo fluxo são OPEN, IN_PROGRESS, PENDING_REVIEW e CLOSED (sempre em maiúsculas). Além do status novo, o contexto expõe o status anterior:
  • Condição: investigation.previousStatus (por exemplo, avisar apenas quando passa de IN_PROGRESS para PENDING_REVIEW).
  • Template: {{investigation.previousStatus}}.
Na primeira transição registrada de um caso o status anterior pode vir vazio.

​
Encadeamento

Se uma automação muda o status com change_status ou start_investigation, o evento é emitido novamente para que outras automações reajam. A automação que originou a mudança não é reexecutada com esse evento, e as cadeias param em 3 saltos.

​
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.