Ir para o conteúdo
OmniChannels.ai
Menu

Ferramenta gratuita

Prévia e validador de modelos do WhatsApp

Escreva seu modelo, adicione variáveis e botões e veja exatamente como ele chega no WhatsApp. Um checklist ao vivo aponta o que a revisão da Meta rejeitaria antes do envio e exporta o payload da API.

Grátis · sem cadastro · no seu navegador

Começar com um exemplo

21/512

Apenas letras minúsculas, números e sublinhados.

Categoria

Avisos que o cliente pediu: pedidos, agendamentos, conta, alertas. Sem conteúdo promocional.

Cabeçalho
23/60
158/1024

Use {{1}}, {{2}}… para variáveis. Formatação: *negrito*, _itálico_, ~tachado~, ```monoespaçado```.

Valores de exemplo

A Meta exige um exemplo realista para cada variável. Os revisores leem esses valores.

39/60

Botões · opcional

Até 10 no total: 10 respostas rápidas, 2 URL, 1 telefone, 1 copiar código.

  1. 1URL
    17/25

    Coloque {{1}} bem no final para um sufixo dinâmico.

  2. 2Telefone
    20/25
    16/20

Prévia ao vivo

Nenhum problema impeditivo. Pronto para enviar para revisão.

Checklist de aprovação

  • OK: O formato do nome é válido.
  • OK: Tamanho do cabeçalho 23/60.
  • OK: Tamanho do corpo 158/1024.
  • OK: 4 variáveis em sequência.
  • OK: Todas as variáveis têm valor de exemplo.
  • OK: Tamanho do rodapé 39/60.
  • OK: 2 botões dentro dos limites e do agrupamento da Meta.
  • OK: Nenhuma linguagem promocional encontrada no modelo de utilidade.

Regras conferidas em outubro de 2026 na documentação oficial da Meta (componentes, revisão e categorização de modelos). Components · Template review · Categorization

JSON do modelo

Corpo da requisição POST /<WABA_ID>/message_templates da WhatsApp Business Management API.

{
  "name": "order_confirmation_pt",
  "language": "pt_BR",
  "category": "UTILITY",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Pedido {{1}} confirmado",
      "example": {
        "header_text": [
          "#48213"
        ]
      }
    },
    {
      "type": "BODY",
      "text": "Olá, {{1}}! Obrigado pelo seu pedido.\n\nRecebemos o pedido *{{2}}* no valor de {{3}} e vamos avisar você assim que ele for enviado. Previsão de entrega: {{4}}.",
      "example": {
        "body_text": [
          [
            "Sara",
            "#48213",
            "R$ 349,00",
            "quinta-feira, 14 de novembro"
          ]
        ]
      }
    },
    {
      "type": "FOOTER",
      "text": "Responda AJUDA para falar com o suporte"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "URL",
          "text": "Acompanhar pedido",
          "url": "https://shop.example.com/pt/orders/{{1}}",
          "example": [
            "48213"
          ]
        },
        {
          "type": "PHONE_NUMBER",
          "text": "Ligar para o suporte",
          "phone_number": "+551100000000"
        }
      ]
    }
  ]
}
Enviar pela API

Precisa enviar dezenas de modelos em vários idiomas? Nossa equipe cria, envia e acompanha as aprovações para você. Falar com um especialista em WhatsApp

Nada do que você digita é enviado aos nossos servidores.

Resposta curta

Um modelo de mensagem do WhatsApp é uma mensagem pré-aprovada que a empresa envia fora da janela de atendimento de 24 horas. A Meta limita o corpo a 1.024 caracteres, o cabeçalho e o rodapé a 60 e o texto de cada botão a 25, com até 10 botões. Variáveis como {{1}} precisam estar em sequência, ter valores de exemplo e não podem abrir nem fechar o corpo. Cada modelo é classificado como marketing, utilidade ou autenticação.

Infraestrutura confiávelMeta Business Solution Provider oficialParceiro Google RBMMembro da GSMAISO/IEC 27001:2022ISO/IEC 27018ISO 9001:2015ISO 22301SOC 2 Type IIEm conformidade com o GDPR

