GlossaryTopic

WhatsApp Message Template (HSM)

Term 124 of 129 · Topic

In one sentence

A WhatsApp message template (HSM), also called an approved template, is a message pre-approved by Meta that a business uses to start conversations with customers on the WhatsApp Business API, outside the 24-hour window, with fixed text and editable variables.

Reviewed by Juan Manuel Garrido

Co-founder of VantegrateLinkedIn

Definition

A WhatsApp message template, also called an approved template or HSM (Highly Structured Message, its original name), is a message format pre-approved by Meta that a business must use to start a conversation with a customer through the WhatsApp Business API. Unlike a free-form message, a template has a fixed structure that Meta reviews and approves before it can be sent, which ensures the content complies with the platform's policies and reduces spam.

The reason it exists is the 24-hour window: a business can only send free-form messages during the 24 hours after the customer's last message. Once that window has passed, or when the business wants to be the first to write (a payment reminder, a shipping confirmation, a notification), it can only do so with an approved template. That is why templates are the piece that enables proactive communication on WhatsApp.

In practice, templates are the format behind bulk sends and the proactive notifications that a marketing tool like Revio automates, where they are designed, submitted for approval and triggered by business events. They are also the mechanism behind the automatic notices sent by an agent such as Sellium: without an approved template, that first message simply does not exist in the API.

How a template is built

A WhatsApp template is assembled from well-defined blocks. It has a required body (the main text, which can include variables such as {{1}} for the name or the order number) and optional blocks: a header (text, image, video or document), a footer and buttons (quick reply, call to action such as "View order" or "Call", or marketing buttons with an opt-out option). Variables are the mechanism that makes it possible to personalize at scale: the template is approved once and then each send fills in the fields with each customer's data.

Every template must be declared under a category, and the category defines both the approval rules and the cost. Meta recognizes three:

CategoryWhat it is forTypical example
UtilityInformation about a transaction the customer already startedPurchase confirmation, shipping notice, appointment reminder
MarketingPromotions, news, reactivationOffer of the month, product launch, abandoned cart recovery
AuthenticationOne-time verification codesLogin OTP code

This distinction matters because Meta's per-message pricing varies by category, and because Meta is much stricter when approving marketing templates. A utility template misclassified as marketing, or vice versa, can be rejected or recategorized automatically.

The approval cycle

Before sending a template you have to submit it for review. Meta reviews it with a combination of automated systems and manual review, and the decision can take up to 24 hours. It checks that the text is not misleading, that the variables are well formed, that there are no formatting errors and that the declared category matches the actual content. Once approved, the template is ready to use; if you edit it, it goes back into review.

The most frequent rejection reasons in Latin America tend to be: consecutive variables with no text between them, promotional content declared as utility, suspicious shortened links, obvious spelling mistakes, or language that Meta reads as spam. A rejected template does not penalize the account, but it does stall the campaign until you fix it and resubmit it, with no limit on attempts, or appeal the decision.

One point that is often overlooked: an approved template does not stay approved forever. Meta monitors how each template behaves in production, and if it piles up negative feedback from customers, such as spam reports or blocks, or a low read rate, it can lower its quality rating, pause it or disable it. Approval is a conditional permission, not a blank check.

Approved template vs service message

This is the most important distinction in the channel. The service message, also called a session message, is the free-form text the business sends within the 24-hour window: it needs no approval and accepts any content. Each number gets 1,000 free service messages per month; after that, they are paid at the country's utility rate. The approved template is the opposite: a fixed format, prior approval, and it is the only thing available when that window is closed. Both combine in a real conversation: a template reopens the contact, the customer replies, the window opens and the chat continues with free-form text until the issue is resolved.

You can also send a template while the window is open, but it is not free: under Meta's per-message pricing, every template is charged according to its category and the recipient's country, and a utility template is billed inside the window too, at the utility rate.

Why it matters for the business

The template is what makes WhatsApp a proactive and measurable channel, not just a reactive one. It lets you tell a customer their order has shipped, remind them of an unpaid installment, confirm an appointment or recover an abandoned cart, all automated and at scale. With email, the average open rate is around 35.6% and the click rate is under 3% (Mailchimp, 2023); a template, by contrast, lands in the app the customer already uses to chat with their contacts, which makes it an attractive channel for critical notifications.

That said, this power comes with responsibility. Overusing marketing templates, or sending them to contacts who did not give their opt-in, damages the number's quality rating and can trigger the messaging limit, reducing how many messages you can send per day. That is why a good template strategy balances utility and marketing, respects consent and keeps frequency under control.

A concrete example in Argentina

