> 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/transformacao-de-dados/temporizador.md).

# Temporizador

### Visão Geral

O **Componente de Temporizador** (identificado na interface pelo nome técnico descritivo `timer`) é um nó utilitário focado no controle de fluxo baseado em tempo. Sua função principal é aplicar uma pausa programada na execução da automação, retendo o contato nesse estágio exato da jornada por um período determinado antes de liberá-lo para o próximo bloco conectado. Ele é essencial para humanizar interações, simular digitação e estruturar réguas de relacionamento espaçadas.

### Parâmetros de Configuração

A parametrização do bloco gerencia a janela de espera do motor através de um único critério de entrada:

* **Tempo limite:** Campo de entrada numérico onde o administrador preenche o intervalo de retenção desejado. O motor de execução da plataforma interpreta o valor inserido **estritamente em segundos** (ex: para configurar uma pausa de 1 minuto, deve-se preencher o valor de `60`).<br>

### Construtor Visual

A interface gráfica preza pelo minimalismo operacional para atuar de forma limpa como um nó de processamento de fila de espera:

* **Painel de Input Direto:** Exibe um layout enxuto composto unicamente pelo campo de digitação do limite de tempo. Por ser um componente puramente lógico e interno ao core do sistema, ele dispensa seletores de credenciais, mídias ou variáveis de mapeamento.<br>
* **Porta de Conexão Contínua:** No editor de design de fluxos, o bloco apresenta uma porta de entrada tradicional e uma única porta física de saída. Não há bifurcações complexas; o contato entra, aguarda o esgotamento do tempo programado e segue de forma linear pelo conector de saída.<br>

### Operadores Especiais

As propriedades lógicas deste componente gerenciam cronômetros assíncronos e o agendamento de tarefas em segundo plano (*background job scheduling*):

* **Enfileiramento por Estado de Sleep:** Ao passar por este componente, o motor da automação pausa a leitura do script para aquele contato específico, salvando o estado atual da jornada e criando um agendamento assíncrono interno.<br>
* **Execução Baseada em Unidade de Tempo Fixa:** O interpretador do campo não aceita strings de texto, operadores matemáticos complexos ou formatações de horas (como "00:05:00"). Ele exige um número inteiro simples que representa o tempo bruto computado em segundos.<br>

### Exemplos Práticos

A tabela abaixo demonstra cenários e equivalências matemáticas para programar pausas eficientes dentro da árvore de automação:

| **Tempo Limite Configurado** | **Equivalência em Tempo Real** | **Comportamento do Sistema**                           | **Caso de Uso Prático**                                                                                                                                                                           |
| ---------------------------- | ------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `5`                          | 5 segundos                     | Segura o fluxo por 5 segundos antes de avançar.        | **Simulação de Digitação:** Utilizado entre dois blocos de mensagem de texto seguidos para simular que um operador humano está digitando, evitando o envio instantâneo de blocos densos de texto. |
| `300`                        | 5 minutos                      | Retém o contato na fila por 5 minutos exatos.          | **Intervalo de Resposta:** Aguardar um pequeno período após uma ação do usuário (como o preenchimento de um cadastro no site) antes de enviar uma mensagem de acompanhamento ou checagem.         |
| `3600`                       | 1 hora                         | Segura a execução por 1 hora antes de liberar a saída. | **Régua de Relacionamento Espaçada:** Após o envio de um conteúdo rico ou e-mail, o sistema aguarda uma hora antes de fazer um novo contato ativo de feedback com o cliente na plataforma.        |


---

# 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/transformacao-de-dados/temporizador.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.