Como visualizar e validar um modelo do WhatsApp

  1. 1

    Escolha categoria e idioma

    Marketing, utilidade ou autenticação e o idioma do modelo. Ou carregue um dos exemplos prontos, em inglês ou árabe.

  2. 2

    Escreva cabeçalho, corpo e rodapé

    Use {{1}}, {{2}} para dados pessoais. Um campo de exemplo aparece para cada variável e a prévia fica com cara de mensagem real.

  3. 3

    Adicione botões

    Respostas rápidas, links com sufixo dinâmico, telefone ou código de oferta para copiar, sempre dentro dos limites da Meta.

  4. 4

    Corrija e exporte

    Resolva cada item vermelho, revise os alertas e copie o JSON para a WhatsApp Business Management API.

Limites de caracteres dos modelos do WhatsApp

A documentação da Meta sobre componentes de modelo define limites rígidos para cada parte. Se passar deles, a API rejeita o modelo antes que qualquer revisor o veja, então vale checar enquanto escreve.

Os caracteres são contados como você os vê: um emoji ou uma letra árabe conta como um. Quebras de linha também contam, assim como os caracteres de formatação, como os asteriscos de *negrito*.

Fonte: Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (conferido em outubro de 2026).

  • Nome do modelo: até 512 caracteres, apenas letras minúsculas, números e sublinhados.
  • Cabeçalho de texto: até 60 caracteres e no máximo 1 variável. O cabeçalho de mídia pode ser imagem, vídeo ou documento; o de localização só vale para utilidade e marketing.
  • Corpo: até 1.024 caracteres, obrigatório, com quantas variáveis forem necessárias.
  • Rodapé: até 60 caracteres, sem variáveis.
  • Botões: até 10 no total, sendo no máximo 10 respostas rápidas, 2 botões de URL, 1 de telefone e 1 de copiar código. Texto do botão: 25 caracteres; URL: 2.000; telefone: 20; código: 20.

Regras de variáveis que causam rejeição

A maioria dos modelos rejeitados falha nas variáveis, não no texto. O guia de revisão da Meta lista os problemas: variáveis fora de sequência, com caracteres especiais como #, $ ou %, chaves desencontradas ou posicionadas logo no início ou no fim da mensagem.

A Meta também rejeita modelos com variáveis demais para o tamanho. Ela não publica uma proporção exata, então a ferramenta alerta quando há menos de três palavras fixas por variável. Os revisores também costumam rejeitar duas variáveis coladas, como {{1}} {{2}}: junte-as ou separe-as com palavras.

Cada variável precisa de um exemplo realista no envio para revisão. Os revisores leem os exemplos para entender a mensagem; "teste" ou "xxx" é pedir rejeição.

Fonte: Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.

Modelo rejeitado? Decifre o motivo da Meta

Mude para a aba "Rejeitado? Cole o motivo da Meta" e cole o motivo do WhatsApp Manager, do Business Support Home, do e-mail de rejeição ou do webhook message_template_status_update. A ferramenta reconhece os códigos da Meta, como INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM e ABUSIVE_CONTENT, e a redação das causas comuns do guia de revisão de modelos, e mostra a causa provável e a correção.

Um modelo rejeitado pode ser editado e reenviado, ou você pode recorrer no WhatsApp Manager depois de adicionar valores de exemplo; a Meta informa que os recursos são decididos em até 24 horas. O motivo NONE significa que o modelo foi pausado, não rejeitado.

Utilidade, marketing ou autenticação

A categoria define aprovação e preço. Modelos de utilidade dão sequência a algo que o cliente fez ou pediu, como pedido, agendamento, alteração de conta ou alerta, e não podem ter promoção. Modelos de autenticação levam códigos de uso único com texto fixo da Meta. Todo o resto, inclusive lembretes de carrinho, ofertas e reengajamento, é marketing.

Pelas diretrizes de categorização da Meta, um modelo que mistura conteúdo de utilidade e promocional é marketing. Cupons de desconto, ofertas, upsell, lembretes de carrinho e convites para baixar o app levam o modelo para marketing. A Meta revisa periodicamente os modelos aprovados e move para marketing os de utilidade com tom promocional, geralmente com um dia de aviso.

A ferramenta analisa seu texto em português, inglês, árabe, francês, espanhol e alemão em busca de termos promocionais e avisa antes que a Meta reclassifique o modelo. Como só modelos de autenticação podem enviar códigos de uso único, ela também sinaliza linguagem de OTP em outras categorias.