Picture an apparel e-commerce business in Buenos Aires. A customer buys a jacket. As soon as the payment is confirmed, the system triggers a utility template: "Hi {{1}}, we received your order #{{2}}. We'll let you know when it ships." Two days later, when the package is dispatched, another utility template shares the tracking code. A week later, if the customer gave consent, a marketing template offers a discount on accessories. Each one is approved for its category, personalized with variables and triggered by a business event. What feels like a smooth conversation to the customer is, behind the scenes, a sequence of orchestrated templates.

Common mistakes to avoid

  • Sending marketing templates without explicit opt-in, which triggers reports and lowers the quality rating
  • Classifying a clearly promotional message as utility, risking rejection or recategorization
  • Overwhelming the customer with too many sends in a few days, which leads to blocks
  • Forgetting that every edit restarts the approval cycle
  • Not previewing how variables render, leaving text like "Hi {{1}}" visible to the customer
  • Writing generic templates such as "we have news for you", which generate blocks and damage the number's quality
  • Not offering a clear way off the list (opt-out), which multiplies spam reports
  • Believing approval is permanent: reports and blocks can pause a template that was already approved
In practice

Automatic due-date reminder

An electrical supplies distributor in Córdoba, Argentina, replaces its collection calls with an approved utility template: "Hi {{1}}, your invoice {{2}} is due on {{3}}. Would you like the payment link?". It goes out on its own three days before the due date, outside any open window. When the customer replies, the 24-hour window opens and the payment follow-up continues with free-form text. Without a template, that first proactive contact would be impossible in the API.

Share
Frequently asked questions

FAQs about WhatsApp Message Template (HSM)

What is a WhatsApp message template (HSM)?

It is a message pre-approved by Meta, also called an approved template or HSM (Highly Structured Message), that a business uses to start conversations with its customers through the WhatsApp Business API. It has fixed text with editable variables and must go through a Meta review before it can be sent. It is the only format allowed to message a customer outside the 24-hour window or when the business wants to make the first contact.

When do you have to use a template instead of a free-form message?

It is required when the business wants to start a conversation or when more than 24 hours have passed since the customer's last message. Within that 24-hour window the business can reply with free-form text, but outside it, or to write first, it can only do so with an approved template. That is why notifications, reminders and proactive campaigns always use templates.

How long does Meta take to approve a WhatsApp template?

According to Meta, the decision can take up to 24 hours: the review combines automated systems and manual review, and it checks that the content is not misleading, that the variables are well formed, that there are no obvious errors and that the declared category (utility, marketing or authentication) matches the actual content of the message. If it is rejected, you fix it and resubmit it with no limit on attempts, or appeal the decision, and the account is not penalized.

What are the WhatsApp template categories?

Meta recognizes three categories. Utility, to report on a transaction the customer already started (confirmations, shipping notices, appointment reminders). Marketing, for promotions, news and reactivation. And Authentication, for one-time verification codes such as OTPs. The category defines the approval rules and the cost of each message, so classifying each template correctly is key.

Why does a WhatsApp template get rejected?

The most frequent reasons are: declaring as utility a message that is actually promotional, using consecutive variables with no text between them, including suspicious shortened links, having obvious spelling mistakes or using language that Meta reads as spam. A rejection does not penalize the account, but it stalls the campaign until you fix the problem and resubmit the template for review.

Are HSM and approved template the same thing?

Yes. HSM (Highly Structured Message) is the name used in WhatsApp's original documentation, and approved template is how it is known because of the prior approval requirement. Meta calls them message templates. Many vendors and technical teams still use the old acronym, but they mean exactly the same object: a fixed-format message that requires prior approval.

Can I send a template within the 24-hour window?

Yes. Under Meta's pricing, a utility template sent within an open service window is billed at the utility rate, just like one sent outside it; free-form replies in the window are service messages, with 1,000 free per number per month. Outside the window, every template is charged according to its category (utility, marketing or authentication) and the recipient's country.

What happens if I send marketing without opt-in?

Blocks and spam reports go up, your number's quality rating falls and Meta can restrict how many messages you send. Prior, documented opt-in is not a formality: it is the foundation for keeping the WhatsApp channel running over time and keeping the number from being limited.

This concept, turned into recovered revenue

Revio wins back inactive customers and abandoned carts with WhatsApp campaigns measured by what they recover, not by what they send. Tell us what dormant base you have.

Keep exploring

Related terms

From the glossary

Related questions

We solve it with

Revio

Win back inactive customers and abandoned carts with WhatsApp campaigns measured by recovered revenue.

How Revio solves it
Resources

Other resources

The full suite

Now that you know what it is, see how it gets solved

Five AI products that work on top of the CRM you already use. They don't replace your system: they add the layer you do by hand today.

The Vantegrate team at the office at sunset
Part of the Vantegrate team in an office hallway
Vantegrate developers working on their laptops
The Vantegrate team working by the docks
The Vantegrate team in a working session
The Vantegrate team working with a river view
Meet the team