WACrew

Guide

WhatsApp message templates (HSM): what they are and when you need one

A message template, once called HSM, is the Meta-approved message the official API requires to start a conversation outside the 24-hour window. Categories, approval and common mistakes.

Updated 1 min read
On this page
  1. Where you meet it
  2. Common mistake
  3. And on unofficial APIs?
  4. Questions

A message template is a message pre-approved by Meta, with variable fields, that the official WhatsApp API requires for a business to start a conversation or write outside the 24-hour window. Its old name, still common, is HSM (Highly Structured Message).

Where you meet it

You register the text in WhatsApp Business Manager with numbered variables, for example: "Hi {{1}}, your order {{2}} has shipped". Meta reviews it and approves or rejects it. Your app then sends the template and fills the variables.

Templates have a category, and the category changes price and rules:

  • Marketing: promotions, news, invitations.
  • Utility: order, account or appointment updates.
  • Authentication: one-time codes.

Meta charges per delivered template, priced by category and country. Rates change, so check the platform's official pricing page before you budget.

Common mistake

Filing a promotion as "utility" to pay less. Meta reclassifies or rejects it, and repeated rejections hurt the number's quality rating. Another one is writing long, generic templates: the more they look like spam, the more people block, and the quality rating drops.

And on unofficial APIs?

There are no templates: you send free text, like on your phone. Which is exactly why not bothering people is entirely on you.

Questions

How long does approval take? Usually minutes to a few hours, sometimes longer.

Can I edit an approved template? Yes, and the edit goes through review again.

In Portuguese: mensagem de template.