> 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/controle-de-fluxo/intervalo-de-tempo.md).

# Intervalo de tempo

O módulo **Intervalo de Tempo** verifica se o momento em que o cliente passa por aquele ponto do fluxo está dentro de um horário e dia da semana configurados. É útil para direcionar o atendimento de forma diferente dependendo do horário — por exemplo, oferecer atendimento humano só durante o horário comercial, e uma mensagem automática fora dele.

***

## 🧭 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 **Controle de fluxo**.
5. Arraste o módulo **Intervalo de Tempo** para a área de trabalho do fluxo.

***

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

### 🌎 Fuso horário

Selecione o fuso horário que deve ser usado como referência para a comparação de horário (por exemplo, `America/Sao_Paulo`). Este campo é obrigatório.

### 🎉 Considerar feriados nacionais (Brasil)

Ative esta opção para que o fluxo seja direcionado à saída de **Erro** automaticamente sempre que o dia atual for um feriado nacional brasileiro — mesmo que o feriado caia dentro de um dos intervalos configurados abaixo.

{% hint style="info" %}
Esta lista de feriados é fixa e cobre um período limitado de datas. Caso o fluxo precise continuar considerando feriados após esse período, será necessário atualizar essa configuração futuramente — consulte o suporte se notar que a verificação parou de funcionar corretamente após uma virada de ano.
{% endhint %}

### 🗓️ Intervalos

Adicione um ou mais intervalos de dia/horário. Para cada intervalo, configure:

| Campo              | O que preencher                                                   |
| ------------------ | ----------------------------------------------------------------- |
| **Dias da semana** | Um ou mais dias (ou todos os dias) em que este intervalo é válido |
| **De**             | Horário de início do intervalo                                    |
| **Até**            | Horário de término do intervalo                                   |

Use o botão **Adicionar um intervalo** para incluir mais de um período (por exemplo, manhã e tarde, com um intervalo de almoço no meio).

{% hint style="warning" %}
Este módulo não é compatível com intervalos que atravessam a meia-noite (por exemplo, "22:00 até 06:00"). Para representar um período noturno, configure o **De** sempre menor que o **Até** dentro do mesmo dia.
{% endhint %}

### 🔀 Saída do módulo

| Saída       | Quando acontece                                                                                                               |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Sucesso** | O momento atual está dentro de algum dos intervalos configurados para o dia de hoje                                           |
| **Erro**    | O momento atual está fora de todos os intervalos configurados, **ou** hoje é um feriado nacional (se a opção estiver ativada) |

{% hint style="info" %}
Quando a opção de feriados está ativada, a verificação de feriado é feita **antes** da verificação dos intervalos configurados — ou seja, em um feriado nacional o fluxo sempre segue pela saída de Erro, mesmo que o feriado caia em um dia da semana incluído nos intervalos.
{% endhint %}

## 💡 Caso de uso

**Cenário:** uma empresa quer transferir o atendimento para um agente humano apenas em horário comercial, e enviar uma mensagem automática informando o horário de funcionamento fora desse período.

**Configuração:**

1. Adicione o módulo **Intervalo de Tempo** logo após identificar que o cliente deseja falar com um atendente.
2. Configure o **Fuso horário** para `America/Sao_Paulo`.
3. Adicione um intervalo com os dias **Segunda a Sexta**, **De** `09:00` **Até** `18:00`.
4. Conecte a saída **Sucesso** ao módulo **Transferir Atendimento**.
5. Conecte a saída **Erro** a uma mensagem informando o horário de atendimento.

**Resultado:** o cliente só é transferido para um atendente humano durante o horário comercial configurado; fora desse período, recebe automaticamente a mensagem de aviso.

## 📌 Dicas úteis

* Use múltiplos intervalos para representar horários com pausa (por exemplo, manhã e tarde, com intervalo de almoço).
* Lembre-se de que intervalos que cruzam a meia-noite não são suportados — divida em dois intervalos separados se precisar cobrir esse cenário.
* Escolha o fuso horário correto para a operação da sua empresa, especialmente se atender clientes em diferentes regiões.
* A opção de feriados nacionais cobre apenas feriados do Brasil — se sua operação precisar considerar feriados estaduais, municipais ou de outros países, trate essa lógica com outro módulo (como **Condicional**) antes deste.

## 📝 Resumo

* O módulo **Intervalo de Tempo** verifica se o momento atual está dentro de um horário e dia da semana configurados.
* Permite configurar múltiplos intervalos, cada um com dias da semana, horário de início e término.
* Tem uma opção para considerar feriados nacionais do Brasil, que tem prioridade sobre os intervalos configurados.
* Possui duas saídas: **Sucesso** (dentro do intervalo) e **Erro** (fora do intervalo ou feriado).
* Não é compatível com intervalos que atravessam a meia-noite.