> ## Documentation Index > Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt > Use this file to discover all available pages before exploring further. # Gatilhos > Todos os tipos de trigger de workflows, filtros opcionais (triggerConfig) e contexto típico do evento — no motor de automações gu1 com gatilhos e ações. 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 | `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](/pt/workflows/rules-and-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 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): | 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) | Veja também [Contexto e standby](/pt/workflows/context-and-standby). ## 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](/pt/workflows/synergy).