Referência do nó

Kind:trigger_scheduleCategoria:Gatilhos

Trigger Agenda (Agendamento)

Para que serve

É o relógio despertador do seu fluxo. Você define uma hora (ou uma recorrência) e o fluxo dispara sozinho naquele momento — sem precisar que ninguém faça nada.

Quando usar

• Enviar mensagens em datas ou horários fixos (ex.: "todo dia útil às 8h, enviar o resumo do dia").
• Lembretes automáticos de vencimento, aniversário, prazo.
• Relatórios periódicos gerados e enviados sem intervenção humana.
• Qualquer tarefa que precisa acontecer em um ritmo constante e previsível.

Passo a passo

1. ·
   Arraste o bloco **Trigger Agenda** para o canvas a partir da categoria **Gatilhos**.

   

   CAPTURAR: bloco Trigger Agenda no canvas

2. ·
   Clique no bloco para abrir o painel de configuração.

   

   CAPTURAR: painel de configuração do Trigger Agenda

3. ·
   Escolha o modo de agendamento: **Visual** (selecione dia, hora e recorrência com cliques) ou **Expressão Cron** (para agendamentos avançados).

   

   CAPTURAR: seletor de modo Visual vs Expressão Cron

4. ·
   Configure o horário e a recorrência desejados. No modo visual, o campo de cron é gerado automaticamente para você.

   

   CAPTURAR: modo visual com dia da semana, hora e frequência configurados

5. ·
   Conecte a saída do Trigger Agenda ao próximo bloco do fluxo.

   

   CAPTURAR: Trigger Agenda conectado ao restante do fluxo

Campos

Campo	O que faz
Modo	Visual (interface amigável) ou Expressão Cron (controle total)
Expressão Cron	Define o ritmo do disparo (ex.: 0 8 * * 1-5 = seg a sex às 8h)
Fuso horário	Define em qual fuso horário o horário configurado deve ser interpretado
Título	Nome interno do nó no canvas

Referência rápida de Cron

Expressão	Significado
0 8 * * *	Todo dia às 8h
0 8 * * 1-5	Dias úteis às 8h
0 9 1 * *	Dia 1 de cada mês às 9h
*/30 * * * *	A cada 30 minutos

Exemplo

Um escritório de advocacia quer enviar uma mensagem de lembrete para todos os clientes com audiência no dia seguinte. O fluxo é agendado para disparar todo dia às 18h (0 18 * * *). O Trigger Agenda inicia o fluxo, que consulta a lista de audiências do dia seguinte e envia mensagens personalizadas via WhatsApp.

CAPTURAR: Trigger Agenda configurado com expressão '0 18 * * *' e fuso horário America/Sao_Paulo

Dica

Se você não é familiarizado com Cron, use o **modo visual** — ele gera a expressão correta para você enquanto você clica nas opções. Você pode depois copiar a expressão gerada se quiser ajustar manualmente.

Atenção

Confirme o fuso horário configurado. Se deixar no padrão UTC, um agendamento para "8h" vai disparar às 5h no horário de Brasília (UTC-3). Sempre selecione `America/Sao_Paulo` para evitar surpresas.