WACrew

Guia

Mensagem de template (HSM) no WhatsApp: o que é e quando precisa

Mensagem de template, antes chamada de HSM, é o modelo aprovado pela Meta que a API oficial exige para iniciar conversa fora da janela de 24 horas. Categorias, aprovação e erros comuns.

Atualizado em 1 min de leitura
Nesta página
  1. Como aparece na prática
  2. Erro comum
  3. E nas APIs não oficiais?
  4. Perguntas frequentes

Mensagem de template é um modelo de mensagem aprovado previamente pela Meta, com campos variáveis, que a API oficial do WhatsApp exige para a empresa iniciar uma conversa ou falar fora da janela de 24 horas. O nome antigo, ainda comum no mercado, é HSM (Highly Structured Message).

Como aparece na prática

Você cadastra o texto no gerenciador do WhatsApp Business, com variáveis numeradas, por exemplo: "Olá {{1}}, seu pedido {{2}} foi enviado". A Meta revisa e aprova ou recusa. Depois, sua aplicação manda o template preenchendo as variáveis.

Os templates têm categoria, e a categoria muda o preço e as regras:

  • Marketing: promoção, novidade, convite.
  • Utilidade: atualização de pedido, conta, agendamento.
  • Autenticação: código de acesso.

A cobrança da Meta é por template entregue, com preço por categoria e país. Os valores mudam: consulte a página oficial de preços da plataforma antes de calcular.

Erro comum

Classificar promoção como "utilidade" para pagar menos. A Meta reclassifica ou recusa, e templates recusados repetidamente prejudicam a qualidade do número. Outro erro é escrever template longo e genérico: quanto mais parecido com spam, maior a chance de bloqueio pelos clientes, o que derruba a nota de qualidade.

E nas APIs não oficiais?

Não existe template: você manda texto livre, como no celular. Por isso mesmo a responsabilidade de não incomodar ninguém é toda sua.

Perguntas frequentes

Quanto tempo demora a aprovação? Costuma ser rápida, de minutos a algumas horas, mas pode levar mais.

Posso editar um template aprovado? Pode, e a edição passa por revisão de novo.

Em inglês: message template.