O trigger Zoen Workspace Events executa um workflow quando eventos acontecem no seu workspace: a execução de outro workflow falha ou tem sucesso, um workflow é publicado, ou uma condição de alerta como pico de latência ou limiar de custo é atingida. Use-o para construir workflows de side-effect — alerting, escalation, auto-remediation — compostos a partir de quaisquer blocos (Slack, email, webhooks, lógica customizada).
Eventos
Escolha um evento por bloco de trigger Zoen Workspace Events:
Eventos simples — disparam a cada ocorrência:
- Run Error: a execução de um workflow observado falhou
- Run Success: a execução de um workflow observado concluiu com sucesso
- Workflow Deployed: um workflow observado foi publicado (incluindo republicações e rollbacks de versão)
- Workflow Undeployed: um workflow observado foi tirado do ar
Condições de alerta — avaliadas conforme as execuções terminam (condições baseadas em falha avaliam em execuções que falharam), com um cooldown para disparar no máximo uma vez por janela de cooldown:
- Consecutive Failures: as últimas N execuções falharam
- Failure Rate: a taxa de falha atinge ou ultrapassa uma porcentagem em uma janela de tempo (mínimo de 5 execuções)
- Latency Threshold: uma execução demorou mais que uma duração fixa
- Latency Spike: uma execução foi uma porcentagem configurável mais lenta que a média recente (mínimo de 5 execuções)
- Cost Threshold: uma execução custou mais que um limiar de créditos
- Error Count: N ou mais erros ocorreram em uma janela de tempo
- No Activity: um workflow observado não teve execuções por um número configurável de horas
Escopo do workflow
Por padrão o trigger observa todo workflow do workspace. Selecione workflows específicos para restringir. O workflow que contém o trigger é sempre excluído — ele nunca recebe eventos sobre si mesmo.
Saídas
Todos os eventos incluem event, timestamp, workflowId e workflowName (o workflow de origem). Campos adicionais dependem do tipo de evento:
- runId: a execução que concluiu
- durationMs: duração da execução em milissegundos
- cost: custo da execução em créditos
- finalOutput: a saída final da execução (truncada quando grande)
Condições baseadas em execução aninham a execução que as disparou sob triggeringRun:
- triggeringRun.runId, triggeringRun.durationMs, triggeringRun.cost, triggeringRun.finalOutput
No Activity não tem execução disparadora, então carrega só os campos base.
- version: o número da versão de deployment que foi ativada
Workflow Undeployed carrega só os campos base.
Comportamento
- O workflow que contém o trigger Zoen Workspace Events precisa estar publicado para que os eventos disparem.
- Execuções iniciadas por um trigger Zoen Workspace Events nunca emitem eventos de workspace, então workflows de side-effect não podem encadear ou entrar em loop.
- Condições de alerta disparam no máximo uma vez por janela de cooldown (uma hora, ou a janela de inatividade para No Activity).
- A entrega de eventos é fire-and-forget: execuções de side-effect são cobradas como qualquer outra execução e estão sujeitas aos rate limits do workspace.
A configuração do trigger é capturada em snapshot no momento do deploy. Depois de mudar o tipo de evento, o escopo de workflows ou os limiares, publique o workflow de novo para as mudanças terem efeito.