...

How to Create WhatsApp Message Templates: The Guide

Illustration: Adan Augusto
whatsapp message templates

Please note that 'Variables' are now called 'Fields' in Landbot's platform.

Please note that 'Variables' are now called 'Fields' in Landbot's platform.

Once you successfully applied for the WhatsApp Business API and activated your phone number(s), the next task on your list is learning how to create WhatsApp message templates. After all, these templates are the most important element of your WhatsApp-led growth tactic.

They play an integral role in driving your WhatsApp marketing efforts to success as their quality dictates how often and how happily your subscribers engage with your WhatsApp chatbot.

In this article, you will learn the rules and best practices of WhatsApp template messages creation so you can progress to create a strong marketing strategy.

Message Types for WhatsApp Business API 

Before we dive into the simple but strangely complicated template creation process, let’s have a closer look at what a WhatsApp message template is and all the rules and privileges that make it different from the other marketing messages you can send using WhatsApp API.

Essentially, there are two types of messages you can send to your leads/potential customers using WhatsApp API Client integration:

  • Session Messages
  • Message Templates (previously known as Highly Structured Messages or HSM)

Session Messages

Session messages are reactive messages written in response to a customer inquiry. WhatsApp labeled them as “session messages” since they can only be sent within a 24-hour Customer Care Window.

In other words, WhatsApp grants you 24 hours to respond to an inquiry for free.

Session messages are part of a private conversation between you and your customer and are not subject to a specific format or content rules. You can send text messages, gifs, images, videos, and even voice messages.

Please be aware! If the user initiates the conversation by sending you an unprompted message, the 24-hour window starts when you send a message in response. If the user messages you in response to a template message notification, the 24-hour service window starts counting from the moment you send the notification.

Message Templates

They’re the famous WhatsApp message templates you have heard so much about. They are the only way WhatsApp is monetizing the WhatsApp Business API service.

There are five key things you need to know about Message Templates. They are:

  • Proactive & Reusable (common notifications businesses may want to send to active users automatically)
  • Highly Structured (as their former name implies, they have to comply with very strict structure guidelines)
  • Subject to Approval (before they go live, the templates need to be submitted to and pre-approved by WhatsApp)
  • Subject to User Opt-In (although there is no limit to the number of templates you can send at once, you can only send them to users who previously agreed to be contacted)
  • Personalized Through Variables (template messages, although automated, allow for a level of personalization using simple variables)
  • (Optionally) Multi-Lingual (the templates allow you to pre-design the same message in multiple languages to connect with users in different countries)

Before the release of the API solution, you could only send up to 256 marketing messages at once to a designated group or broadcast list. In this sense, Message Templates are quite a revolutionary step in the history of WhatsApp as well as one of the most attractive advantages of WhatsApp API.

Let’s look at all those rules that make them so structured!

Rules of Creating WhatsApp Message Templates

There are two “categories” of rules to take into account: Content Rules and Formatting Rules.

Content Rules

To be able to send users automated notifications, you need to format message templates in accordance with WhatsApp policies which are strongly user-centric. In other words, WhatsApp cares more about the value you will be providing to your customers rather than the value they are providing to your business.

And so, promotional and sales-oriented HSM submissions will be rejected - no exceptions!

To increase ​​your chance of approval make sure that:

  • Verify that your message formatting is correct
  • Your use case complies with the WhatsApp Business Policy and WhatsApp Commerce Policy.
  • Ensure your Message Template actually fits the use case you have submitted;
  • Ensure you choose the most relevant template category for your use case. It should fall under one of these categories: account update, alert update, appointment update, issue resolution, payment update, personal finance update, reservation update, shipping update, or ticket update;

You will very likely be rejected if your template:

  • Asks for reviews or surveys;
  • Includes promotional messages and advertises products, services, or events the customer may like;
  • Contains content that violates WhatsApp’s Commerce Policy;
  • Contains potentially abusive or threatening content;
  • The template is formatted incorrectly.

It’s best to keep Meta's official Message Template Guidelines at hand!

Formatting Rules 

There are specific formatting rules for both the title and content of your template.

Template Name

WhatsApp message template name can only include lowercase alphanumeric characters and underscores.

Example: shipping_update | order_followup1

To speed up the approval process, WhatsApp advises businesses to use descriptive names for their templates rather than random ones like “message_124a.” This makes it easier for the person approving your message and for you, who will have to manage a sea of other templates.

Parameters

If you want to use variables collected from your WhatsApp target audience, you can use the following placeholder to submit them in your Message Templates: {{number_parameter}}, like so: {{1}}, {{2}}, etc.

