> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.aloha.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Boas práticas para a criação de modelos do WhatsApp

 
Os templates do WhatsApp são a única forma de iniciar conversas com clientes fora da janela de atendimento de 24 horas. A Meta os revisa antes de aprová-los, e uma rejeição pode significar dias de atraso nas suas comunicações. Este guia reúne as regras, erros comuns e dicas práticas para que seus templates sejam aprovados na primeira tentativa.


# **1. Escolha a Categoria Correta**
Este é o erro mais comum e a principal causa de rejeições. A Meta classifica os templates em duas categorias, e o conteúdo deve corresponder exatamente à que você selecionar.

| **Categoria** | **Uso** | **Exemplos** |
| **📣 Marketing** | Promoção de produtos, ofertas, anúncios com opt-in explícito do usuário. | *Descontos, lançamento de produtos, convites para eventos* |
| **⚙️ Utility** | Mensagens transacionais: confirmações, atualizações, alertas não promocionais. | *Confirmação de reserva, lembrete de consulta, alerta de fraude* |

| **Atenção: Mudança de Regras desde Abril de 2025***A Meta pode reclassificar automaticamente um template de Utilidade para Marketing se detectar linguagem calorosa, aberta ou levemente promocional. Isso pode aumentar o custo por conversa. Se quiser que um template permaneça como Utilidade, escreva-o como um alerta ou notificação direta, não como uma conversa.* |

**Regra prática para escolher a categoria:**
* Does the message promote something or invite the user to buy/engage? → Marketing
* Does the message inform about something the user already initiated or requested? → Utility


# **2. Erros de Formato que Causam Rejeição Automática**
Meta’s review system works partially through automation. The following format errors trigger immediate rejection without human review.

## **Variáveis (Parâmetros)**
* **Formato incorreto: **Use sempre {{variaveis_do_sistema}} (sempre com chaves duplas). Um único par como {exemplo} ou (exemplo) será rejeitado.
* **Variável no início ou no final: **Never begin or end a message with a variable. E.g.: ❌ {{guest-name}}, your reservation is ready. ✅ Hello {{guest-name}}, your reservation is ready.
* **Variáveis consecutivas: **You cannot have two variables together without text between them: ❌ {{guest-name}}{{reservation-id}}
* **Template genérico demais: **"Hello {{guest-name}}." will be rejected. Add enough context for Meta to understand the purpose.

| **Exemplo correto de template de Utilidade***Olá {{nome-do-hospede}}, sua reserva #{{id-da-reserva}} foi confirmada com sucesso. Sua data de check-in é {{data-de-checkin}}.* |

## **Texto e Conteúdo**
* Não use links encurtados (bit.ly, tinyurl). A URL deve levar diretamente ao domínio da sua empresa.
* Evite erros de ortografia e gramática. O revisor os detecta e pode rejeitar por baixa qualidade.
* Não use emojis no cabeçalho nem no rodapé, apenas no corpo e com moderação.
* Não solicite dados sensíveis: número completo do cartão, senhas, dados bancários completos.
* Evite linguagem ameaçadora, urgência falsa ou afirmações enganosas.

| **❌ Words that trigger automatic rejection in Utility templates***"grátis", "desconto", "oferta", "exclusivo", "promo", "aproveite agora". Essas são palavras de Marketing. Usá-las em um template de Utilidade gera rejeição.* |


# **3. Nomes de Templates: Pequeno Detalhe, Grande Impacto**
O nome do template é um dos fatores que a Meta avalia. Siga estas regras:

* Apenas letras minúsculas, números e underscores ( _ ). Máximo de 512 caracteres.
* Use nomes descritivos que reflitam o propósito: order_confirmation_pt, appointment_reminder_v2
* Se um template for rejeitado, você deve criar um novo com um nome diferente. O nome original fica bloqueado por 30 dias.
* Você pode criar múltiplos templates com o mesmo nome em idiomas diferentes; cada um conta para o seu limite.

| **Exemplos de nomenclatura recomendada***suporte_ticket_criado | marketing_promo_verao_2025 | utilidade_envio_confirmado | marketing_desconto_julho* |


# **4. Sempre Inclua Exemplos de Parâmetros**
Quando um template tem variáveis, você deve incluir valores de exemplo reais ao criá-lo. A equipe de revisão usa esses exemplos para entender o contexto e decidir se aprova. Se os exemplos forem genéricos ou vazios, a aprovação será mais lenta ou o template poderá ser rejeitado.

