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

# Templates de Mensagem

> Crie e gerencie templates de mensagem WhatsApp para conversas iniciadas pelo negócio

Templates de mensagem são formatos de mensagem pré-aprovados exigidos pelo Meta para conversas iniciadas pelo negócio no WhatsApp. Você deve ter templates aprovados antes de poder enviar mensagens de saída para clientes.

## O que são Templates de Mensagem?

Templates de mensagem são mensagens estruturadas que:

* Devem ser submetidos ao Meta para aprovação antes do uso
* Permitem que você inicie conversas com clientes
* Podem incluir variáveis para personalização
* São necessários para mensagens fora da janela de 24 horas

<Info>
  **Por que Templates?** — O WhatsApp exige templates para prevenir spam e garantir que negócios enviem mensagens valiosas e relevantes aos clientes. Todas as mensagens iniciadas pelo negócio devem usar templates aprovados.
</Info>

## Quando Você Precisa de Templates?

| Cenário                            | Template Necessário?                                         |
| ---------------------------------- | ------------------------------------------------------------ |
| Cliente manda mensagem primeiro    | Não — resposta de formato livre permitida dentro de 24 horas |
| Respondendo dentro de 24 horas     | Não — envie qualquer mensagem                                |
| Iniciando uma nova conversa        | **Sim**                                                      |
| Reengajando após 24 horas          | **Sim**                                                      |
| Enviando notificações/atualizações | **Sim**                                                      |
| Mensagens de marketing             | **Sim**                                                      |

## Categorias de Template

Templates são organizados em categorias que determinam seus requisitos de aprovação e casos de uso:

### Templates de Utilidade

Mensagens transacionais e relacionadas a serviços.

**Use para:**

* Confirmações de pedido
* Atualizações de envio
* Lembretes de compromisso
* Notificações de conta
* Recibos de pagamento

**Aprovação:** Normalmente aprovado dentro de minutos

### Templates de Marketing

Mensagens promocionais e relacionadas a vendas.

**Use para:**

* Ofertas promocionais
* Anúncios de produtos
* Newsletters
* Campanhas de vendas
* Mensagens de reengajamento

**Aprovação:** Pode demorar mais, revisão mais rigorosa

<Warning>
  **Sem Conteúdo de Categoria Cruzada** — Não inclua conteúdo promocional em templates de Utilidade. O Meta rejeitará templates com categoria e conteúdo incompatíveis.
</Warning>

### Templates de Autenticação

Mensagens de verificação e segurança.

**Use para:**

* Senhas de uso único (OTP)
* Códigos de verificação
* Confirmações de login
* Alertas de segurança

**Aprovação:** Revisão padrão

### Templates de Solicitação de Chamada de Voz

Templates especiais para solicitar permissão para chamadas de voz WhatsApp.

**Use para:**

* Solicitar permissão para ligar para clientes via voz WhatsApp
* Deve incluir um botão de solicitação de chamada de voz

**Aprovação:** Automático (ao usar formato padrão)

## Criando um Template

### Passo 1: Navegar para Templates

1. Vá para **Remetentes WhatsApp** → Selecione seu remetente → aba **Templates**
2. Ou vá para **Templates WhatsApp** diretamente
3. Clique **Criar Template**

### Passo 2: Configurar Configurações Básicas

| Campo         | Descrição                                                                              |
| ------------- | -------------------------------------------------------------------------------------- |
| **Nome**      | Identificador único (minúsculas, apenas underscores). Exemplo: `confirmacao_pedido_v1` |
| **Categoria** | Selecione Utilidade, Marketing, Autenticação ou Solicitação de Chamada de Voz          |
| **Idioma**    | Idioma do template (deve combinar com o conteúdo)                                      |

<Tip>
  **Melhores Práticas de Nomenclatura:**

  * Use nomes descritivos: `lembrete_compromisso`, `pedido_enviado`
  * Inclua números de versão: `mensagem_boas_vindas_v2`
  * Evite nomes genéricos: ~~`template1`~~, ~~`teste`~~
</Tip>

### Passo 3: Escrever Conteúdo do Template

Templates podem incluir múltiplos componentes:

#### Cabeçalho (Opcional)

* **Cabeçalho de Texto**: Headline curto (até 60 caracteres)
* **Cabeçalho de Mídia**: Imagem, vídeo ou documento (em breve)

#### Corpo (Obrigatório)

O conteúdo principal da mensagem. É aqui que você escreve sua mensagem.

**Usando Variáveis:**
Use `{{1}}`, `{{2}}`, etc. para conteúdo dinâmico:

```
Olá {{1}}, seu pedido {{2}} foi enviado!

Entrega prevista: {{3}}
Rastreie seu pacote: {{4}}
```

<Info>
  **Valores de Amostra** — Ao criar templates, você deve fornecer valores de amostra para cada variável. Estes ajudam o Meta a entender o propósito do seu template e são necessários para aprovação.
</Info>

#### Rodapé (Opcional)

Uma linha curta na parte inferior (até 60 caracteres). Frequentemente usada para info de opt-out ou disclaimers.

#### Botões (Opcional)

Adicione botões interativos ao seu template:

* **Resposta Rápida**: Botões de resposta pré-definida (ex. "Sim", "Não", "Saiba Mais")
* **Chamada para Ação**: Link para site ou número de telefone
* **Solicitação de Chamada de Voz**: Botão para solicitar permissão de chamada de voz

### Passo 4: Submeter para Aprovação

1. Revise o conteúdo do seu template
2. Clique **Submeter para Aprovação**
3. Status do template muda para "Aprovação Pendente"
4. Aguarde revisão do Meta (minutos a 24 horas)

## Processo de Aprovação de Template

