---
title: Trigger Agenda (Agendamento)
description: Dispare um fluxo em um horário fixo ou recorrente, no modo visual ou por expressão Cron.
---

<NoCard kind="trigger_schedule" categoria="Gatilhos" />

# Trigger Agenda (Agendamento)

<Secao icon="info">Para que serve</Secao>

É 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.

<Secao icon="clock">Quando usar</Secao>

- 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.

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>Arraste o bloco **Trigger Agenda** para o canvas a partir da categoria **Gatilhos**. <Captura legenda="Painel de busca de blocos aberto no canvas, com as categorias e a lista de nós disponíveis para arrastar" src="/img/flowbuilder-paleta-aberta.png" /></Passo>
  <Passo>Clique no bloco para abrir o painel de configuração.</Passo>
  <Passo>Escolha o modo de agendamento: **Visual** (selecione dia, hora e recorrência com cliques) ou **Expressão Cron** (para agendamentos avançados).</Passo>
  <Passo>Configure o horário e a recorrência desejados. No modo visual, o campo de cron é gerado automaticamente para você.</Passo>
  <Passo>Conecte a saída do Trigger Agenda ao próximo bloco do fluxo. <Captura legenda="Fluxo de exemplo no canvas, com os blocos conectados em sequência do Início ao Fim" src="/img/flow-exemplo-canvas.png" /></Passo>
</Passos>

<Secao icon="sliders-horizontal">Campos</Secao>

| 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 |

<Secao icon="circle-check">Exemplo</Secao>

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.

<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.
</Dica>

<Cuidado>
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.
</Cuidado>

## Saiba mais

- [Start (Início do fluxo)](/guia/flow-builder/gatilhos/start) — outra forma de iniciar um fluxo
- [Gatilho por Webhook](/guia/flow-builder/gatilhos/webhook) — iniciar um fluxo por chamada externa
- [Testar e Publicar](/guia/flow-builder/testar-e-publicar) — publique o fluxo para o agendamento entrar em vigor