Tipos de Trigger
- Os tres tipos de trigger disponiveis: temporal, hook e manual
- Como cada tipo de trigger funciona e quando usa-lo
- Como configurar o trigger na secao Gatilho do formulario de workflow
Um trigger (Gatilho) e a condicao que inicia seu workflow. Todo workflow tem exatamente um trigger, e voce o seleciona no dropdown Tipo na secao Gatilho do formulario de criacao de workflow. Existem tres tipos de trigger para escolher.
Temporal -- triggers agendados
Um trigger temporal executa seu workflow em um cronograma, similar a um cron job. Use quando voce quer que seu workflow execute em um horario especifico ou em um intervalo recorrente.
Exemplos de triggers temporais:
- Executar todo dia util de manha as 9:00 para enviar lembretes de consultas
- Executar uma vez por semana na segunda-feira para gerar um relatorio resumido
- Executar a cada hora para verificar conversas inativas
Quando voce seleciona o tipo de trigger temporal, o formulario exibira campos adicionais onde voce define o cronograma. Isso tipicamente inclui opcoes para definir a frequencia, dia e horario de execucao.
Triggers temporais sao ideais para tarefas recorrentes que nao dependem de um evento especifico acontecendo no sistema. Pense neles como tarefas agendadas que executam como um relogio.
Hook -- triggers baseados em eventos
Um trigger hook dispara quando um evento especifico ocorre no sistema. Use quando voce quer que seu workflow reaja a algo que acabou de acontecer, como uma nova mensagem chegando ou um cliente sendo criado.
Exemplos de triggers hook:
- Uma nova mensagem e recebida em uma conversa
- Um novo cliente e criado no banco de dados
- Uma conversa e aberta de um canal especifico
- Uma consulta ou evento e agendado ou atualizado
Quando voce seleciona o tipo de trigger hook, o formulario exibira campos onde voce especifica qual evento o workflow deve ouvir. Os dados do evento ficam entao disponiveis para as etapas do workflow como variaveis de entrada como {{client.name}} ou {{trigger.channel}}.
Triggers hook sao o tipo de trigger mais comum. Eles permitem que seus workflows respondam em tempo real a eventos acontecendo no sistema, tornando-os perfeitos para automacoes como mensagens de boas-vindas, notificacoes e atualizacoes de dados.
Manual -- acionado pelo funcionario
Um trigger manual significa que o workflow nao inicia automaticamente. Em vez disso, um funcionario o inicia clicando no botao executeManual na pagina do workflow. Use quando voce quer que uma pessoa decida quando o workflow deve executar.
Exemplos de triggers manuais:
- Um funcionario executa um workflow de limpeza de dados em massa quando necessario
- Um lider de equipe aciona um workflow de geracao de relatorio sob demanda
- Um agente de suporte dispara manualmente uma sequencia de acompanhamento para um cliente especifico
Quando voce seleciona o tipo de trigger manual, voce pode opcionalmente definir campos de entrada personalizados que o funcionario preenche quando inicia o workflow. Por exemplo, voce pode pedir ao funcionario para inserir um ID de cliente ou selecionar um intervalo de datas antes que a execucao comece.
Importante: O botao executeManual so fica disponivel apos o workflow ter sido salvo. Enquanto voce esta criando um novo workflow, este botao aparecera desabilitado.
Triggers manuais sao otimos para workflows que requerem julgamento humano sobre quando executar. Voce tambem pode definir entradas personalizadas para que o funcionario forneca dados especificos cada vez que o workflow e iniciado.
Escolhendo o trigger certo
| Voce quer... | Use este trigger |
|---|---|
| Executar uma automacao em um cronograma fixo (diario, semanal, por hora) | temporal |
| Reagir a um evento no sistema (nova mensagem, novo cliente) | hook |
| Deixar um funcionario decidir quando executar o workflow | manual |
Cada workflow suporta exatamente um trigger. Se voce precisa que o mesmo conjunto de etapas execute para eventos diferentes, crie um workflow separado para cada tipo de trigger.