Regras de templates do WhatsApp: o que cada verificação significa e como corrigir

Antes de um template do WhatsApp ir para a análise da Meta, o OmniBrand o verifica contra as regras publicadas pela Meta. As mesmas verificações rodam no seu navegador enquanto você escreve e de novo no nosso servidor quando você pressiona Enviar para análise, então um template que a Meta certamente recusaria nunca sai do OmniBrand. Cada verificação tem um código; esta página explica todas.

Como ler uma verificação

• Correção obrigatória: a Meta vai recusar o template. No criador de templates, Enviar para análise fica desativado até a correção; o painel Verificações lista o problema em Correção obrigatória, com um botão Corrigir quando o OmniBrand pode corrigir por você. Se o servidor ainda encontrar um problema no envio, o criador mostra "A Meta rejeitaria este template, então nada foi enviado. Corrija estes itens e tente novamente:".
• Provável rejeição: um motivo comum de rejeição ou de mudança de categoria. Você ainda pode enviar.
• Dicas: apenas conselhos.
• As verificações marcadas como *diretriz do OmniBrand* são uma regra prática nossa onde a Meta não publica um número; elas nunca são Correção obrigatória.
• Quem pode enviar: membros com a tarefa Gerenciar templates do WhatsApp (Proprietários, Administradores e Editores por padrão; veja Funções e tarefas).

Quando a própria Meta recusa

Se a Meta ainda recusar, o criador diz "A Meta recusou o template:" com as palavras da própria Meta e, quando a Meta envia um número de erro que reconhecemos, a regra correspondente abaixo: 2388299 é VAR_EDGE, 2388293 é VAR_DENSITY, 2388019 é TEMPLATE_QUOTA, 2388039 é EDIT_WHILE_PENDING, 2388040 é BODY_MAX, 2388047 é HEADER_NO_MARKDOWN, 2388072 é VAR_SYNTAX, 2388073 é FOOTER_NO_VARS e 2388024 é NAME_TAKEN_LANG. Nada muda na Meta: um template novo fica no criador como Rascunho (corrija o texto e pressione Enviar para análise de novo), e um já enviado mantém o status (corrija e pressione Salvar alterações de novo).

Em um novo modelo, quando Meta se recusa Enviar para análise, nada é salvo: o construtor permanece aberto com seu texto, então corrija o que Meta nomeou e pressione Enviar para análise novamente. Para guardar uma cópia enquanto trabalha nela, pressione Salvar rascunho primeiro.

NAME_FORMAT (correção obrigatória)

O nome pode usar apenas letras minúsculas do alfabeto inglês, dígitos e sublinhados, até 512 caracteres, por exemplo eid_offer_2026. Substitua espaços por sublinhados e maiúsculas por minúsculas.

NAME_TAKEN_LANG (correção obrigatória)

Esta conta do WhatsApp Business já tem um template com este nome neste idioma. Escolha outro nome ou adicione um idioma diferente ao template existente.

A mensagem tem o link Abra o modelo com esse nome: ele abre o modelo existente, por exemplo, um rascunho que você salvou anteriormente.

NAME_RECENTLY_DELETED (provável rejeição)

Um template com este nome foi excluído há menos de 30 dias. A Meta bloqueia o nome de um template aprovado excluído por 30 dias, então escolha um nome novo ou aguarde.

LANGUAGE_CODE (correção obrigatória)

O código de idioma não é um que o WhatsApp aceita. Use os códigos da Meta: en, en_US, en_GB, ar, ar_EG, ar_AE e assim por diante. Português deve ser pt_BR ou pt_PT.

LANGUAGE_SCRIPT_MISMATCH (provável rejeição, diretriz do OmniBrand)

O texto não parece estar no idioma escolhido: um template em árabe cujo texto quase não está em árabe, ou um em inglês escrito quase todo em árabe. Mude o idioma ou traduza o texto. A Meta nunca traduz; escreva cada idioma separadamente.

