Criando um Workflow
- Como navegar ate o formulario de criacao de workflow
- Como preencher cada campo: nome, toggle de ativacao, nivel de log, trigger e etapas
- Como salvar e testar seu novo workflow
Criar um workflow permite automatizar uma serie de acoes que executam sempre que uma condicao especifica e atendida -- seja um horario agendado, um evento do sistema ou um botao pressionado manualmente.
Passo a passo: criar um novo workflow
1. Abra a lista de workflows
Navegue ate Automacoes > Workflows na barra lateral. Isso abre a pagina de lista de workflows, que mostra todos os seus workflows existentes.
2. Clique no botao adicionar
Clique no botao workflow_add na area superior da pagina. Isso abre o formulario de criacao de workflow.
3. Insira o nome do workflow (Nome)
No campo Name, digite um nome descritivo para o seu workflow. Escolha algo que descreva claramente o que o workflow faz, como "Mensagem de boas-vindas para novos clientes" ou "Lembrete diario de consultas."
4. Habilite ou desabilite o workflow (Ativado)
Use a caixa de selecao Ativado para controlar se o workflow esta ativo. Quando marcada, o workflow esta habilitado e executara quando sua condicao de trigger for atendida. Deixe desmarcada enquanto ainda estiver construindo e testando.
5. Defina o nivel de log (Log Level)
Selecione um Log Level no dropdown. Isso controla quanta informacao e registrada cada vez que o workflow executa. Um nivel de log mais alto captura mais informacoes, o que e util durante testes e resolucao de problemas. Um nivel mais baixo reduz ruido quando o workflow esta funcionando bem em producao.
6. Configure o trigger (Gatilho)
Na secao Gatilho, escolha um Tipo no dropdown. Existem tres opcoes:
| Tipo de trigger | Quando usar |
|---|---|
| temporal | Voce quer que o workflow execute em um cronograma (ex.: toda manha, uma vez por semana) |
| hook | Voce quer que o workflow dispare quando um evento especifico acontecer (ex.: uma nova mensagem e recebida, um cliente e criado) |
| manual | Voce quer que um funcionario inicie o workflow manualmente quando necessario |
Apos selecionar o tipo de trigger, campos de configuracao adicionais podem aparecer dependendo da sua escolha. Veja Tipos de trigger para detalhes completos sobre cada opcao.
7. Adicione etapas (Etapas)
Na secao Etapas, clique no botao Add passo (Adicionar etapa) para adicionar sua primeira etapa. Cada etapa representa uma acao que o workflow executara. Voce pode adicionar quantas etapas precisar, e elas executarao em ordem de cima para baixo.
A secao Etapas tambem fornece dois botoes utilitarios:
- Debug all -- Executa todas as etapas em modo de depuracao para que voce possa inspecionar como cada uma se comporta
- Limpar todos os itens -- Remove todas as etapas de uma vez, permitindo comecar de novo
Veja Etapas do workflow para detalhes sobre configuracao de etapas individuais.
8. Salve o workflow
Depois de configurar o nome, trigger e etapas, salve o workflow. Apos salvar, opcoes adicionais ficam disponiveis, incluindo o botao executeManual para testar workflows com trigger manual.
Testando seu workflow
Mantenha seu workflow desabilitado (Ativado desmarcado) enquanto constroi e testa. Quando estiver confiante de que funciona corretamente, marque a caixa Ativado para ativa-lo para uso em producao.
- Para workflows manuais: Apos salvar, clique no botao executeManual para acionar o workflow sob demanda. Este botao so esta disponivel apos o workflow ter sido salvo.
- Para workflows hook: Acione o evento relevante no sistema (ex.: crie um cliente de teste) e depois verifique o historico de execucao para confirmar que o workflow executou.
- Para workflows temporais: Aguarde o horario agendado, ou ajuste temporariamente o cronograma para um horario proximo para teste.
Use o botao Debug all na secao Etapas para percorrer seu workflow e inspecionar como cada etapa processa dados antes de entrar em operacao.