Quando usar
Use o gatilho manual quando quiser iniciar o workflow sob demanda, no momento em que desejar. Exemplos comuns:
- Testar um workflow durante o desenvolvimento antes de ativar um gatilho automatico
- Executar um processo pontual que nao precisa ser automatizado (ex: gerar um relatorio sob demanda)
- Rodar um fluxo passando dados especificos como entrada para teste ou processamento
- Disparar acoes manuais que dependem de decisao humana (ex: envio de campanha)
- Use o gatilho manual como ponto de partida durante o desenvolvimento do workflow. Depois que tudo estiver funcionando, troque para um gatilho automatico (agendamento, webhook, evento, etc.).
- As variaveis de entrada sao otimas para testar cenarios diferentes sem precisar alterar a logica do fluxo. Basta mudar os valores e clicar Play novamente.
- Se o seu workflow precisa de dados externos para funcionar (ex: ID de um cliente, nome de um produto), defina-os como variaveis de entrada para manter o fluxo flexivel.
- Lembre-se: workflows com gatilho manual nao executam sozinhos. Se voce precisa de execucao automatica, considere trocar para outro tipo de gatilho.
---
Como funciona
Ao adicionar este gatilho, o workflow so sera executado quando voce clicar no botao de Play na interface do editor. Nao ha nenhum disparo automatico — o controle e totalmente seu.
Voce pode definir variaveis de entrada que serao injetadas no fluxo a cada execucao. Isso e util para simular dados ou parametrizar o comportamento do workflow sem alterar os nodes internos.
---
Configuracoes
Variaveis de Entrada
Permite definir pares de Nome (Key)* e **Valor** que serao passados para o workflow no momento da execucao. Use o botao *+ para adicionar novas variaveis e o icone de lixeira para remover.
| Campo | Descricao |
|-------|-----------|
| Nome (Key) | Identificador da variavel. Sera usado para referencia-la nos nodes seguintes (ex: `input.nome_cliente`). |
| Valor | O valor que sera atribuido a variavel nesta execucao. |
Voce pode adicionar quantas variaveis quiser. Se nenhuma for configurada, o workflow executara normalmente, mas sem dados de entrada.
---
Dados de saida
Os nodes seguintes no fluxo podem acessar os dados gerados pelo gatilho manual:
| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `execution_id` | Texto | Identificador unico desta execucao do workflow |
| `input` | Objeto | Objeto contendo todas as variaveis de entrada definidas na configuracao |
Se voce definiu variaveis de entrada, os valores ficam disponiveis como subcampos. Exemplo: se voce criou uma variavel com key `nome_cliente`, acesse via `input.nome_cliente`.
---
Dicas
Este artigo foi útil?