CATEGORY_ADVICE (provável rejeição, diretriz do OmniBrand)

Um template de Utilidade ou Autenticação contém palavras promocionais (oferta, desconto, liquidação, عرض، خصم...) ou um botão promocional. A Meta aprova esses templates como Marketing, que custa o preço de marketing e só pode ir para pessoas que concordaram com marketing. Remova a promoção ou escolha Marketing.

AUTH_SHAPE (correção obrigatória)

Os templates de Autenticação têm um formato fixo definido pela Meta: o corpo é "{{1}} é o seu código de verificação.", há um botão de senha de uso único (Copiar código, Preenchimento com um toque ou Zero toque), sem cabeçalho, rodapé, mídia, links ou emoji, e a validade do código é de 1 a 90 minutos. Os botões de um toque e zero toque precisam do nome do pacote e do hash de assinatura do seu app Android. O zero toque também exige que você aceite os termos de zero toque da Meta (a caixa de seleção em Botão no criador).

BODY_REQUIRED (correção obrigatória)

Todo template precisa de um texto no corpo.

BODY_MAX (correção obrigatória)

O corpo é mais longo do que a Meta permite: 1.024 caracteres (600 para uma oferta por tempo limitado). Encurte-o.

HEADER_TEXT_REQUIRED (correção obrigatória)

Você escolheu um cabeçalho de texto mas o deixou vazio. Digite o cabeçalho ou escolha nenhum cabeçalho.

HEADER_TEXT_MAX (correção obrigatória)

Um cabeçalho de texto pode ter no máximo 60 caracteres.

HEADER_ONE_VAR (correção obrigatória)

Um cabeçalho de texto pode ter apenas uma variável.

HEADER_NO_MARKDOWN (correção obrigatória)

