Manage Your WhatsApp Message Templates

What is a Message Template?

WhatsApp Message Templates are specific message formats that your business can use to send out notifications, OTP , and promotion messages to people who have opted-in to receive WhatsApp messages. Before it can be sent to your audience using the broadcast feature in Kata.ai’s Business Dashboard, your message template will be reviewed and should be approved by Facebook.

Create a New WhatsApp Message Template

Watch the video tutorial below to learn how to create a message template.

1. Go to the Message Template page by clicking from the left side navigation, and click +New Message Template on the top right of the page.
2. Choose a category of your message template.
   • Marketing : Send promotional offers, product announcements, and more to increase awareness and engagement.
   • Authentication : Send codes that allow your customers to securely access their accounts.
   • Utility : Send account updates, order updates, alerts, and more to share important information.
3. Type in the name of the message template. The name can only be in lowercase alphanumeric characters (a-z, 0-9) and underscore “_”. Space, uppercase letters, and symbols are not allowed.
4. Choose the language of your message template. You can select more than one language to create a message template in multiple languages. Click Next.
5. Fill in all the required content fields for the languages you selected (see Message Template Content Structure section to get tips on how to fill the content). Once you fill all the required fields, click Submit. Your message template will be reviewed by Facebook, and you can check the status on the Message Template page. In the case of a rejected template message, you may reach out to our support team at support@kata.ai.

Message Template Content Structure

Figure 1.Message Template Content Structure

Header (optional)

A header can be a text or a media - image, video, or document. For a text header, the character limit is 60 characters and you can add a maximum of one variable (See variable section for more info).

Body

A body is where you add the content of your message. You can edit text formats, add emojis, and add variables (See variable section for more info). The character limit is 1.024 characters for the body section, with only letters, numbers, and emojis allowed. It shouldn’t have newlines, tabs, or more than four consecutive spaces.

Footer (optional)

A footer can be a closing sentence, or default info - such as an address, social media ID, email, etc. - about your company that you want to include in your message. For the footer section, the character limit is 60 characters.

Button (optional)

When creating a message template, you can choose to include one of the available buttons, Custom, Call-to-Actions (CTA) , Marketing-opt-out.

A call-to-action button allows you to include your website URL and/or your business phone number so your audience can quickly visit your website or contact your business with a single tap. For the visit website URL button, you can choose a static or dynamic URL type. A dynamic URL type lets you personalize the website link by having a variable at the end of the link. The use case is for example when you want to inform a tracking order to your audiences.

A Custom button lets your audience quickly reply to your message. When using a custom button , you have to define the payload for every button you created to return the correct reply when customers tap the buttons.

A marketing-opt button is only available when using a marketing template category. This button lets your audience quickly respond whether they are interested (Button opt-in) or not (Button opt-out) in your broadcast marketing.

Variable

Using variables in your message template is a way to personalize your message to your audience and to reuse your template message for different occasions. A variable is written in two enclosing curly brackets with a number inside a bracket, e.g.: {{1}}. It represents changing content and can be implemented in the text header and body content, as well as when you include a dynamic URL button on your message template.

Here is a sample of using variables in a message:

Your Order Has Been Shipped On {{1}}!

Hi, {{1}}! Your order with ID {{2}} is already on its way. Click below to track your order, or contact us if you have questions or problems.

You can use variables for cases such as when you want to mention your customers’ names, information on price, promoted items, promotion dates, location, etc. The contents for the variables should be provided in your contact data when you use the audience or contact as a recipient or the variables should be provided in the CSV format when creating a new broadcast using a certain message template.

Sample Variable

For all variables you created throughout your template message content, you have to add sample contents to help Facebook better understand the use case during the review process.

1. After you fill the message template form, click Add Sample.
2. A modal will appear. Fill in all the variable fields. You can also provide a sample for the media header (image, document, or video). After adding all samples, click .

Message Template Best Practices

1. Template messages with the floating parameters will not be approved by WhatsApp, please surround the parameter with context/information so it is clear what variable will be filled in the parameter:

   “Welcome to Sejahtera Store {{1}}”
   
   

   In this example, there is no clear information on what variable will be inserted in parameter {{1}}

   The CORRECT way to create the variable:

   I. Your order number: {{2}}”

   II. Here is your order total {{3}}”
   
   

2. Template with spelling mistakes will not be accepted, example:

   Instead of using two curly brackets, you mistakenly type the variable in one curly bracket

   Example:

   Correct: {{2}}, Wrong: {2}
   
   

   Please type the parameter based on sequenced numbers

   Example: {{1}}, {{2}}, {{3}}
   
   

3. Template message contains potentially abusive/threatening content is not allowed:

   a. Threaten customers with a course of legal action will be rejected

   b. Threaten the customer if they don’t pay their loan will also be rejected

4. Additional best practice guidelines are outlined here.