> ## Documentation Index
> Fetch the complete documentation index at: https://developer.hubmessage.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Janela de conversa

> Entenda como funciona a janela de conversa de 24 horas do WhatsApp

export const projectName = 'Hub Message';

## Como funciona?

Quando um cliente envia uma mensagem para o seu número do WhatsApp, uma **janela de conversa de 24 horas** se abre. Enquanto essa janela estiver aberta, você pode enviar qualquer tipo de mensagem: texto, imagem, áudio, vídeo, documento, etc.

Se o cliente enviar outra mensagem, o timer de 24 horas **reinicia**. Ou seja, enquanto houver conversa ativa, a janela permanece aberta.

## Dentro da janela (24h)

Você pode enviar **qualquer mensagem** livremente usando os endpoints de [mensagens livres](/messages/introduction) — sem precisar de templates.

As mensagens enviadas dentro da janela são classificadas como **Service** e são **gratuitas e ilimitadas**.

<Note>
  Templates de **Utility** enviados dentro da janela de 24h também são **gratuitos**.
</Note>

## Fora da janela (após 24h)

Quando a janela fecha, a única forma de enviar mensagem ao cliente é através de **templates aprovados pela Meta** usando o endpoint [Enviar template](/messages/send-template).

| Categoria          | Quando usar                                   | Custo                                   |
| ------------------ | --------------------------------------------- | --------------------------------------- |
| **Marketing**      | Promoções, campanhas, ofertas                 | Cobrado por mensagem enviada            |
| **Utility**        | Confirmações, atualizações de pedido, alertas | Gratuito dentro da janela, cobrado fora |
| **Authentication** | Código OTP, verificação de login              | Cobrado por mensagem enviada            |

<Warning>
  Sem template aprovado, você **não consegue** enviar mensagens fora da janela de 24h. O WhatsApp bloqueia o envio.
</Warning>

## Como reabrir a janela?

Existem duas formas:

<Steps>
  <Step title="O cliente envia uma mensagem">
    A forma mais simples. Qualquer mensagem do cliente abre uma nova janela de 24h imediatamente.
  </Step>

  <Step title="Você envia um template">
    Envie um [template aprovado](/messages/send-template) (marketing, utility ou authentication). Quando o cliente **responder**, a janela de 24h reabre e você volta a poder enviar [mensagens livres](/messages/introduction).
  </Step>
</Steps>

## Entrada gratuita via anúncios

Quando o cliente chega pelo **Click-to-WhatsApp** (anúncio no Facebook) ou pelo **botão de CTA da página do Facebook**, a janela é estendida para **72 horas** e todas as mensagens são **gratuitas** nesse período, incluindo templates de marketing.

## Resumo visual

| Situação                                | Pode enviar mensagem livre? | Precisa de template? | Custo                |
| --------------------------------------- | --------------------------- | -------------------- | -------------------- |
| Cliente enviou mensagem (janela aberta) | Sim                         | Não                  | Gratuito             |
| Janela fechada (mais de 24h)            | Não                         | Sim                  | Depende da categoria |
| Via anúncio Click-to-WhatsApp           | Sim                         | Não                  | Gratuito por 72h     |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Mensagens livres" icon="paper-plane" href="/messages/introduction">
    Envie mensagens dentro da janela de 24h.
  </Card>

  <Card title="Enviar template" icon="file-lines" href="/messages/send-template">
    Envie mensagens fora da janela usando templates.
  </Card>

  <Card title="Gerenciar templates" icon="gear" href="/templates/introduction">
    Crie e gerencie seus templates aprovados.
  </Card>
</CardGroup>