# AULA 5 - Modelos de Mensagens na API Oficial do WhatsApp (Envio fora da janela de 24h)

{% embed url="<https://youtu.be/0lh_70792v0?si=61yVnj9nkOne774f>" %}

<figure><img src="/files/kpKYW0IAZ1XrrHZlFW8j" alt=""><figcaption></figcaption></figure>

***

### O que é a janela de 24 horas do WhatsApp?

<figure><img src="/files/ZMZDNb48ZBC8C7lbTYBi" alt=""><figcaption></figcaption></figure>

A **janela de 24 horas** começa a contar a partir da **última mensagem enviada pelo cliente**.

Dentro dessa janela, você pode:

* Enviar mensagens livres
* Usar textos, imagens, áudios e botões

Fora dessa janela, você **só pode enviar mensagens usando modelos aprovados pela Meta**, também chamados de **templates**.

***

### O que são modelos de mensagens (templates)?

Modelos de mensagens são **mensagens pré-aprovadas pela Meta** que permitem que empresas entrem em contato com o cliente **mesmo sem uma mensagem recente dele**.

Eles são obrigatórios para:

* Reengajamento de clientes
* Lembretes
* Avisos importantes
* Campanhas

***

### Tipos de modelos disponíveis no BotConversa

No BotConversa, os modelos se dividem em **dois tipos principais**, cada um com uma finalidade e custo diferente:

#### 1️⃣ Modelo de Utilidade

Usado para **informações importantes, transacionais ou operacionais**.

**Exemplos de uso:**

* Confirmação de agendamento
* Aviso de pagamento
* Atualização de pedido
* Lembrete de compromisso

**Custo:**

* 💰 **R$ 0,05 por envio**

> ✅ Deve ser informativo, direto e sem apelo comercial.

***

#### 2️⃣ Modelo de Marketing

Usado para **promoções, ofertas e campanhas comerciais**.

**Exemplos de uso:**

* Promoções
* Descontos
* Lançamentos
* Convites para eventos

**Custo:**

* 💰 **R$ 0,45 por envio**

> ⚠️ Mensagens promocionais não podem ser aprovadas como utilidade.

***

### Quando usar cada tipo de modelo?

| Situação                           | Tipo recomendado |
| ---------------------------------- | ---------------- |
| Avisar horário de consulta         | Utilidade        |
| Enviar boleto ou link de pagamento | Utilidade        |
| Lembrar agendamento                | Utilidade        |
| Oferecer desconto                  | Marketing        |
| Divulgar promoção                  | Marketing        |
| Reativar clientes                  | Marketing        |

***

<figure><img src="/files/fBwujVIo3jU3UHn76dH8" alt=""><figcaption></figcaption></figure>

### Passo a passo: como criar um modelo de mensagem

#### Passo 1 – Acessar a área de modelos no BotConversa

1. Acesse o painel do **BotConversa**
2. Vá até:\
   **Configurações → WhatsApp → API Oficial → Modelos de Mensagem**
3. Clique em **Criar novo modelo**

***

#### Passo 2 – Escolher o tipo do modelo

1. Selecione o tipo:
   * **Utilidade** ou
   * **Marketing**
2. Confirme a escolha

> ⚠️ Escolha incorreta pode causar reprovação do template.

***

#### Passo 3 – Definir idioma e nome do modelo

1. Escolha o idioma (ex: **Português – Brasil**)
2. Defina um nome técnico para o modelo

**Boas práticas para o nome:**

* Use letras minúsculas
* Sem acentos
* Sem espaços (use \_ )

**Exemplo:**

```
lembrete_agendamento
promocao_black_friday
```

***

#### Passo 4 – Escrever o conteúdo da mensagem

1. Escreva o texto do modelo
2. Utilize variáveis quando necessário

**Exemplo – Utilidade:**

```
Olá {{1}}, lembramos que seu agendamento está marcado para {{2}} às {{3}}.
```

**Exemplo – Marketing:**

```
Olá {{1}} 👋
Temos uma oferta especial para você!
Ganhe {{2}}% de desconto usando o cupom {{3}}.
```

> 💡 As variáveis permitem personalização automática.

***

#### Passo 5 – Adicionar botões (opcional)

Você pode adicionar:

* Botão de **URL** (ex: site, checkout)
* Botão de **ligação telefônica**

> ⚠️ Botões devem ser coerentes com o texto do modelo.

***

#### Passo 6 – Enviar para aprovação da Meta

1. Revise todo o conteúdo
2. Clique em **Enviar para aprovação**
3. Aguarde o status

⏳ O prazo de aprovação normalmente varia de alguns minutos até 24h.

***

### Status possíveis do modelo

* **Em análise**: aguardando revisão da Meta
* **Aprovado**: pronto para uso
* **Reprovado**: precisa ajustes

***

### Erros comuns e como evitar reprovação

#### ❌ Usar linguagem promocional em modelo de utilidade

**Erro:**

* “Aproveite”, “Promoção”, “Oferta imperdível”

**Solução:**

* Use tom neutro e informativo

***

#### ❌ Falta de contexto na mensagem

**Erro:**

* Mensagem genérica sem explicar o motivo do contato

**Solução:**

* Explique claramente por que o cliente está recebendo a mensagem

***

#### ❌ Excesso de emojis ou letras maiúsculas

**Erro:**

* Texto agressivo ou sensacionalista

**Solução:**

* Use emojis com moderação

***

#### ❌ Botão que não corresponde ao texto

**Erro:**

* Texto fala de agendamento, botão leva para promoção

**Solução:**

* Mantenha coerência entre mensagem e ação

***

### Boas práticas importantes

* Crie modelos específicos para cada situação
* Evite reutilizar o mesmo template para finalidades diferentes
* Sempre revise antes de enviar para aprovação
* Teste os envios antes de campanhas grandes

***

### Próximos passos

Após os modelos aprovados:

* Vincule-os aos fluxos do BotConversa
* Configure envios automáticos
* Acompanhe custos por tipo de mensagem
* Analise performance das campanhas

***

Se precisar de ajuda, o suporte do **BotConversa** está à disposição.


---

# Agent Instructions: 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:

```
GET https://ajuda.botconversa.com.br/comece-por-aqui-aulas-sequenciais/primeiros-passos-botconversa-api-oficial/aula-5-modelos-de-mensagens-na-api-oficial-do-whatsapp-envio-fora-da-janela-de-24h.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