When using parameters in Message Templates, you'll be able to add a sample text value for each parameter before submitting it:

Once it is approved, when sending the template to your users, you can add the variables to the template by typing @name_of_variable to add dynamic values:

Header

Including a header in your Message Template is optional. If you opt to have one, you can choose between four options when adding it to your Message Template:

  • Title (text): The text header has a limit of 60 characters, including parameters. If you try to add more characters, the message delivery will fail.
  • Image and documents: You can create a Message Template with an image or document as the header. The file must be publicly accessible and less than 30MB in size.
  • Video: You can use a video as a header, too. Only MP4 files are supported and they can’t exceed 16MB in size.

Body

The body is mandatory, as it makes up your actual message. It should only contain text, parameters, emojis, and formatting (bold, italic, strikethrough, and monospace).

The number of parameters allowed in the body is unlimited, but the total number of characters can't exceed 1024 when sending the message template. If using parameters in the body, they may contain as many characters as you want, as long as the total body length does not exceed 1024 characters.

Footer

Including a footer in your Message Template is optional. It may only contain text and is limited to 60 characters. Here’s what it looks like:

Buttons

Buttons are also optional. You can either add call-to-action buttons or quick reply buttons. If you want to send a call to action, you can’t send a quick reply in the same template and vice versa. 

  • Call-to-action buttons: they allow the user to call a specific phone number or go to a specific URL. If using the first, the button text and phone number are mandatory fields. If using a URL, the button text and URL are required fields for template creation. A single Message Template can have a maximum of 1 phone and 1 URL call-to-action button.
  • Quick reply buttons: they allow the users to easily respond to a message template with up to 3 predefined answers. For quick reply buttons, all that is required is the button text with a limit of 25 characters.

How to Submit a WhatsApp Message Template: The Process

The process of submitting your HSM templates varies depending on whether you are working with a provider or independently.

In our article about how to apply for WhatsApp Business API, we mentioned that you may either apply directly via the Facebook application form or through a provider who manages the application for you. If you are managing your API directly, you can create and submit your template via your Meta Business Account.

However, if you are using a provider like Landbot (because you like to have your WhatsApp chatbots, live chat, and message campaigns under one roof), you can rely on the internal Message Templates submission system.

Submitting Message Templates Through Landbot

The submission process differs from provider to provider. At Landbot, we created a process that simplifies and streamlines the creation, submissions, and approval of the template so you can get your marketing campaigns out in short order.

To manage or request HSM Templates inside the Landbot app, access the Channels manager by clicking on the respective icon in the left-side navigation bar. Next, click on your WhatsApp Business channel and then select “Message Templates”.

To create a new WhatsApp Message Template click the “Request Message Templates” button in the right corner.  

A window will pop up and ask you for the basic details:

Message Template Name

It must have a maximum of. 512 characters containing only lowercase letters, numbers, and underscores. No spaces or other characters are allowed. You also can’t use the same name for more than one Message Template.

Category

Selecting a Message Template category makes it easier for WhatsApp to review and approve your template by providing context for how the message template will be used.

The categories to choose from are:

  • Marketing conversations: include promotional offers, product announcements, and more to increase awareness and engagement;
  • Utility conversations: include account updates, order updates, alerts, and more to share important information.
  • Authentication conversations: include codes that allow your customers to securely access their accounts (not available via Landbot at the moment.)

Language

Finally, when creating a new Message Template, you must choose a language code. The language codes are described in Meta's page.

You can create Message Templates in as many languages as you want. However, when translating the template into multiple languages, please be sure to use the same message template name.

You can also choose to start a Message Template from scratch or edit a pre-existing Template.

When done, click NEXT.

You will be redirected to the second step of the submission process which consists of four fields:

  • Header (Optional)
  • Body (Required)
  • Footer (Optional)
  • Buttons (Optional)

As you fill in the template fields following the formatting rules mentioned previously, the preview of your message will appear on the right side of the pop-up field:

Once you are done, simply click SUBMIT and await approval.

You’ll be able to monitor the status of the template on the main dashboard:

Reasons Your WhatsApp Message Templates Can be Rejected & Troubleshooting

There are a few reasons why WhatsApp rejects your Message Templates. Let’s look at the most common ones.

The message template is regarded as promotional if it:

  • offers a free gift and/or coupon codes;
  • tries to upsell;
  • bids for cold calls (e.g., “Is this a good time to talk?”);
  • sends a survey or poll to collect data;
  • includes certain words or phrases that make the template sound promotional (even if there is nothing wrong with the content of the template.)

