> 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/acao/janela-de-conversacao.md).

# Janela de conversação

O módulo **Janela de conversação** verifica se a conversa atual com o cliente no WhatsApp ainda está dentro da **janela de 24 horas** — o período em que você pode enviar qualquer tipo de mensagem sem precisar usar um template aprovado pela plataforma.

Com esse módulo, o seu fluxo consegue tomar decisões automáticas com base nessa verificação: se a janela ainda estiver aberta, o atendimento segue normalmente; se estiver fechada, o fluxo pode redirecionar para o envio de um template ou para outro caminho definido por você.

{% hint style="warning" %}
**Exclusivo para WhatsApp**\
Este módulo foi desenvolvido especificamente para canais conectados ao WhatsApp. Se o fluxo estiver rodando em outro canal (Instagram, Telegram, WebSDK etc.), a saída **Sucesso** é acionada automaticamente, pois a restrição de janela de conversação não se aplica.
{% endhint %}

**📷 Inserir print:** visão geral do módulo no diagrama de fluxo, mostrando o ícone, as saídas Sucesso e Erro

***

## 🗂️ Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Selecione o aplicativo desejado.
3. Acesse a aba **Fluxos** e abra o fluxo em que deseja utilizar o módulo.
4. No editor de fluxos, clique em **+** para adicionar um novo módulo.
5. Na categoria **Ação**, localize e selecione **Janela de conversação**.

**📷 Inserir print:** painel de adição de módulo com a categoria Ação expandida e o item Janela de conversação em destaque

***

## 🧩 Conhecendo o módulo

### 🖼️ Visualização no fluxo

Após adicionado ao diagrama, o módulo exibe:

* Um **ícone representativo** do módulo
* Duas **saídas de conexão** no lado direito:
  * **Sucesso** — em verde
  * **Erro** — em vermelho

Cada saída tem um ícone de informação **(ⓘ)** que, ao passar o mouse, exibe uma explicação sobre quando aquela saída é ativada.

**📷 Inserir print:** módulo no diagrama com as duas saídas visíveis e o tooltip aberto sobre a saída Sucesso

***

### ⚙️ Painel de configuração

Ao clicar no módulo no diagrama, um painel lateral se abre com:

* Uma **ilustração** representando a janela de conversação
* O **título** do módulo: *Janela de conversação*
* Uma **descrição** explicando o funcionamento e a razão de existir do módulo

{% hint style="info" %}
Este módulo não possui campos de configuração adicionais. Ele funciona automaticamente com base no histórico de interações do contato no canal.
{% endhint %}

**📷 Inserir print:** painel de configuração aberto, mostrando a ilustração e a descrição do módulo

***

### 🔀 Saídas do módulo

O módulo possui duas saídas possíveis, que devem ser conectadas aos próximos passos do fluxo:

| Saída         | Quando é acionada                                                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| ✅ **Sucesso** | O canal utilizado **não é WhatsApp**, OU a janela de conversa do WhatsApp **ainda não expirou** (menos de 24h desde a última mensagem do cliente) |
| ❌ **Erro**    | A janela de conversa do WhatsApp **expirou** (mais de 24h desde a última mensagem do cliente)                                                     |

**📷 Inserir print:** módulo no diagrama com as duas saídas conectadas a módulos diferentes, ilustrando o roteamento do fluxo

***

## 💡 Caso de uso

**Cenário:** Uma empresa de e-commerce usa o WhatsApp como canal principal de suporte. Quando um cliente envia uma mensagem, o fluxo verifica se a janela de 24 horas ainda está aberta antes de continuar o atendimento.

**Configuração:**

1. O fluxo recebe a mensagem do cliente e chega ao módulo **Janela de conversação**.
2. A saída **Sucesso** conecta ao restante do atendimento — envio de menu, respostas personalizadas e transferência para atendente.
3. A saída **Erro** conecta a um módulo de **envio de template** informando que o atendimento será retomado em breve, seguido de encerramento da sessão.

**Resultado:** O cliente nunca recebe uma mensagem fora do padrão exigido pelo WhatsApp. Se a janela estiver aberta, o atendimento flui normalmente. Se estiver fechada, o fluxo usa um template aprovado e encerra a conversa sem gerar erros ou bloqueios na conta.

**📷 Inserir print:** exemplo de fluxo completo com o módulo Janela de conversação e as duas saídas conectadas

***

## 📋 Resumo

* O módulo **Janela de conversação** verifica se o cliente ainda pode receber mensagens livres no WhatsApp (dentro das 24h da última interação).
* Possui duas saídas: **Sucesso** (janela aberta ou canal que não é WhatsApp) e **Erro** (janela expirada).
* Não requer nenhuma configuração manual — funciona automaticamente.
* Essencial para fluxos no WhatsApp que precisam decidir entre enviar mensagens livres ou usar templates aprovados.
* Para canais diferentes do WhatsApp, a saída **Sucesso** é sempre acionada.


---

# 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://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/acao/janela-de-conversacao.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.