Resumo
A criação de modelos de mensagem do WhatsApp exige seguir regras de formatação específicas para que sejam aprovados rapidamente. Este guia explica as convenções de nomenclatura, formatação de conteúdo, regras de variáveis e requisitos de tradução para modelos de mensagem. Seguir estas diretrizes ajudará a otimizar o processo de aprovação e melhorar o gerenciamento de mensagens.
Importante: Limite de caracteres para modelos de marketing da Meta
A Meta introduziu anteriormente uma regra que restringia os modelos de marketing a um máximo de 550 caracteres ou 10 emojis. Se um modelo excedesse esses limites, a entrega da mensagem falhava com o código de erro
2388040.
Esta regra foi posteriormente revertida. Os modelos de marketing agora suportam novamente até 1024 caracteres, e o limite anterior de 550 caracteres não se aplica mais.
Instruções
Diretrizes para modelos de mensagem do WhatsApp
O WhatsApp impõe regras para modelos de mensagem para manter as comunicações comerciais de alta qualidade e eficazes. Aqui está o que você precisa saber.
1. Regras principais para modelos
Limites de parâmetros (variáveis) — Os modelos não podem ter muitos espaços reservados (variáveis) em comparação com o comprimento da mensagem.
❌ Variáveis demais: Olá {{1}}, seu pedido {{2}} de {{3}} foi enviado para {{4}}. Acompanhe aqui: {{5}}
✅ Uso correto: Olá {{1}}, seu pedido {{2}} foi enviado. Acompanhe aqui: {{3}}
Posicionamento de parâmetros — Um modelo não pode começar ou terminar com uma variável.
❌ Inválido: {{1}}, seu agendamento está confirmado.
✅ Válido: Olá {{1}}, seu agendamento está confirmado.
Nota: Desde 1º de outubro de 2025, os modelos que não seguem estas regras são bloqueados no momento da criação. Antes dessa data, esses modelos podiam ser criados, mas eram imediatamente rejeitados. Agora, você receberá uma mensagem de erro clara no ponto de criação explicando o motivo, para que possa corrigir o modelo antes de enviá-lo novamente.
2. Uso incorreto de categorias de modelo
Usar modelos de Marketing ou Utilidade para verificação de identidade (em vez de modelos de Autenticação) pode estar sujeito a uma aplicação mais rigorosa.
Se for detectado uso incorreto, o WhatsApp pode impor uma restrição de 7 dias, durante a qual você não poderá criar novos modelos de Utilidade. O uso incorreto persistente pode levar a uma restrição mais longa, de 30 dias.
Dica: Sempre verifique se seus modelos estão na categoria correta e se seguem as regras de variáveis do WhatsApp para evitar rejeições.
3. Entendendo as variáveis (parâmetros)
As variáveis (também chamadas de parâmetros) são espaços reservados em seu modelo que são preenchidos com os valores reais de cada contato quando a mensagem é enviada — por exemplo, o nome de um cliente ou o número de um pedido.
No Wati, você pode usar qualquer um dos formatos abaixo — ambos são suportados e ambos realizam a mesma tarefa: eles extraem o valor correto para cada contato quando a mensagem é enviada.
Variáveis numeradas — escritas como
{{1}},{{2}},{{3}}.Variáveis nomeadas — escritas com um nome, como
{{customer_name}}ou{{order_number}}.
Você pode escolher o estilo que preferir.
Ao longo deste guia, {{1}} e {{name}} são mostrados apenas como exemplos para ilustrar as regras. Use o estilo de variável que melhor se adaptar ao seu modelo.
4. Regras de nomenclatura de modelos
Ao nomear seu modelo de mensagem do WhatsApp, siga estas diretrizes:
Use apenas caracteres alfanuméricos minúsculos e sublinhados (
_).Evite espaços, letras maiúsculas e caracteres especiais que não sejam sublinhados.
Escolha um nome descritivo para que tanto os revisores do WhatsApp quanto sua equipe possam gerenciar os modelos facilmente.
O nome do modelo pode ter até 512 caracteres.
Nomes de modelo corretos:
✅ shipping_update
✅ order_followup1
✅ payment_reminder
Nomes de modelo incorretos:
❌ ShippingUpdate (usa letras maiúsculas)
❌ order follow-up (contém um espaço e um hífen)
❌ message_124a! (contém um caractere especial além do sublinhado)
Dica: Um nome claro e significativo acelera a aprovação. Evite nomes aleatórios ou pouco claros como message_124a.
5. Regras de conteúdo de modelos
Para garantir que seu modelo esteja formatado corretamente e seja aprovado, siga estas diretrizes de conteúdo:
O conteúdo deve ser baseado em texto (letras, dígitos, caracteres especiais, emojis e formatação específica do WhatsApp).
Comprimento máximo: 1024 caracteres para modelos de Marketing, Utilidade e Autenticação.
Para modelos de Autenticação, o corpo da mensagem só pode usar o modelo predefinido fornecido pela Meta. Você ainda pode adicionar mais instruções no rodapé do modelo.
O conteúdo não pode incluir:
Quebras de linha ou espaços de tabulação.
Mais de quatro espaços consecutivos.
Use chaves duplas (
{{ }}) para variáveis — por exemplo,{{1}}ou{{customer_name}}.Uma Conta do WhatsApp Business pode criar até 100 modelos de mensagem por hora.
Conteúdo de modelo correto (variáveis numeradas):
Olá {{1}}, seu pedido {{2}} foi enviado
e a previsão de entrega é para {{3}}.Conteúdo de modelo correto (variáveis nomeadas):
Olá {{name}}, seu pedido {{order_number}} foi enviado
e a previsão de entrega é para {{delivery_date}}.Conteúdo de modelo incorreto:
Olá {{ name }}, seu pedido {{ order_number }} foi enviado
e a previsão de entrega é para {{ delivery_date }}.❌ Espaços extras, espaços dentro das chaves e quebras de linha desnecessárias.
6. Traduções de modelos
Você pode enviar modelos de mensagem em vários idiomas, mas o WhatsApp não oferece traduções automáticas. Para enviar mensagens em idiomas diferentes, envie cada versão traduzida separadamente.
As traduções devem seguir as mesmas regras de formatação que o modelo original.
Mantenha os espaços reservados (
{{1}}ou{{variable_name}}) consistentes em todas as traduções.
Seguir estas diretrizes ajudará você a criar modelos de mensagem do WhatsApp que atendam aos requisitos de aprovação do WhatsApp e garantam uma comunicação fluida com seus clientes. Se encontrar problemas, verifique novamente a formatação e a nomenclatura do seu modelo antes de enviá-lo novamente.
Perguntas Frequentes (FAQs)
Regras de Modelos
1. Quais são as regras de variáveis para modelos de mensagem do WhatsApp?
Os modelos de mensagem do WhatsApp não podem conter muitas variáveis em comparação com o comprimento da mensagem. Um modelo também não pode começar ou terminar com uma variável. Por exemplo, {{1}}, seu agendamento está confirmado. é inválido, enquanto Olá {{1}}, seu agendamento está confirmado. é válido.
Desde 1º de outubro de 2025, os modelos que violam essas regras de variáveis são bloqueados no momento da criação, com uma mensagem de erro explicando o problema.
2. O que acontece se modelos de Marketing ou Utilidade forem usados indevidamente para verificação de identidade?
Usar modelos de Marketing ou Utilidade para verificação de identidade em vez de modelos de Autenticação pode resultar em uma aplicação mais rigorosa. O WhatsApp pode impor uma restrição de 7 dias, durante a qual novos modelos de Utilidade não podem ser criados. O uso indevido persistente pode resultar em uma restrição mais longa, de 30 dias.
Variáveis e Conteúdo de Modelos
3. Quais formatos de variável são suportados no Wati?
O Wati suporta variáveis numeradas e nomeadas. As variáveis numeradas usam formatos como {{1}}, {{2}} e {{3}}, enquanto as variáveis nomeadas usam formatos como {{customer_name}} e {{order_number}}. Ambos os formatos realizam a mesma função.
As variáveis devem usar chaves duplas e espaços não devem ser colocados dentro das chaves.
4. Quais são as regras de conteúdo para modelos de mensagem do WhatsApp?
O conteúdo do modelo de mensagem do WhatsApp pode conter texto, letras, dígitos, caracteres especiais, emojis e formatação específica do WhatsApp. O conteúdo pode ter até 1024 caracteres para modelos de Marketing, Utilidade e Autenticação.
Os modelos não podem conter quebras de linha, espaços de tabulação ou mais de quatro espaços consecutivos. Uma Conta do WhatsApp Business pode criar até 100 modelos de mensagem por hora.
Para modelos de Autenticação, o corpo da mensagem só pode usar o conteúdo predefinido fornecido pela Meta, embora instruções adicionais possam ser adicionadas no rodapé.
Nomenclatura de Modelos
5. Quais são as regras de nomenclatura para modelos de mensagem do WhatsApp?
Os nomes dos modelos podem conter apenas caracteres alfanuméricos minúsculos e sublinhados (_). Espaços, letras maiúsculas e outros caracteres especiais não são permitidos. Os nomes dos modelos podem ter até 512 caracteres de comprimento.
Os nomes dos modelos também devem ser descritivos e significativos para que os revisores do WhatsApp e sua equipe possam compreendê-los e gerenciá-los facilmente.
Traduções de Modelos
6. O WhatsApp traduz automaticamente os modelos de mensagem?
Não. O WhatsApp não traduz automaticamente modelos de mensagem. Cada versão traduzida deve ser enviada separadamente.
Os modelos traduzidos devem seguir as mesmas regras de formatação do modelo original, e espaços reservados como {{1}} ou {{variable_name}} devem permanecer consistentes em todas as traduções.
Limite de Caracteres para Modelos de Marketing
7. Qual é o limite de caracteres atual para modelos de Marketing do WhatsApp?
Os modelos de Marketing do WhatsApp suportam até 1024 caracteres. O limite de 550 caracteres introduzido anteriormente para modelos de Marketing foi revertido e não se aplica mais.