```mermaid theme={null}
flowchart LR
    A[Criar Template] --> B[Submeter para Revisão]
    B --> C{Meta Revisa}
    C -->|Aprovado| D[Pronto para Usar]
    C -->|Rejeitado| E[Editar e Resubmeter]
    E --> B
```

### Tempos de Aprovação

| Categoria                     | Tempo Típico            |
| ----------------------------- | ----------------------- |
| Utilidade                     | Minutos a algumas horas |
| Marketing                     | Horas a 24 horas        |
| Autenticação                  | Minutos a algumas horas |
| Solicitação de Chamada de Voz | Normalmente instantâneo |

### Status de Templates

| Status                                                   | Descrição                                       |
| -------------------------------------------------------- | ----------------------------------------------- |
| <span style={{color: '#6b7280'}}>**Rascunho**</span>     | Ainda não submetido                             |
| <span style={{color: '#f59e0b'}}>**Pendente**</span>     | Submetido, aguardando revisão do Meta           |
| <span style={{color: '#22c55e'}}>**Aprovado**</span>     | Pronto para usar                                |
| <span style={{color: '#ef4444'}}>**Rejeitado**</span>    | Revisão falhou, veja motivo da rejeição         |
| <span style={{color: '#6b7280'}}>**Desabilitado**</span> | Desabilitado pelo Meta devido a baixa qualidade |

## Motivos Comuns de Rejeição

Evite esses erros comuns para melhorar sua taxa de aprovação:

### ❌ Conteúdo Promocional em Templates de Utilidade

**Problema:** Incluir descontos, ofertas ou linguagem de marketing em templates de Utilidade.

**Solução:** Use categoria Marketing para conteúdo promocional.

### ❌ Amostras de Variáveis Ausentes ou Pouco Claras

**Problema:** Variáveis como `{{1}}` sem valores de amostra claros.

**Solução:** Forneça valores de amostra realistas que mostrem o propósito da variável:

* ✅ `{{1}}` = "João Silva"
* ✅ `{{2}}` = "#12345"
* ❌ `{{1}}` = "teste"

### ❌ Linguagem Agressiva ou Ameaçadora

**Problema:** Conteúdo que pode ser percebido como assédio, ameaças ou spam.

**Solução:** Use linguagem profissional e amigável. Foque no valor para o cliente.

### ❌ Encurtadores de URL

**Problema:** Usar bit.ly, tinyurl ou outros encurtadores de URL.

**Solução:** Use URLs completas e com marca do seu domínio.

### ❌ Seleção Incorreta de Categoria

**Problema:** Escolher categoria errada para seu tipo de conteúdo.

**Solução:** Combine categoria ao propósito do conteúdo estritamente.

### ❌ Conteúdo Restrito

**Problema:** Templates sobre álcool, jogos, conteúdo adulto, mensagens políticas ou atividades ilegais.

**Solução:** Estes não são permitidos. Revise políticas de comércio do Meta.

## Usando Templates

### Enviando Mensagens Template

Uma vez aprovados, você pode enviar mensagens template:

1. **Via Plataforma de Automação**: Use a ação "Enviar Template WhatsApp"
2. **Via API**: Chame o endpoint de envio com ID do template e variáveis

### Substituição de Variáveis

Ao enviar, substitua variáveis com valores reais:

**Template:**

```
Olá {{1}}, seu compromisso está confirmado para {{2}} às {{3}}.
```

**Mensagem Enviada:**

```
Olá João, seu compromisso está confirmado para 15 de janeiro às 14:00.
```

## Melhores Práticas

### 1. Use Nomes Descritivos

```
✅ confirmacao_pedido_v1
✅ lembrete_compromisso
✅ atualizacao_envio_com_rastreio
❌ template1
❌ teste
❌ mensagem
```

### 2. Mantenha Mensagens Concisas

Usuários WhatsApp esperam mensagens rápidas e claras. Vá direto ao ponto e inclua uma chamada para ação clara.

### 3. Use Botões Interativos

Adicione botões de Resposta Rápida ou Chamada-para-Ação para facilitar a resposta dos clientes:

* "Rastrear Pedido"
* "Contatar Suporte"
* "Ver Detalhes"
* "Confirmar Compromisso"

### 4. Teste Antes de Envio em Massa

Sempre teste seu template com um único destinatário antes de enviar para uma grande audiência. Isso ajuda a detectar problemas de formatação.

### 5. Crie Templates Cedo

Aprovação pode demorar até 24 horas. Crie e submeta templates antes de precisar deles.

### 6. Tenha Templates de Backup

Crie múltiplas versões de templates importantes. Se um for rejeitado ou desabilitado, você tem alternativas prontas.

## Editando Templates

<Warning>
  **Edição Limitada** — Uma vez que um template está aprovado, você não pode editá-lo. Para fazer mudanças, você deve criar um novo template com um nome diferente.
</Warning>

**Pode Editar:**

* Templates rascunho (ainda não submetidos)
* Templates rejeitados (corrigir problemas e resubmeter)

**Não Pode Editar:**

* Templates aprovados
* Templates pendentes (deve aguardar revisão)

## Limites de Template

O Meta impõe limites na criação de templates:

* Máximo de templates por Conta WhatsApp Business: Varia por nível da conta
* Nomes de templates devem ser únicos por remetente
* Templates rejeitados contam para seu limite

## Próximos Passos

* Configure [gatilhos de automação](/whatsapp/automation) para enviar templates automaticamente
* Aprenda sobre [remetentes WhatsApp](/whatsapp/senders) e gerenciamento de remetente
* Revise [configuração de assistente IA](/ai-assistants/what-is-ai-assistant) para respostas de conversa