O que é um template (HSM) e quando ele é obrigatório
Template é uma mensagem com texto fixo e espaços para variáveis, que a Meta revisa antes de você poder enviar. Ele é obrigatório em um caso: quando a empresa escreve para alguém fora da janela de 24 horas, ou seja, sem que o cliente tenha mandado mensagem no último dia. Lembrete de consulta, aviso de envio, boleto vencendo, campanha de Black Friday: tudo isso sai como template. Dentro da janela, a resposta pode ser texto livre.
Isso só existe na API. No app WhatsApp Business não há template aprovado, há mensagem rápida e respostas automáticas, que funcionam de outro jeito. Se a sua empresa ainda não tem número na plataforma, o primeiro passo está em como ter a API oficial do WhatsApp.
Marketing, utilidade ou autenticação: qual escolher
Cada template pertence a uma categoria, e ela muda duas coisas: o preço por mensagem entregue e o rigor da revisão. A regra da Meta para utilidade é estreita. A mensagem não pode ter intenção promocional e precisa ser específica de algo que o cliente pediu ou fez, ou essencial para ele. Na dúvida, a Meta classifica como marketing.
| Categoria | Para que serve | Exemplo brasileiro | Preço por mensagem no Brasil* | O que derruba |
|---|---|---|---|---|
| Utilidade | Confirmar, avisar ou atualizar algo do cliente | “Sua consulta é amanhã às 9h. Confirme pelo botão.” | R$ 0,0350 (US$ 0,0068) | Cupom, oferta, “aproveite também”, pesquisa genérica |
| Autenticação | Enviar código de acesso de uso único | Código de login no app de um banco ou de uma loja | R$ 0,0350 (US$ 0,0068) | Link, mídia ou emoji no texto; código com mais de 15 caracteres |
| Marketing | Promoção, novidade, reengajamento, qualquer mistura | “Black Friday: 20% off no Pix até domingo.” | R$ 0,3217 (US$ 0,0625) | Raramente a categoria; costuma ser o conteúdo (spam, golpe) |
*Tarifas da tabela oficial da Meta para números brasileiros, consultada em 30 de julho de 2026 e detalhada em preços da API do WhatsApp em 2026. A Meta pode revisar a tabela até uma vez por trimestre; confira a vigente antes de orçar. Utilidade e autenticação têm desconto por volume a partir de 250 mil mensagens no mês.
Autenticação é a categoria mais engessada. O texto vem pronto da Meta, você só escolhe opções como o aviso de segurança e a validade do código, e o botão é de código de uso único. Ela serve para login e confirmação de identidade, e para nada além disso.
Passo a passo no WhatsApp Manager
1Decida a categoria antes de escrever a primeira linha
Pergunte o que a mensagem faz. Ela confirma, avisa ou atualiza algo que o cliente pediu ou comprou (pedido, consulta, boleto)? É utilidade. Ela envia um código de acesso de uso único? É autenticação, e só essa categoria pode mandar código. Qualquer outra coisa, inclusive um aviso de pedido com cupom no final, é marketing. A categoria define o preço por mensagem e as regras de revisão, e um template aprovado não pode ter a categoria editada depois. Escolher errado custa um modelo novo.
2Abra a tela de modelos no WhatsApp Manager
No Gerenciador do WhatsApp (WhatsApp Manager), dentro do portfólio empresarial da Meta, entre em Ferramentas da conta (o ícone de maleta) e depois em Modelos de mensagem. Clique em Criar modelo. Se você usa uma plataforma (SendPulse, Wati, Blip, Zenvia e outras), ela costuma ter a própria tela, que envia o mesmo pedido para a Meta pela API. Os rótulos exatos mudam com a versão da interface e o idioma da conta.
3Dê um nome e escolha o idioma pt_BR
O nome aceita só letras minúsculas, números e sublinhado, até 512 caracteres: pedido_enviado_v2 serve, Pedido Enviado não. Escolha português do Brasil (pt_BR). A Meta não traduz nada: se você atende em espanhol também, cria uma segunda versão com o mesmo nome e o idioma es, e cada versão conta no limite de templates da conta.
4Monte cabeçalho, corpo, rodapé e botões
O corpo é obrigatório e vai até 1.024 caracteres. O cabeçalho é opcional e pode ser texto (até 60 caracteres), imagem, vídeo, documento ou localização. O rodapé, também opcional, vai até 60 caracteres. Botões são até 10 no total, entre resposta rápida, link, telefone e copiar código, com rótulo de até 25 caracteres. Escreva como se o cliente fosse ler no ponto de ônibus: a informação principal na primeira frase.
5Coloque variáveis no meio do texto e preencha os exemplos
Variáveis são o que muda a cada envio: nome, número do pedido, horário. Podem ser posicionais, como {{1}} e {{2}}, ou nomeadas, como {{nome}}. Duas regras derrubam muito modelo: o texto não pode começar nem terminar com uma variável, e toda variável precisa de um valor de exemplo no envio para revisão. Use exemplos realistas (Ana, #4821, 14h30), nunca dados reais de cliente.
6Envie para revisão e acompanhe o status
A revisão é automática e pode levar até 24 horas. O modelo sai de Em análise para Ativo (com a qualidade ainda pendente) ou Rejeitado, e só um template aprovado pode ser enviado. Quem integra pela API recebe a mudança pelo webhook message_template_status_update. Antes de usar numa campanha, mande o template para o seu próprio número: se chegou com nome e botão funcionando, está pronto.
Para não estourar 1.024 caracteres no corpo, 60 no cabeçalho ou 25 no botão, cole o rascunho no contador de caracteres para WhatsApp, que compara o texto com esses limites. Negrito e itálico também valem dentro do template, com a mesma sintaxe do app; o gerador de texto formatado monta os asteriscos e sublinhados por você.
Como criar o template pela Cloud API
Quem integra direto com a Meta, sem painel de plataforma, cria o modelo com uma chamada POST para o endpoint message_templates da conta WhatsApp Business (WABA). O exemplo abaixo é um aviso de envio de uma loja virtual, em utilidade, com duas variáveis nomeadas no corpo e um botão de rastreio cujo final do link muda a cada pedido. Repare que o corpo termina em texto, não em variável.
POST https://graph.facebook.com/<VERSAO>/<WABA_ID>/message_templates
{
"name": "pedido_enviado",
"language": "pt_BR",
"category": "UTILITY",
"parameter_format": "named",
"components": [
{
"type": "BODY",
"text": "Oi, {{nome}}! Seu pedido {{pedido}} saiu para entrega hoje. Acompanhe pelo botão abaixo.",
"example": {
"body_text_named_params": [
{ "param_name": "nome", "example": "Ana" },
{ "param_name": "pedido", "example": "#4821" }
]
}
},
{ "type": "FOOTER", "text": "Loja Exemplo · avisos do seu pedido" },
{
"type": "BUTTONS",
"buttons": [
{
"type": "URL",
"text": "Rastrear pedido",
"url": "https://exemplo.com.br/rastreio/{{1}}",
"example": ["https://exemplo.com.br/rastreio/4821"]
}
]
}
]
}A resposta volta com o id do template e o status PENDING. A versão da Graph API e o id da WABA saem do seu app na Meta. Para consultar o andamento depois, um GET no mesmo endpoint com o campo status devolve o estado atual; se o nome já existir naquele idioma, a Meta responde com o erro 100, subcódigo 2388024.
Variáveis e botões: as regras que mais travam
Formato posicional ({{1}}, {{2}}) é o padrão, e os exemplos precisam seguir a ordem em que aparecem. Formato nomeado ({{nome}}, {{data_consulta}}) aceita só minúsculas e sublinhado, e cada nome é único no template. Os dois exigem um exemplo por variável. Na prática, o que mais devolve modelo é a proporção: uma frase de cinco palavras com três variáveis parece texto em branco para o revisor, que pede mais texto ou menos variáveis.
Nos botões, a resposta rápida (“Confirmar”, “Remarcar”) é a que mais ajuda o atendimento, porque a resposta do cliente abre a janela de 24 horas. Botão de link aceita uma variável no fim da URL, como no exemplo acima. Botão de telefone guarda até 20 caracteres no número. E cabeçalho com imagem ou vídeo exige que a mídia de exemplo seja enviada junto, porque ela também passa pela revisão.
Sem ideia de texto? Comece de um modelo pronto
A biblioteca do zapfunil tem mensagens de confirmação, cobrança, pós-venda e boas-vindas escritas para negócio brasileiro. Copie, troque os dados por variáveis e leve para o WhatsApp Manager. Grátis, sem cadastro.
Ver mensagens prontas →Por que o template foi rejeitado (e como conferir que corrigiu)
O motivo da rejeição aparece no Business Support Home (Visão geral da conta, sua conta da Meta, a WABA, Modelos de mensagem rejeitados) e chega por e-mail aos administradores. Os casos mais comuns, com o teste para saber se resolveu:
- Variável no começo ou no fim. “{{1}}, sua fatura venceu” é recusado. Reescreva para “Oi, {{1}}! Sua fatura…” e confira: a primeira e a última palavra do corpo são texto fixo.
- Numeração pulando ou fora de ordem. {{1}}, {{2}}, {{5}} não passa. Conte as variáveis e veja se vão de 1 até o total, sem buraco.
- Caractere especial dentro da variável. # , $ e % não entram no espaço da variável. Deixe “R$” no texto fixo e a variável só com o número: “R$ {{valor}}”.
- Pedido de dado sensível. “Envie o número do seu cartão” ou do RG completo derruba o modelo. Os últimos quatro dígitos são permitidos. Teste: nenhum trecho pede que o cliente digite um documento inteiro.
- Cobrança em tom de ameaça. “Seu nome vai para o Serasa amanhã” cai em conteúdo abusivo. Informe vencimento, valor e o link do Pix, sem ameaça; o gerador de mensagem de cobrança ajuda no tom.
- Texto repetido. Corpo e rodapé idênticos a outro template da conta são recusados (a regra não vale para autenticação). Se é só para mudar um botão, edite o modelo existente em vez de criar outro.
Para recorrer, edite o template no WhatsApp Manager, inclua o exemplo pelo botão de amostra e envie. A decisão sai em até 24 horas. Template aprovado não quer dizer template seguro: se muita gente bloquear ou denunciar, ele passa a qualidade média ou baixa e pode ser pausado ou desativado. Quem dispara em volume encontra o controle de qualidade em como fazer disparo em massa no WhatsApp.
Quando a Meta muda a categoria do seu template
Desde 9 de abril de 2025, um template enviado como utilidade que a Meta entenda ser marketing é aprovado direto como marketing. Antes disso era preciso marcar uma opção para aceitar a troca; agora é o comportamento padrão. Além disso, a Meta revisa templates já aprovados de forma recorrente, avisa com 24 horas de antecedência e muda a categoria mantendo o status de aprovado. Para empresas já advertidas por uso indevido, desde 16 de abril de 2025 a troca é imediata, sem aviso.
O problema é que a troca quase nunca aparece na tela de quem dispara. Ela aparece na fatura. Faça a conta de uma clínica odontológica em Campinas que manda 800 lembretes de consulta por mês, na véspera, quando o paciente não escreveu:
- Como utilidade: 800 × R$ 0,0350 = R$ 28,00 por mês.
- Reclassificado como marketing (porque alguém acrescentou “aproveite e agende sua limpeza com 15% off”): 800 × R$ 0,3217 = R$ 257,36 por mês.
Uma frase promocional custou R$ 229,36 por mês, ou R$ 2.752,32 em um ano, pelo mesmo número de mensagens. A calculadora de custo da API refaz a conta com o seu volume. Para conferir se algum template seu foi marcado, há três sinais: o e-mail aos administradores, o aviso no WhatsApp Manager (com uma planilha CSV dos modelos afetados) e, pela API, o campo correct_category, consultado com GET /<WABA_ID>/message_templates?fields=category,correct_category. Se correct_category vier vazio, o template não foi afetado.
Discordou? Você tem 60 dias para pedir revisão no Business Support Home, em atualizações de categoria. Se a Meta aceitar, o template volta para utilidade. Insistir em mandar marketing disfarçado tem outro custo: depois de uma advertência por escrito, a Meta pode bloquear o envio de utilidade da conta por 7 dias (30 dias em caso de reincidência), e nesse período não dá para criar modelo novo da categoria.
Limites de quantidade, edição e exclusão
| Regra | Limite oficial | O que isso muda na prática |
|---|---|---|
| Templates por conta (portfólio não verificado) | 250 | Cada idioma conta; 125 modelos em pt_BR e es já lotam |
| Templates por conta (portfólio verificado) | 6.000 | Exige empresa verificada e um número com nome de exibição aprovado (veja como verificar a empresa) |
| Criação | 100 por hora | Importação em lote precisa ser fatiada |
| Edição de template aprovado | 10 em 30 dias, 1 a cada 24 horas | Corrija tudo de uma vez; rejeitado ou pausado edita sem limite |
| Nome após excluir um aprovado | Bloqueado por 30 dias | Use sufixo de versão (_v2) em vez de apagar e recriar |
| Template sem uso | Arquivado após 12 meses, apagado 28 dias depois | Modelo sazonal (Natal, Black Friday) precisa de um envio por ano |
Criar na Meta ou na plataforma que você já usa
O template é da sua conta WhatsApp Business, não da plataforma: um modelo aprovado no WhatsApp Manager aparece nos provedores conectados à mesma WABA, e vice-versa. A diferença está no trabalho do dia a dia. Plataformas como as do nosso comparativo de provedores de API oficial mostram o status da revisão na própria tela, preenchem os exemplos e ligam o template à lista de contatos do disparo. Algumas cobram margem sobre a tarifa da Meta, então compare o preço por mensagem, não só a mensalidade.
Perguntas frequentes
O que é um template HSM no WhatsApp?
HSM (Highly Structured Message) é o nome antigo do que a Meta hoje chama de modelo de mensagem, ou template. É um texto pré-aprovado, com espaços para variáveis, que a empresa usa para escrever ao cliente fora da janela de 24 horas. Dentro da janela, depois que o cliente mandou mensagem, a empresa pode responder com texto livre; fora dela, só com template aprovado.
Quanto tempo a Meta leva para aprovar um template?
A documentação da Meta fala em até 24 horas. Muitos modelos simples voltam antes, mas planeje com o prazo cheio: não marque a campanha para o mesmo dia em que vai criar o template. Se ele for rejeitado e você recorrer, a Meta informa decisão também em até 24 horas.
Qual a diferença entre template de marketing, utilidade e autenticação?
Utilidade é o aviso ligado a algo que o cliente pediu ou fez (pedido, consulta, pagamento), sem nenhuma promoção. Autenticação envia código de acesso de uso único, com texto fixo e botão de código. Marketing é todo o resto, incluindo mensagem mista, pesquisa genérica e retargeting. Na tabela da Meta para o Brasil consultada pela redação, marketing custa R$ 0,3217 por mensagem entregue, e utilidade e autenticação, R$ 0,0350.
Por que meu template do WhatsApp foi rejeitado?
Os motivos que a Meta lista são de dois tipos. Formato: chaves erradas nas variáveis, numeração fora de ordem, variável no começo ou no fim do texto, caracteres como # e % dentro da variável, variáveis demais para pouco texto e falta de exemplo. Conteúdo: pedido de dado sensível (número completo de cartão, de conta ou de documento), ameaça ou cobrança agressiva, cara de golpe e texto idêntico a outro template seu. O motivo aparece no Business Support Home e chega por e-mail.
Como contestar a rejeição ou a mudança de categoria de um template?
Para rejeição, edite o template no WhatsApp Manager, adicione o exemplo pelo botão de amostra e envie de novo; a Meta decide em até 24 horas. Para mudança de categoria (utilidade que virou marketing), o pedido de revisão é feito no Business Support Home, na área de atualizações de categoria, e há 60 dias para isso. Se a revisão for aceita, o template volta à categoria original.
Posso usar template para mensagem dentro da janela de 24 horas?
Pode, mas não precisa. Dentro da janela você responde com texto livre. Vale lembrar o preço: desde 1º de outubro de 2026 a Meta cobra também as respostas de atendimento e as mensagens de utilidade enviadas dentro da janela, na tarifa de utilidade de cada mercado, depois de uma franquia mensal gratuita por número (a conta completa está no nosso guia da API oficial). A janela gratuita de 72 horas aberta por anúncio de clique para o WhatsApp continua valendo.
Quantos templates posso criar na API do WhatsApp?
Até 250 por conta WhatsApp Business se o portfólio da empresa não for verificado. Com o portfólio verificado e pelo menos um número com nome de exibição aprovado, o teto sobe para 6.000 por conta. Há também um limite de criação de 100 templates por hora, e cada idioma de um mesmo template conta como um modelo.
Dá para editar um template já aprovado?
Dá, com limite: até 10 edições em 30 dias e no máximo uma a cada 24 horas. Você pode mudar os componentes (texto, botões, cabeçalho) e o tempo de validade, mas não a categoria. Templates rejeitados ou pausados podem ser editados sem limite. Se apagar um template aprovado, o mesmo nome fica bloqueado por 30 dias.
Como apuramos
As regras de nome, idioma, variáveis, status, quantidade e arquivamento vêm da página Template fundamentals da Meta; edição e exclusão, de Template management; motivos de rejeição e recurso, de Template review; categorias, datas de reclassificação e restrições, de Template categorization; limites de componentes e o formato do exemplo, de Utility templates; a cobrança das mensagens de atendimento desde outubro, de Pricing updates. Todas consultadas em 11 de novembro de 2026. As tarifas em real são da tabela da Meta consultada em 30 de julho de 2026.
O que não fizemos: não criamos nem enviamos um template para revisão numa conta própria para este guia. Os nomes de menu do WhatsApp Manager seguem a documentação e podem mudar de rótulo na sua interface. O JSON de exemplo segue o formato da documentação, com loja, link e dados fictícios. O limite de 60 caracteres do cabeçalho de texto é o aplicado pelo WhatsApp Manager; a página de utilidade da Meta não o repete.
