Gatilhos
O gatilho é o ponto de partida de todo workflow. Ele define quando o fluxo deve ser executado. Todo workflow precisa de exatamente um gatilho.
Para adicionar um gatilho, clique no botão "Trigger" (dropdown) na barra de ferramentas do editor e escolha o tipo.
Tipos de gatilho
1. Disparar Manualmente
O workflow é executado quando um usuário clica em "Executar Workflow" no editor (disponível apenas quando o workflow está Publicado).
Configuração:
- Selecione o tipo de registro sobre o qual o workflow vai agir (ex: Lead)
- Opcionalmente, defina filtros avançados para restringir quais registros serão processados
Quando usar: testes, campanhas pontuais, ações que precisam de aprovação humana antes de rodar.
2. Ao Evento do Aplicativo
O workflow é acionado automaticamente quando um evento específico acontece na plataforma.
Configuração:
- Clique no botão para abrir a lista de eventos disponíveis
- Eventos são agrupados por tipo de registro:
| Grupo | Exemplos de eventos |
|---|---|
| Lead | Lead criado, lead movido de etapa, lead marcado como ganho/perdido |
| Empresa | Empresa criada, dados alterados |
| Proposta | Proposta criada, proposta aceita |
| Mensagem | Nova mensagem recebida |
| Usuário | Usuário criado, perfil atualizado |
| Contrato | Contrato gerado, contrato assinado |
| Chat | Nova conversa iniciada |
| Formulário | Novo envio de formulário |
| Solicitação de desconto | Desconto solicitado, aprovado ou recusado |
- Selecione o evento desejado
Quando usar: resposta em tempo real a ações dos usuários — o caso de uso mais comum de automação.
3. Em um Agendamento
O workflow é executado em horários ou intervalos definidos por você.
Configuração — Agendado (data fixa):
- Escolha data e hora exatas para uma execução única
Configuração — Intervalo (recorrente):
| Unidade | O que configura |
|---|---|
| Segundos | Intervalo em segundos |
| Minutos | Intervalo em minutos |
| Horas | Intervalo em horas + minuto de execução |
| Dias | Intervalo em dias + hora + minuto |
| Semanas | Dias da semana (Dom–Sáb) + hora + minuto |
| Meses | Intervalo em meses + dia do mês + hora + minuto |
Quando usar: relatórios periódicos, lembretes recorrentes, campanhas semanais.
4. Iniciar via Webhook
O workflow é acionado por uma chamada HTTP externa — de outro sistema ou ferramenta.
Configuração:
- Uma URL única é gerada automaticamente para este workflow
- Selecione o método HTTP: POST ou GET
- Ative/desative o webhook com o toggle "Webhook Ativo"
- Validação por headers (opcional): defina pares de chave/valor que a requisição deve incluir para ser aceita — uma camada de segurança contra acionamentos indevidos
URL gerada: {base-da-api}/webhook/workflow-trigger/{id-do-nó}
Copie esta URL e configure-a no sistema externo que deve acionar o workflow.
Quando usar: integrações com sistemas externos (ERP, e-commerce, formulários de terceiros), zapier-like.