The message template includes floating parameters. Floating parameters refer to lines with only variable parameters and no text which makes it hard to judge what’s the nature of the message. Parameters need to be surrounded with information so the intent is clear.

The message template has faulty formatting, for example:

  • Features spelling mistakes;
  • Includes incorrect variable format such as missing one curly bracket.

The message template contains potentially threatening or abusive content, for example:

  • Threatens users with a legal course of action;
  • Threatens users if they don't pay back their loans.

Examples of Approved & Rejected Message Templates

Sounds simple right?

Are you starting to feel you could create WhatsApp message templates without much trouble?

Good, but we advise you to stay cautious!

In practice, things can get a little tricky, and differences between what is approved or rejected are very nuanced. 

Let’s look at a few examples!

Welcome Message

Rejected: 

whatsapp template message example rejected

Approved: 

whatsapp template message example accepted

Follow-up

Rejected:

whatsapp template message example rejected

Approved:

whatsapp template message example approved

Newsletter 

Rejected:

whatsapp template message example rejected

Approved:

whatsapp template message example approved

In a lot of cases, the differences are minuscule and sometimes it’s not even that clear why one message is OK while the other is not. Thankfully, WhatsApp team is usually quick on getting back to you. If you are still not sure how to put together your first templates, check out our list of WhatsApp message template examples by industry.

All in all, when submitting WhatsApp message templates, it is best to have patience and make sure to double check that everything is according to the necessary formatting and respects WhatsApp guidelines.

Sending Message Template Campaigns

As with the submission process, the management, and sending of your HSM templates will be different if you applied directly or are working with a provider.

Direct applicants can manage their WhatsApp template set up and sending via their WhatsApp Manager inside their Facebook Business account. In this case, the process is a bit more technical and you will probably need the help of a developer to start sending your message templates.

On the other hand, when working with an intermediary, you will be managing your account via the dashboard of your service provider.

For example, to send a WhatsApp campaign with Landbot you simply need to click to access your WhatsApp Business channel, click on the “Campaigns” section and press the “New Campaign” button.

You will be redirected to a campaign setup page.

Here, all you need to do is:

  • Create campaign name;
  • Select the target audience you have previously created in the Audiences section of your WhatsApp channel;
  • Define the Content by selecting one of your approved WhatsApp templates OR request a new template;
  • Select if to connect the campaign with a WhatsApp chatbot — if YES, select the relevant chatbot that will reply to the user once they engage with the template (optional);
  • Assign a new variable to campaign participants (single out those who engage for other more specific campaigns or chatbot flows) (optional);
  • Send or Schedule the campaign.

Once you set up your campaign it will appear on the list in the main Campaigns Section.

WhatsApp Campaign Examples

Curious to see what WhatsApp Message Templates look like in action? Here you’ll find two examples of templates being used to send WhatsApp campaigns.

Convosight

Convosight is a global community management and monetization platform that enables community leaders to become community entrepreneurs. It helps community leaders connect with brands easily and earn a sustainable income through campaigns with them.

By adding WhatsApp campaigns to their community marketing strategy, they were able to scale community campaigns 4x. WhatsApp automation has additionally helped the team achieve more without adding additional headcount, resulting in a 300% increase in operational efficiency.

Landbot’s Ungated Conversations Channel

Our Ungated Conversations WhatsApp channel is where we share all the content you need on AI lead management to close more deals and retain customers. If you’re not a subscriber already, you can do so here.

As for what you can expect from the channel, here’s a sneak peek:

 

WhatsApp Template Message Pricing

It’s no secret that allowing businesses to send notifications is the first time ever WhatsApp monetized its services.

In essence, WhatsApp Business API integration is free. You only pay when sending out proactive message temples. The word “proactive” is important here since even a message template can be free if it is in response to a query received less than 24-hours ago.

The price of template messages is influenced by two factors:

  • The volume of template messages delivered to a given country or region in a calendar month;
  • Country code of the message recipient.

You can verify the costs on the official List Price Schedule featured in the Facebook for Developers documents.

Naturally, there will be additional costs for businesses working with WhatsApp solution providers depending on the provider which usually works on a subscription basis.

WhatsApp Message Template Wrap-Up

So, this is our guide on how to create message templates for WhatsApp!

We sincerely hope most of the vagueness is gone and you have a much better idea of what needs to be done.

In case you are interested in applying for the WhatsApp API solution with Landbot, click on the big fat button below to check your company status and get in touch with our sales team.

If not, keep your eyes peeled on our blog for more WhatsApp-related content about marketing opportunities, lead generation, chatbot, and more!