WhatsApp message templates are a core component of communicating with customers on the platform. They are required for sending notifications to users more than 24 hours after their last message. Understanding how to create, categorize, and submit these templates correctly is essential for avoiding rejections and communicating effectively.
Key takeaways
- Message templates are pre-defined, reusable message structures required for business-initiated conversations on the WhatsApp Business Platform.
- There are three main categories: Utility (transactional), Authentication (one-time passcodes), and Marketing (promotional). Choosing the right category is critical for approval.
- Templates must be submitted to Meta for review before they can be used (Source). Common rejection reasons include incorrect formatting, policy violations, and promotional content in utility templates.
- You do not need a template for replies sent within the 24-hour customer service window, which allows for free-form conversations.
- Properly formatted placeholders (variables) are essential for personalizing templates, but they must follow specific rules to avoid rejection.
What Are WhatsApp Message Templates? (And What They Are Not)
A WhatsApp message template is a pre-defined, reusable message structure that your business submits to Meta for review and approval. They are required for initiating conversations with users or for replying to a user more than 24 hours after their last message. Think of them as official, pre-authorized messages for specific business notifications. A template is a formal structure associated with a WhatsApp Business Platform account (Source).
This is different from a simple saved reply or a free-form message. You can send any message you want—text, images, documents—without a template as long as you are replying within 24 hours of the user’s last message. This 24-hour period is called the customer service window. Outside this window, a template is mandatory.
Use this simple decision process:
- Did a user send you a message within the last 24 hours?
- Yes: You are in the customer service window. You can send a free-form message.
- No: The window is closed. You must use an approved WhatsApp message template to contact the user.
The 3 Categories of WhatsApp Templates: Utility vs. Marketing vs. Authentication
WhatsApp classifies message templates into three main categories: utility, marketing, and authentication (Source). Choosing the correct category is the first and most important step in the approval process. A message containing both utility and marketing content will be classified as a marketing template (Source).
| Category | Purpose | Examples | Content to Avoid |
|---|---|---|---|
| Utility | Communicate important information related to a specific, agreed-upon transaction, account event, or subscription. | Order confirmations, shipping updates, appointment reminders, account balance alerts. | Promotional offers, "you might also like" suggestions, requests for reviews that include a discount. |
| Marketing | Promote products or services, increase brand awareness, or re-engage customers. Includes any message with a promotional goal. | New product announcements, sale notifications, cart abandonment reminders, special offers. | Using misleading language or sending to users who have not explicitly opted in to receive marketing messages. |
| Authentication | Verify a user's identity with a one-time passcode (OTP). This category has strict content rules. | Login verification codes, account recovery codes, transaction confirmations via OTP. | Any text other than the prescribed OTP format. URLs, media, and emojis are generally not allowed (Source). |
Anatomy of a Perfect Message Template: A Worked Example
An approvable template is more than just text; it's a structured object with specific components. Let's break down a utility template for a shipping confirmation.
1. Metadata
First, you define the template's core properties. This information is not visible to the end-user but is crucial for management and API calls.
- Name:
order_shipped_v2 - Category:
UTILITY - Language:
en_US(English, United States)
2. Components
Next, you build the visible parts of the message.
- Header (Optional): This is an optional header component.
- Type:
DOCUMENT - Example:
invoice_ACME_12345.pdf
- Type:
- Body: This is the main text of the message. It includes placeholders for personalization. Placeholders are represented by double curly braces with sequential numbers:
{{1}},{{2}}, etc.- Content:
Hello {{1}}, your order #{{2}} from ACME Corp has shipped. You can expect it to arrive by {{3}}. Thank you for your purchase!
- Content:
- Footer (Optional): A short line of text at the bottom.
- Content:
Questions? Reply to this chat.
- Content:
- Buttons (Optional): Interactive elements that prompt user action.
- Text:
Track Your Package - Example Action: A URL, e.g.,
https://tracking.acmecorp.com/track?id={{4}}
- Text:
3. API Request Example
When you send this template via the API, you specify the template name and provide the values for each placeholder. The API call might include a JSON object like this:
{
"to": "15551234567",
"type": "template",
"template": {
"name": "order_shipped_v2",
"language": {
"code": "en_US"
},
"components": [
{
"type": "header",
"parameters": [
{
"type": "document",
"document": {
"link": "https://cdn.acmecorp.com/invoices/invoice_12345.pdf",
"filename": "invoice_ACME_12345.pdf"
}
}
]
},
{
"type": "body",
"parameters": [
{ "type": "text", "text": "Maria" },
{ "type": "text", "text": "ACME-12345" },
{ "type": "text", "text": "Friday, November 28th" }
]
},
{
"type": "button",
"sub_type": "url",
"index": "0",
"parameters": [
{ "type": "text", "text": "ACME-12345" }
]
}
]
}
}This combines the approved structure with real customer data to deliver a personalized, useful notification.
How Does the Template Approval Process Work?
Submitting a template for approval follows a clear lifecycle. While Meta does not publish typical review times, the steps are consistent.
- Design & Categorize: Write your message content and choose the correct category (Utility, Marketing, or Authentication). Ensure your content complies with WhatsApp's Business Messaging Policy.
- Define Structure: Build the template using the components described above: name, language, header, body with variables, footer, and buttons. Double-check that all placeholders are formatted correctly as
{{1}},{{2}}, etc. - Submit for Review: Use Meta’s template tools or a platform that uses the WhatsApp Business Platform to submit the template.
- Await Status: Your template will enter a review queue. The status will update to one of the following:
- Pending: The template is under review.
- Approved: The template has passed review and can be sent to users (Source).
- Rejected: The template violates a policy or has formatting errors. It cannot be used.
- Send & Monitor: Once approved, you can begin sending the template via the API. Meta may review, pause, or reject templates after approval based on quality and policy compliance (Source).
Why Do WhatsApp Message Templates Get Rejected?
Template rejections are common, but they usually happen for predictable reasons. By avoiding these pitfalls, you can significantly increase your approval rate.
Formatting Errors
Incorrectly formatted placeholders are a top reason for rejection.
- Rejected: Adjacent variables like
{{1}}{{2}}.- Approved: Separate them with text, like
{{1}} - {{2}}.
- Approved: Separate them with text, like
- Rejected: Non-sequential numbering like
{{1}}, {{3}}.- Approved: Use sequential numbers:
{{1}}, {{2}}.
- Approved: Use sequential numbers:
- Rejected: Placing a variable at the very start or end of a line (Source).
- Approved: Surround it with text or punctuation, like
Hi {{1}}!
- Approved: Surround it with text or punctuation, like
Policy Violations
Your content must not violate WhatsApp's policies.
- Rejected: "Get your free trial of our new weight-loss supplement!"
- Reason: This violates the WhatsApp Commerce Policy against certain health products.
- Approved: (For a different, compliant product) "Your order for Glow Skincare is confirmed!"
Category Mismatch
Placing promotional content in a non-marketing template will cause rejection.
- Rejected: (As a
UTILITYtemplate) "Your appointment is confirmed. While you wait, check out our 20% off sale!"- Reason: The message contains a promotional offer.
- Approved: (As a
MARKETINGtemplate) "Your appointment is confirmed. While you wait, check out our 20% off sale!" or (as aUTILITYtemplate) "Your appointment is confirmed for 3:00 PM on Tuesday."
Vague Content
Templates with generic placeholders that could be used for abuse are often rejected (Source). Provide sample content to show a legitimate use case.
- Rejected:
Hi {{1}}, here is your update: {{2}}- Reason: The content is too generic and could be abused.
- Approved:
Hi {{1}}, here is an update on your support ticket #{{2}}: Our team is investigating the issue.
When Should You NOT Use a Message Template?
You should not use a message template when you are having a normal, back-and-forth conversation with a customer. The primary time you don't need a template is during the 24-hour customer service window.
This window opens the moment a user sends your business a message. For the next 24 hours, you can reply with free-form messages, including text, images, videos, and files, without needing any pre-approval (Source).
Using templates for every single reply within this window is unnecessary and can make your support feel robotic. The system is designed to allow for natural, human conversations. Free-form messages are ideal for answering questions, providing support, and building rapport. Save templates for when you need to initiate contact or re-engage a user after the 24-hour window has closed, or when automating conversational replies with structured information.
What to learn next
Mastering WhatsApp message templates means understanding the rules that govern business-initiated communication. By correctly categorizing your messages, carefully formatting your templates, and respecting the 24-hour customer service window, you can ensure reliable and compliant messaging.
- WhatsApp Business API Explained: A Complete Guide: Learn more about the platform that powers template messaging.
- AI Lead Qualification: A Practical How-To Guide: Discover how to use marketing templates effectively as part of a larger lead qualification strategy.
- WhatsApp Business Messaging Policy: Read the official policy to ensure all your templates are compliant.
