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

# Templates e janela de 24h

> Regras do WhatsApp Business API, HSM e custos

## A janela de 24 horas

O WhatsApp Business API tem uma regra fundamental: você só pode enviar **mensagens livres** para um cliente durante **24 horas** após a última mensagem dele.

### Como funciona

| Situação                                   | O que você pode fazer |
| ------------------------------------------ | --------------------- |
| Cliente enviou mensagem nas últimas 24h    | Responder livremente  |
| Cliente não enviou mensagem há mais de 24h | Usar template (HSM)   |

<Warning>
  Se a janela fechou e você enviar mensagem sem template, ela **não será entregue**.
</Warning>

<Frame caption="Restrição 24h da janela do WhatsApp API">
  <img src="https://mintcdn.com/maketalk-7da59a87/8AIJNmsWTJlz6ZGr/images/operacao/restricao-24h.png?fit=max&auto=format&n=8AIJNmsWTJlz6ZGr&q=85&s=aac8436a63f9f554890cfc7a32050748" alt="restricao 24h" width="1080" height="740" data-path="images/operacao/restricao-24h.png" />
</Frame>

## O que são Templates (HSM)?

Templates são **mensagens pré-aprovadas pela Meta** que você pode usar para iniciar conversas fora da janela de 24h. Eles são essenciais para enviar mensagens promocionais, atualizações de pedidos e notificações de suporte através da Plataforma WhatsApp Business.

### Características dos templates

Templates podem incluir:

* **Mensagens de texto** com variáveis personalizadas (como `{{1}}`, `{{2}}`, etc.)
* **Imagens, vídeos ou documentos** como cabeçalho
* **Botões de ação** para respostas rápidas do cliente
* **Botões de call-to-action** que vinculam a sites ou números de telefone

<Note>
  Templates atualmente são suportados apenas para caixas WhatsApp Cloud (API Oficial). Caixas conectadas via QR Code não suportam templates.
</Note>

### Categorias de templates

O WhatsApp organiza templates em diferentes categorias baseadas em seu propósito:

| Categoria                 | Uso                                                           | Custo    |
| ------------------------- | ------------------------------------------------------------- | -------- |
| **Utilidade**             | Mensagens transacionais como confirmações de pedido e recibos | Menor    |
| **Marketing**             | Conteúdo promocional e ofertas especiais                      | Maior    |
| **Atualização de envio**  | Status de entrega e pacotes                                   | Variável |
| **Atualização de ticket** | Notificações de casos de suporte                              | Variável |
| **Resolução de problema** | Follow-ups de atendimento ao cliente                          | Variável |
| **Autenticação**          | Códigos de verificação e OTP                                  | Menor    |

### Exemplos de templates

<Tabs>
  <Tab title="Utilidade">
    ```
    Olá {{1}}! Sua reserva no {{2}} está confirmada
    para o dia {{3}}. Qualquer dúvida, estamos à disposição!
    ```

    *Variáveis: nome, hotel, data*
  </Tab>

  <Tab title="Marketing">
    ```
    {{1}}, temos uma oferta especial para você! 🎉
    Diárias a partir de R${{2}} no {{3}}.
    Válido até {{4}}. Quer saber mais?
    ```

    *Variáveis: nome, preço, hotel, data limite*
  </Tab>

  <Tab title="Reativação">
    ```
    Olá {{1}}! Notamos que sua reserva ficou pendente.
    Posso ajudar a finalizar? Responda esta mensagem
    para continuarmos seu atendimento.
    ```

    *Variável: nome*
  </Tab>
</Tabs>

## Custos dos templates

O WhatsApp cobra por cada template enviado conforme a categoria e país. Os valores podem variar significativamente.

### Como funciona a precificação

A precificação da WhatsApp Business API (Meta) é baseada em **janelas de conversa de 24 horas**, não por mensagem individual. O custo varia conforme a categoria da mensagem e quem inicia a conversa.

#### Janela de conversa

O custo é calculado por **janela de 24 horas de conversa**, não por mensagem individual. Dentro da mesma janela, você pode enviar múltiplas mensagens sem custo adicional.