Fonte: Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.

Botões: agrupamento, URL dinâmica e o que o cliente vê

Respostas rápidas e botões de ação precisam ficar agrupados: todas as respostas rápidas antes dos outros botões ou todas depois. Uma resposta rápida entre dois links é rejeitada pela API.

Um botão de URL aceita uma variável, no final da URL, por exemplo https://shop.example.com/orders/{{1}}. Codifique o valor enviado (espaço vira %20) e evite encurtadores de link: eles escondem o destino e parecem spam.

Com mais de três botões, o WhatsApp mostra dois e agrupa o restante em "Ver todas as opções". Modelos com quatro ou mais botões, ou com respostas rápidas junto de outros botões, não aparecem no WhatsApp para computador, então coloque a ação mais importante primeiro.

Da prévia ao envio em escala

O JSON exportado segue o corpo da requisição POST /<WABA_ID>/message_templates da WhatsApp Business Management API, com os valores de exemplo. Para cabeçalhos de mídia, envie um arquivo de exemplo pela Resumable Upload API e substitua o identificador fictício.

Depois de aprovado, o modelo é enviado pelo nome e idioma com os valores reais. A OmniChannels.ai gerencia modelos em várias contas do WhatsApp Business, acompanha revisão e qualidade e envia os modelos aprovados por uma única API REST, campanhas ou a caixa de entrada compartilhada, com fallback para SMS quando o WhatsApp não está disponível.

Perguntas sobre modelos do WhatsApp

Qual é o limite de caracteres de um modelo do WhatsApp?

O corpo aceita até 1.024 caracteres. Cabeçalho de texto e rodapé têm até 60 caracteres cada, e o texto de cada botão até 25. Modelos de autenticação usam o texto fixo da Meta, e o parâmetro do código tem no máximo 15 caracteres.

Por que meu modelo do WhatsApp foi rejeitado?

Os motivos mais comuns são problemas de variáveis (fora de sequência, no início ou no fim do corpo, com caracteres especiais ou em excesso), exemplos ausentes ou irreais, conteúdo promocional em modelo de utilidade, violação de políticas e texto igual ao de um modelo existente.

O que significam INVALID_FORMAT e INCORRECT_CATEGORY?

São códigos que a Meta envia ao rejeitar um modelo. INVALID_FORMAT indica que a estrutura viola uma regra de formato, quase sempre nas variáveis, e vem com um motivo detalhado e uma recomendação. INCORRECT_CATEGORY, assim como TAG_CONTENT_MISMATCH, indica que o conteúdo não corresponde à categoria escolhida. Cole o código na aba Rejeitado para ver a correção.

Qual a diferença entre modelo de utilidade e de marketing?

O de utilidade confirma ou atualiza algo que o cliente fez ou pediu, como pedido, pagamento, agendamento ou alteração de conta, sem promoção. O de marketing divulga produtos, ofertas ou busca reengajar. Misturar os dois transforma o modelo em marketing, que custa mais.

Uma variável pode ficar no início ou no fim do modelo?

Não. A Meta rejeita modelos cujo corpo começa ou termina com variável. Escreva "Olá {{1}}, seu pedido está pronto." em vez de "{{1}}, seu pedido está pronto" ou "O número do seu pedido é {{1}}".

Quantos botões um modelo do WhatsApp pode ter?

Até 10: no máximo 10 respostas rápidas, 2 botões de URL, 1 de telefone e 1 de copiar código. As respostas rápidas precisam ficar agrupadas, antes ou depois dos outros botões.

Como coloco um link dinâmico em um botão?

Coloque uma única variável no final da URL, por exemplo https://example.com/track/{{1}}, com um valor de exemplo. No envio, passe só o sufixo, codificado.

Posso enviar um modelo do WhatsApp em árabe?

Sim. Crie o modelo com o código de idioma ar e escreva o texto em árabe. A Meta não traduz modelos: cada idioma é um modelo separado com o mesmo nome e conta no seu limite.

Quanto tempo leva a aprovação de um modelo do WhatsApp?

A maioria é revisada automaticamente em minutos; a Meta informa que a revisão pode levar até 24 horas. Modelos que passam por este validador evitam as rejeições automáticas mais comuns.

Mais ferramentas gratuitas