> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/gatilho/agendamento.md).

# Agendamento

## ⏰ Agendamento

O módulo **Agendamento** inicia um fluxo automaticamente em datas e horários programados, sem depender de uma ação do cliente. É útil para rotinas recorrentes, como envios periódicos ou verificações automáticas.

**📷 Inserir print:** visão geral do módulo Agendamento na área de trabalho do fluxo

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Gatilho**.
5. Arraste o módulo **Agendamento** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Gatilho expandida e o módulo Agendamento visível

{% hint style="info" %}
O módulo Agendamento é um **gatilho**: ele inicia o fluxo sozinho, no horário programado, sem que o cliente precise enviar nenhuma mensagem.
{% endhint %}

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

**📷 Inserir print:** painel de configuração do módulo Agendamento aberto

***

#### 🌎 Fuso horário

Selecione o fuso horário de referência para os horários configurados abaixo.

{% hint style="warning" %}
Sempre selecione um fuso horário. Deixar esse campo vazio pode fazer o agendamento nunca disparar, ou disparar em um horário diferente do esperado.
{% endhint %}

**📷 Inserir print:** campo Fuso horário preenchido

***

#### 🗓️ Agendamentos

Configure um ou mais agendamentos, cada um podendo ser de dois tipos:

* **Dias da semana e horário** — escolha os dias da semana e um horário fixo (por exemplo, toda segunda e quarta às 09:00).
* **Expressão avançada (CRON)** — para quem precisa de uma programação mais flexível, usando o formato de expressão CRON.

Use o botão **Adicionar um agendamento** para incluir mais de um horário de disparo no mesmo módulo.

{% hint style="warning" %}
Ao usar **Dias da semana e horário**, o campo de horário é obrigatório. Sempre confirme se ele foi preenchido antes de publicar o fluxo — um agendamento sem horário definido pode não disparar corretamente.
{% endhint %}

{% hint style="warning" %}
Quando você configura mais de um agendamento no mesmo módulo, o card exibido na área de trabalho do fluxo pode mostrar as informações do primeiro agendamento repetidas para todos os outros, mesmo que cada um tenha dias e horários diferentes. Isso é apenas uma limitação visual do card — os agendamentos continuam funcionando normalmente, cada um no seu próprio dia e horário. Para conferir os valores reais de cada agendamento, abra o painel de configuração do módulo.
{% endhint %}

**📷 Inserir print:** lista de agendamentos configurados, com dias da semana e horário preenchidos

**📷 Inserir print:** card do módulo na área de trabalho do fluxo com mais de um agendamento configurado, mostrando a mesma informação repetida em cada linha

***

#### 🔀 Saída do módulo

O módulo tem uma única saída, **Próximo**, que é ativada sempre que um dos agendamentos configurados dispara.

**📷 Inserir print:** módulo Agendamento conectado ao próximo módulo do fluxo

***

### 💡 Caso de uso

**Cenário:** uma empresa quer enviar, toda segunda-feira às 08:00, um lembrete automático para uma lista de contatos.

**Configuração:**

1. Adicione o módulo **Agendamento** ao início de um fluxo dedicado a essa rotina.
2. Selecione o fuso horário da sua operação.
3. Adicione um agendamento do tipo **Dias da semana e horário**, marcando **Segunda-feira** às **08:00**.
4. Conecte a saída **Próximo** aos módulos que executam o envio do lembrete.

**Resultado:** toda segunda-feira, às 08:00, o fluxo é iniciado automaticamente, sem intervenção manual.

***

### 📌 Dicas úteis

* Use múltiplos agendamentos no mesmo módulo para representar horários diferentes (por exemplo, manhã e tarde).
* Sempre confirme o fuso horário configurado, especialmente se sua operação atende clientes em regiões diferentes.
* Use a expressão CRON apenas se precisar de um padrão de recorrência mais complexo do que dias da semana e horário fixo.

***

### 📝 Resumo

* O módulo **Agendamento** inicia um fluxo automaticamente em horários programados, sem depender de ação do cliente.
* Permite configurar múltiplos agendamentos, por dias da semana e horário ou por expressão CRON.
* É necessário definir um fuso horário para que os horários configurados funcionem corretamente.
* O módulo tem uma única saída, **Próximo**, ativada quando um agendamento dispara.