Skip to main content
O produto aplica sinergia para manter as automações válidas:
  1. Gatilho → ação: se uma ação está em ALLOWED_TRIGGERS_BY_ACTION, apenas esses gatilhos podem usá-la.
  2. Ação → próxima ação: se uma ação está em ALLOWED_NEXT_ACTIONS, apenas as ações listadas podem vir imediatamente depois na sequência ordenada (passos ou percurso do grafo).
Se uma ação não aparece nesses mapas (ou não há entrada), o padrão é permissivo: qualquer gatilho e quase qualquer próxima ação.
Fonte da verdade: packages/shared/src/workflow-synergy.ts (ALLOWED_TRIGGERS_BY_ACTION, ALLOWED_NEXT_ACTIONS). A API e a UI usam a mesma validação.

​
Regra 1 — Gatilhos permitidos por ação

Padrão permissivo: send_webhook, send_push_notification, create_alert e qualquer ação não listada aceitam qualquer gatilho. Nota: scheduled não está na lista de set_entity_status, run_risk_matrix, run_enrichment, create_kyc_validation, etc. Desenhe automações agendadas só com ações permitidas para scheduled.

​
Regra 2 — Próxima ação imediata

Apenas o par imediato é validado. Em grafos, o motor ordena as ações (ex.: BFS a partir do gatilho) e valida os mesmos pares. Padrão permissivo: se uma ação não está na tabela, pode seguir qualquer ação.

​
Cadeias típicas (exemplos)

  • Onboarding: run_enrichment → run_risk_matrix → set_entity_status → create_alert / create_kyc_validation.
  • Alerta: create_investigation → assign_to → change_status → send_webhook.
  • Pagamentos: request_transaction_approval → set_transaction_status → send_webhook.
Erros ao salvar costumam indicar gatilho ↔ ação ou ação → próxima inválidos.
Manutenção: mudanças de sinergia no código → primeiro workflow-synergy.ts, depois esta página.