> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/horario-de-trabalho.md).

# Horário de trabalho

### Visão Geral

O **Componente de Verificação de Expediente** é um nó de controle de fluxo condicional baseado no relógio do sistema. Sua função principal é interceptar a jornada do cliente e validar se o momento exato da execução coincide com os horários comerciais cadastrados no ecossistema da plataforma. Ele atua como um divisor de caminhos automatizado, garantindo que interações recebam tratativas diferentes dependendo da disponibilidade operacional da empresa.

### Parâmetros de Configuração

A parametrização do componente é enxuta e vinculada diretamente às definições globais do ambiente de trabalho:

* \_*Horário de Trabalho (* Campo Obrigatório):\_\* Menu suspenso para seleção de uma jornada preexistente. O componente não armazena as horas localmente; ele realiza uma consulta e herda as regras (dias da semana, turnos, horários de início e término) que foram previamente configuradas nas **configurações do workspace** da plataforma.<br>
* **Feriados (Chave de Alternância - Toggle Switch):** Quando ativada, a automação passa a consultar também o calendário de feriados associado ao workspace. Se a execução ocorrer em um dia considerado feriado, o sistema automaticamente classificará o momento como fora do expediente, mesmo que caia em um dia útil padrão.<br>

### Construtor Visual

O construtor foca na simplicidade de parametrização e na inteligência de herança de dados:

* **Vinculação Centralizada:** O seletor elimina a necessidade de redigitar tabelas de horários dentro de cada fluxo de automação, permitindo que alterações na jornada do workspace atualizem todos os componentes órfãos simultaneamente.<br>
* **Mapeamento de Saídas Condicionais:** Diferente de componentes de ação linear, a interface deste nó altera visualmente a estrutura do bloco no editor de fluxos, disponibilizando duas portas de saída físicas para conexão de ramificações:
  * Saída A: **Dentro do horário de trabalho**<br>
  * Saída B: **Fora do horário de trabalho**<br>

### Operadores Especiais

As propriedades lógicas deste componente lidam com a sincronização de fusos horários e processamento de calendários dinâmicos:

* **Resolução de Timezone Local:** O componente avalia a hora com base no fuso horário definido nas propriedades gerais do workspace (ex: America/Sao\_Paulo), garantindo que fusos horários de servidores em nuvem (geralmente em UTC) não distorçam a validação do expediente.<br>
* **Avaliação de Estado Booleana:** O motor do fluxo processa este componente de forma binária instantânea. Ele captura o timestamp atual, roda a função de validação contra a matriz do workspace selecionado e retorna um direcionamento imediato, sem reter o usuário em filas de espera.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários clássicos de aplicação deste componente para isolar e estruturar fluxos de atendimento:

| **Horário de Trabalho** | **Chave "Feriados"** | **Saída Acionada no Disparo**     | **Caso de Uso Prático**                                                                                                                      |
| ----------------------- | -------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Suporte Comercial**   | Ativada              | **Dentro do horário de trabalho** | Segunda-feira, 14:00 (dia útil normal). O fluxo segue para o componente de transferência humana.                                             |
| **Suporte Comercial**   | Ativada              | **Fora do horário de trabalho**   | Segunda-feira, 21:00. O fluxo desvia para uma mensagem de ausência, informando o horário de atendimento e encerrando o ciclo.                |
| **Plantão Técnico**     | Desativada           | **Dentro do horário de trabalho** | Terça-feira, 01:00 da manhã (configurado como horário de plantão). O sistema executa o alerta para a equipe de engenharia.                   |
| **Suporte Comercial**   | Ativada              | **Fora do horário de trabalho**   | Quarta-feira, 10:00 da manhã, porém em um dia de **Feriado Nacional**. O fluxo bloqueia o envio para humanos e aciona a resposta de recesso. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/horario-de-trabalho.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