O cabeçalho deve ser texto simples: sem caracteres de formatação (* _ ~ `), sem quebras de linha e sem emoji.

HEADER_MEDIA_SAMPLE (correção obrigatória)

Um cabeçalho de imagem, vídeo ou documento precisa de um arquivo de exemplo com o qual a Meta analisa o template. Aceitos: imagens JPEG ou PNG de até 5 MB, vídeos MP4 de até 16 MB, documentos PDF de até 100 MB. O OmniBrand verifica o próprio arquivo, não o nome dele. Um template criado no WhatsApp Manager precisa de um novo exemplo antes de poder ser editado aqui.

HEADER_LOCATION_CATEGORY (correção obrigatória)

Um cabeçalho de localização só é permitido em templates de Marketing e Utilidade.

FOOTER_MAX (correção obrigatória)

O rodapé pode ter no máximo 60 caracteres.

FOOTER_NO_VARS (correção obrigatória)

O rodapé não pode conter variáveis.

VAR_SYNTAX (correção obrigatória)

Uma variável está escrita de forma errada. Variáveis numeradas são escritas {{1}}, {{2}}; as nomeadas, {{first_name}} (letras minúsculas, dígitos e sublinhados). As chaves devem se corresponder, e um template usa números ou nomes, nunca os dois.

VAR_SEQUENTIAL (correção obrigatória)

As variáveis numeradas devem começar em {{1}} e seguir 1, 2, 3 sem lacunas, na ordem em que aparecem pela primeira vez.

VAR_EDGE (correção obrigatória)

O texto começa ou termina com uma variável (erro 2388299 da Meta). Adicione palavras antes da primeira variável e depois da última, por exemplo "Olá {{1}}, seu pedido está pronto." em vez de "{{1}}, seu pedido está pronto".

VAR_ADJACENT (correção obrigatória)

Duas variáveis estão lado a lado, com apenas espaços ou pontuação entre elas. Coloque palavras entre elas.

VAR_DENSITY (provável rejeição, diretriz do OmniBrand)

Há muitas variáveis para o tamanho do texto (erro 2388293 da Meta). A Meta não publica uma proporção exata; avisamos abaixo de 3 palavras de texto fixo por variável, ou quando as variáveis passam de 30% das palavras. Adicione texto ou use menos variáveis.

VAR_EXAMPLE (correção obrigatória)

Toda variável precisa de um valor de exemplo realista, que os revisores da Meta leem. Um exemplo não pode estar vazio, conter quebras de linha, tabulações ou 4 espaços seguidos, ser outra variável ou ser um marcador como "test", "x" ou "name". Use um valor com aparência real, como "Sara" ou "A-1042".

BUTTON_COUNTS (correção obrigatória)

Botões demais: no máximo 10 no total, 10 respostas rápidas, 2 botões de site, 1 botão de chamada, 1 botão de copiar código (e um de cada: Flow, catálogo, lista de produtos e chamada do WhatsApp). Botões de senha de uso único pertencem apenas a templates de autenticação.

BUTTON_TEXT (correção obrigatória)

Todo botão precisa de um rótulo de 1 a 25 caracteres, sem variáveis, e dois botões não podem ter o mesmo rótulo.

BUTTON_GROUPING (correção obrigatória)

Os botões de resposta rápida devem ficar juntos, não misturados entre botões de site ou de chamada. Coloque-os lado a lado.

URL_FORMAT (correção obrigatória)

Um botão de site precisa de um link https:// completo de no máximo 2.000 caracteres. Ele pode terminar com uma variável, escrita {{1}}, por exemplo https://example.com/order/{{1}}, e essa variável precisa de um exemplo (como um número de pedido) sem espaços. Codifique espaços e caracteres não ingleses (%20).

URL_SHORTENER (provável rejeição, diretriz do OmniBrand)

O link usa um encurtador de links (bit.ly, tinyurl, t.co...). Os revisores costumam recusá-los; use um link no seu próprio domínio.

PHONE_FORMAT (correção obrigatória)

Um botão de chamada precisa do número em formato internacional com o código do país, por exemplo +447400123456, com no máximo 20 caracteres.

BUTTONS_DESKTOP (dica)

Com mais de 3 botões, o WhatsApp mostra 2 e coloca o resto em "Ver todas as opções". Com 4 ou mais botões, ou respostas rápidas misturadas com outros botões, o WhatsApp para computador não mostra o template.

CAROUSEL_SHAPE (correção obrigatória)

Um carrossel é apenas de Marketing e tem de 2 a 10 cards. Cada card tem uma imagem ou um vídeo (todos do mesmo tipo), no máximo 2 botões com os mesmos tipos na mesma ordem em todos os cards, e texto do card de no máximo 160 caracteres (em todos os cards ou em nenhum). Não há cabeçalho nem rodapé acima dos cards.

LTO_SHAPE (correção obrigatória)

Uma oferta por tempo limitado é apenas de Marketing: um título da oferta de no máximo 16 caracteres sem variáveis, um cabeçalho de imagem ou vídeo, um corpo de no máximo 600 caracteres, sem rodapé, um botão de copiar código primeiro (código de no máximo 15 caracteres) e no máximo um botão de site depois dele.

COUPON_SHAPE (correção obrigatória)

Um template de cupom tem exatamente um botão de copiar código com um código de exemplo de 1 a 20 caracteres e sem espaços.

CATALOG_SHAPE (correção obrigatória)

Um template de catálogo tem exatamente um botão Ver catálogo, nenhum outro botão e nenhum cabeçalho (o WhatsApp mostra uma imagem de produto).

MPM_SHAPE (correção obrigatória)

Um template de lista de produtos precisa de um cabeçalho de texto e exatamente um botão Ver itens. As seções que você lista em Produtos no criador devem caber no que o WhatsApp consegue mostrar: no máximo 10 seções e 30 produtos no total, cada seção com um título de até 24 caracteres e pelo menos um ID de produto.

FLOW_SHAPE (correção obrigatória)

Um template de Flow precisa de exatamente um botão de Flow que indique um Flow e a tela que ele abre quando navega.

CONTENT_SENSITIVE_ID (provável rejeição, diretriz do OmniBrand)

O texto parece pedir um número completo de cartão, de conta, IBAN ou de documento de identidade. A Meta recusa isso; pedir os últimos 4 dígitos é permitido.

CONTENT_THREAT (provável rejeição, diretriz do OmniBrand)

O texto pode soar ameaçador ou constrangedor ("último aviso", "ação judicial"). A Meta recusa templates abusivos ou ameaçadores. Reescreva com educação.

CONTENT_PROHIBITED (provável rejeição, diretriz do OmniBrand)

O texto menciona algo que as políticas de Negócios e Comércio do WhatsApp proíbem ou restringem, em todos os países: álcool, tabaco, jogos de azar, namoro, criptomoedas ou empréstimos (o cheque também procura drogas e armas). Remova-o.

DUPLICATE (provável rejeição)

Outro template nesta conta do WhatsApp Business tem o mesmo texto. A Meta recusa duplicados; mude o texto ou use o template existente.

EMOJI_DENSE (provável rejeição, diretriz do OmniBrand)

Mais de 10 emoji na mensagem, ou 3 ou mais com mais de um emoji a cada 8 palavras. Use menos.

MARKETING_OPT_OUT (dica)

Um template de Marketing deve dar às pessoas uma forma de parar: adicione uma resposta rápida "Parar promoções" e um rodapé como "Responda STOP para cancelar a inscrição".

TEMPLATE_QUOTA (correção obrigatória)

A conta do WhatsApp Business atingiu o limite de templates da Meta: 250 templates para uma empresa não verificada, 6.000 para uma verificada com nome de exibição aprovado (cada idioma conta). Exclua os templates que você não usa mais.

EDIT_LIMIT (correção obrigatória)

Só templates aprovados, rejeitados ou pausados podem ser editados. Um template aprovado pode ser editado uma vez a cada 24 horas e no máximo 10 vezes em 30 dias; os rejeitados e pausados não têm limite. A mensagem diz quantas horas faltam. Alterar apenas as configurações do próprio OmniBrand (de onde vem o valor de uma variável, o valor alternativo dela) não é uma edição e é sempre permitido.

EDIT_CATEGORY_LOCKED (correção obrigatória)

A categoria de um template aprovado não pode mudar. Crie um novo template na outra categoria.

EDIT_WHILE_PENDING (correção obrigatória)

O template está em análise (PENDING ou IN_APPEAL) e não pode ser editado até a Meta decidir (erro 2388039 da Meta).

MESSAGE_TTL (correção obrigatória)

A Meta não aceita a Validade da mensagem escolhida para esta categoria. Permitido: Autenticação de 30 segundos a 15 minutos, ou 30 dias; Utilidade de 30 segundos a 12 horas, ou 30 dias; Marketing de 12 horas a 30 dias; sempre em segundos inteiros. Corrigir volta o campo ao padrão da Meta. Mudar a categoria para uma que não aceita o período remove-o automaticamente.

MESSAGE_TTL_ADVICE (provável rejeição)

Uma mensagem de autenticação pode chegar depois que o código expirou: a Validade da mensagem (ou o padrão de 10 minutos da Meta) é maior que a validade do código definida em Informar quando o código expira (Minutos). A Meta recomenda uma validade não maior que a do código; Corrigir define a validade igual à do código.

MESSAGE_TTL_ROUTE (dica)

A Meta aplica a validade de um template de marketing às mensagens enviadas com Entrega otimizada (Marketing Messages API). As mensagens de marketing enviadas pela Cloud API comum continuam sendo reenviadas por até 30 dias.

Relacionados

• Criar um template do WhatsApp
• Transmissões do WhatsApp
• Funções e tarefas