<Note>
  Além da janela de 24h, existe também a **janela de 72 horas (Free Entry Points)** para leads que vêm de anúncios ou botões do Facebook. [Saiba mais sobre Free Entry Points](/administradores/cobranca-whatsapp-api#free-entry-points-janela-de-72h-para-leads-de-anuncios).
</Note>

#### Categorias de conversa

| Categoria        | Descrição                                                                                                                   | Custo                  |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
| **Serviço**      | Iniciadas pelo cliente (ex: "Olá, preciso de ajuda"). A empresa pode responder dentro da janela de 24h sem custo adicional. | Gratuito e sem limites |
| **Marketing**    | Mensagens de divulgação (templates aprovados).                                                                              | Pago por sessão        |
| **Utilidade**    | Notificações transacionais (ex: confirmação de pedido).                                                                     | Pago por sessão        |
| **Autenticação** | Códigos de verificação de dois fatores, senhas de uso único.                                                                | Pago por sessão        |

### Exemplo de preços (Brasil)

Os valores abaixo são exemplos e podem variar. Consulte sempre as taxas oficiais e de parceiros:

* **Marketing**: US\$ 0,0625 por sessão
* **Utilidade**: Cerca de US\$ 0,0080 por sessão (após redução em julho de 2025)
* **Autenticação**: Cerca de US\$ 0,0068 por sessão (após redução em julho de 2025) 

<Note>
  Valores podem variar por país. Mensagens dentro da janela de 24h **não têm custo adicional**. [Consulte o modelo completo de cobrança da API Oficial](/administradores/cobranca-whatsapp-api) para entender janelas de 24h, 72h e categorias de mensagem.
</Note>

## Quando usar templates

### Use templates para:

* ✅ Confirmar reservas
* ✅ Enviar lembretes
* ✅ Reativar conversas abandonadas
* ✅ Informar sobre promoções
* ✅ Follow-up de atendimento

### Evite usar templates para:

* ❌ Spam ou mensagens em massa não solicitadas
* ❌ Conteúdo que possa ser reportado
* ❌ Promoções muito frequentes

<Warning>
  Uso abusivo de templates pode resultar em **bloqueio do número** pelo WhatsApp.
</Warning>

<Note>
  Mesmo usando a API Oficial, é essencial seguir as políticas e diretrizes da Meta. Para entender o modelo de cobrança completo, [consulte nossa página sobre cobrança da API Oficial](/administradores/cobranca-whatsapp-api).
</Note>

## Como enviar um template na Make Talk

Você pode enviar templates de duas formas: **dentro de uma conversa** ou **abrindo um contato diretamente**. Ambas as opções permitem enviar templates individuais para clientes específicos.

### Opção 1: Enviar template dentro de uma conversa

<Steps>
  <Step title="Abra a conversa">
    Selecione a conversa do contato para quem deseja enviar o template.
  </Step>

  <Step title="Clique no ícone de template">
    No campo de mensagem, clique no **ícone do WhatsApp** (ícone de balão de conversa com telefone) para abrir os templates disponíveis.

    <Frame caption="Clique no ícone do WhatsApp no campo de mensagem para acessar os templates">
      <img src="https://mintcdn.com/maketalk-7da59a87/O9KMHh-lcJacbZno/images/operacao/selecionar-template-whatsapp.png?fit=max&auto=format&n=O9KMHh-lcJacbZno&q=85&s=dec65102b399fe86b3fe31a99e48e269" alt="Clique no ícone do WhatsApp no campo de mensagem para acessar os templates" width="1770" height="396" data-path="images/operacao/selecionar-template-whatsapp.png" />
    </Frame>
  </Step>

  <Step title="Selecione o template">
    Escolha o template desejado na lista de templates aprovados. Use a barra de pesquisa para encontrar templates específicos rapidamente.

    <Frame caption="Selecione o template que deseja enviar">
      <img src="https://mintcdn.com/maketalk-7da59a87/O9KMHh-lcJacbZno/images/operacao/escolher-template-enviar.png?fit=max&auto=format&n=O9KMHh-lcJacbZno&q=85&s=101bc4760e61819fc97b651de3addff6" alt="Selecione o template que deseja enviar" width="1462" height="1148" data-path="images/operacao/escolher-template-enviar.png" />
    </Frame>
  </Step>

  <Step title="Preencha as variáveis">
    Complete os campos obrigatórios do template:

    * **Variáveis de texto:** Nome do cliente, número do pedido, datas, valores, etc.
    * **Mídia (se aplicável):** URLs de imagens, vídeos ou documentos (devem ser publicamente acessíveis)
    * **Botões (se aplicável):** URLs dinâmicas, códigos de desconto, números de telefone

    <Note>
      Para templates com mídia, você precisa fornecer URLs de arquivos hospedados online e publicamente acessíveis. Não é possível fazer upload direto de arquivos.
    </Note>
  </Step>

  <Step title="Envie o template">
    Revise a pré-visualização da mensagem e clique em **"Enviar"**. O cliente receberá o template e poderá responder.
  </Step>
</Steps>

### Opção 2: Enviar template abrindo um contato

<Steps>
  <Step title="Acesse o contato">
    Vá em **Contatos** → Selecione o contato desejado ou use a busca para encontrá-lo.

    <Frame caption="Acesse o contato e clique em 'Enviar mensagem'">
      <img src="https://mintcdn.com/maketalk-7da59a87/O9KMHh-lcJacbZno/images/operacao/enviar-mensagem-pelo-contato.png?fit=max&auto=format&n=O9KMHh-lcJacbZno&q=85&s=b82da537df5b1847996d35a9529cfeea" alt="Acesse o contato e clique em 'Enviar mensagem'" width="1872" height="1422" data-path="images/operacao/enviar-mensagem-pelo-contato.png" />
    </Frame>
  </Step>

  <Step title="Clique em 'Enviar mensagem'">
    No perfil do contato, clique no botão **"Enviar mensagem"**.
  </Step>

  <Step title="Escolha a caixa de entrada">
    Selecione qual caixa WhatsApp usar para enviar a mensagem (caso você tenha múltiplas caixas configuradas).

    <Frame caption="Escolha a caixa de entrada WhatsApp que deseja usar">
      <img src="https://mintcdn.com/maketalk-7da59a87/O9KMHh-lcJacbZno/images/operacao/escolher-qual-caixa.png?fit=max&auto=format&n=O9KMHh-lcJacbZno&q=85&s=5c0d9a5942a100335b43493a6c3dc8cc" alt="Escolha a caixa de entrada WhatsApp que deseja usar" width="1778" height="998" data-path="images/operacao/escolher-qual-caixa.png" />
    </Frame>
  </Step>

  <Step title="Selecione o template">
    No campo de mensagem, clique no **ícone do WhatsApp** e escolha o template desejado.
  </Step>

  <Step title="Preencha e envie">
    Complete as variáveis do template e envie a mensagem.
  </Step>
</Steps>

### Enviar templates para múltiplos contatos

Para enviar templates para **múltiplos clientes simultaneamente**, use a funcionalidade de **Campanhas**:

<Card title="Criar campanha do WhatsApp" icon="paper-plane" href="/administradores/campanhas-massa-whatsapp">
  Aprenda a criar campanhas em massa usando templates aprovados.
</Card>

<Note>
  Templates só podem ser enviados através de caixas configuradas com **WhatsApp API Oficial**. Templates não estão disponíveis para caixas conectadas via QR Code.
</Note>

## Reabrindo a janela

Quando o cliente **responde** ao template:

1. A janela de 24h reabre
2. Você pode enviar mensagens livremente
3. A IA pode voltar a responder normalmente

## Dicas para não perder a janela

1. **Responda rápido** - Não deixe clientes esperando
2. **Configure a IA** - Respostas automáticas mantêm a janela aberta
3. **Use lembretes** - Se o cliente não respondeu, use template antes de 24h

<Tip>
  A Make Talk mostra um **indicador visual** quando a janela está prestes a fechar.
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Campanhas do WhatsApp" icon="plus-circle" href="/administradores/campanhas-massa-whatsapp">
    Passo a passo para criar campanhas usando templates aprovados.
  </Card>

  <Card title="Campanhas em massa" icon="paper-plane" href="/administradores/campanhas-massa-whatsapp">
    Entenda como funcionam as campanhas via API Oficial.
  </Card>

  <Card title="Modelo de cobrança da API" icon="dollar-sign" href="/administradores/cobranca-whatsapp-api">
    Entenda como funciona a cobrança por mensagem.
  </Card>

  <Card title="Etiquetas e organização" icon="tags" href="/operacao/etiquetas">
    Organize seus atendimentos com tags.
  </Card>

  <Card title="Caixas de entrada" icon="inbox" href="/administradores/caixas-entrada">
    Crie e configure seus canais de atendimento.
  </Card>
</CardGroup>
