> 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 %}

***

## 🗂️ 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fx4mTW4jWGFOKa3KAO8oy%2Fimage.png?alt=media&amp;token=46f7ee57-e927-41b6-8cd2-d98798d2f5d7" alt=""><figcaption><p>Imagem 1 - Módulo Janela de conversação localizado no painel de busca, na categoria Ação.</p></figcaption></figure>

***

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

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fb229iE7xluUOMROMGcUf%2F02-canvas-tooltip-sucesso.png?alt=media&amp;token=97ae0c10-667e-44ec-a570-b8651faac06a" alt=""><figcaption><p>Imagem 2 - Módulo no diagrama com as duas saídas visíveis e o tooltip da saída Sucesso aberto.</p></figcaption></figure>

***

### ⚙️ 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FuSnzagLrGk98gVSChTcZ%2F03-painel-config-aberto.png?alt=media&amp;token=aecbac02-bc14-4cb9-a7f6-2f6acdc1433a" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Janela de conversação aberto, com a ilustração e a descrição.</p></figcaption></figure>

***

### 🔀 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)                                                     |

***

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

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FRMcm8qfStiCSLTNCh6JF%2F04-canvas-duas-saidas-conectadas.png?alt=media&amp;token=4a31819e-1e34-4d4e-9ab3-03c8ffc916da" alt=""><figcaption><p>Imagem 4 - Diagrama do fluxo com o módulo Janela de conversação e as duas saídas conectadas a módulos diferentes.</p></figcaption></figure>

***

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