* Use valores reais e representativos, não texto genérico como "asd" ou "123".
* Os exemplos devem refletir o caso de uso real do template.
* Para templates com conteúdo multimídia (imagem/vídeo/documento), você deve fazer upload de um arquivo de amostra.

|| **Nota: ***Aloha does this by default when you create a template directly from the system’s internal module.*

| **❌ Bad examples**{{1}} → "John"{{2}} → "123"{{3}} → "tomorrow" | **✅ Good examples**{{1}} → "Maria Garcia"{{2}} → "ORD-48291"{{3}} → "March 15, 2025" |


# **5. Manter a Qualidade dos Templates Ativos**
Ter um template aprovado não é o fim do processo. A Meta monitora continuamente como os usuários interagem com as mensagens que você envia. Uma qualidade baixa pode pausar ou desativar seu template.

## **Estados de qualidade a monitorar**
* **Qualidade alta: **Poucos ou nenhum feedback negativo. Situação ideal.
* **Qualidade média: **Vários usuários bloquearam ou denunciaram a mensagem. Agir rapidamente.
* **Qualidade baixa: **O template pode ser pausado. Revisar e corrigir o conteúdo ou o público.
* **Pausado: **Não pode ser enviado. Requer ação imediata.
* **Desativado: **Feedback negativo recorrente. O template não pode ser recuperado.

## **Como manter a qualidade alta**
* Envie templates apenas para usuários que deram opt-in explícito para esse tipo de mensagem.
* Não envie o mesmo template de marketing repetidamente para os mesmos usuários.
* Personalize as mensagens ao máximo usando variáveis relevantes.
* Revise o motivo pelo qual os usuários bloqueiam ou denunciam; ajuste o conteúdo ou a frequência.
* Monitore o painel do WhatsApp Manager e configure webhooks de atualização de status.


# **6. Boas Práticas ao Redigir o Conteúdo**
O conteúdo do template deve ser claro, direto e compreensível sem contexto adicional.

* O propósito da mensagem deve ser óbvio desde a primeira frase.
* Use variáveis para personalizar, não para ocultar o propósito real da mensagem.
* Se incluir botões de chamada para ação (CTA), certifique-se de que sejam claros e relevantes.
* Evite templates muito amplos com muitos parâmetros: quanto mais variáveis, maior o risco de rejeição.
* Para templates de Utilidade, escreva como um alerta: preciso, informativo, sem excessos.
* Para templates de Marketing, sempre inclua o valor para o cliente e o tipo de comunicação.

| **Sobre as mensagens de Marketing desde julho de 2025***O WhatsApp atualizou seu modelo de preços para cobrar por mensagem (não por conversa). Isso torna mais importante do que nunca manter os templates de Utilidade corretamente categorizados para controlar custos.* |


# **7. O Que Fazer se um Template For Rejeitado**
A rejeição não é definitiva. Siga estes passos:

1. Revise o código de rejeição no WhatsApp Manager para entender o motivo exato.
2. Crie um novo template com um nome diferente (o nome rejeitado fica bloqueado por 30 dias).
3. Corrija o problema: revise a categoria, o formato das variáveis, o conteúdo proibido e os exemplos.
4. If you believe the rejection was Meta’s error, you can appeal through WhatsApp Business Support.
5. If the template has been in “Under review” status for more than 48–72 hours, open a support ticket.

| **Códigos de rejeição comuns***TAG_CONTENT_MISMATCH: o idioma ou categoria não corresponde ao conteúdo.INVALID_FORMAT: variáveis formatadas incorretamente.POLICY_VIOLATION: conteúdo que viola as políticas do WhatsApp.DUPLICATE_TEMPLATE: um template idêntico já existe na conta.* |


# **Lista de Verificação Antes de Enviar um Template**
Antes de clicar em "Enviar para revisão", confirme cada item:

* A categoria corresponde exatamente ao propósito da mensagem.
* As variáveis usam o formato correto (chaves duplas: {{nome_da_variavel}}).
* Nenhuma variável aparece no início nem no final da mensagem.
* Não há variáveis consecutivas sem texto entre elas.
* O nome do template usa apenas letras minúsculas e underscores.
* Incluí valores de exemplo reais e representativos para cada variável.
* O conteúdo não inclui URLs encurtadas.
* URLs point to my company’s own domains.
* Não estou solicitando dados financeiros ou pessoais sensíveis.
* Não estou usando palavras de marketing (grátis, desconto, oferta) em um template de Utilidade.
* O propósito da mensagem é claro sem precisar de contexto externo.
* Se incluir multimídia, fiz upload de um arquivo de amostra válido.


*Source: WhatsApp Business Platform — Meta Developers Documentation | Updated January 2026*