Introduction

WhatsApp Templates are used to send non promotional notifications after 24 hours window. All templates structure must be pre-approved by WhatsApp before using it. WhatsApp Templates are also known as HSM (Highly Structured Messages).

Every templates approved by WhatsApp will carry a unique template id and you need to pass the unique template id along with value of dynamic variable in order to send a templated message. Please note template messages are billed based on your destination country and plan opted, there are no free template messages included in any of the plan so your account should have enough balance to send templated messages. Once a template is approved currently it's not possible to edit.

Understanding Templates

WhatsApp have some specific guidelines to be followed for requesting and sending templated messages.

Template Category

WhatsApp will check wether the templates requesting by you is relevant to your business category, below are currently supported category , please select the appropriate category

ACCOUNT_UPDATE PAYMENT_UPDATE PERSONAL_FINANCE_UPDATE SHIPPING_UPDATE RESERVATION_UPDATE ISSUE_RESOLUTION APPOINTMENT_UPDATE TRANSPORTATION_UPDATE TICKET_UPDATE ALERT_UPDATE AUTO_REPLY

Please make sure the template message context is relevant to the category you selected

Template Name

You have to mention the name of the templates, please make sure the template name

Can only contain lowercase alphanumeric characters and underscores ( _ ). No other characters or white space are allowed.

Make your message template name clear. Instead of using a name like "template_014," use "bus_ticket_details".

​

Dynamic Variable

Dynamic variable is one of the important part of the templates which allows you to pass dynamic contents to the message, while requesting message templates you can specify the dynamic variable like {{1}} , {{2}}

Your One Time Password (OTP) to {{1}} is {{2}}

In the above template you can replace {{1}} and {{2}] with your own value when sending message.

Please dont request template with floating variables i.e lines with just variables not any text , in the below example {{3}} and {{4}} are floating variables and similar templates will be rejected

--
TICKET NO: {{1}}
PASSENGER NAME: *{{2}}*
--
{{3}} - {{4}}

New Lines, Tabs, 4 consecutive spaces are not allowed in the dynamic variable actual message content.

​

Template Types

Currently WhatsApp Supports only following template types , you need to specify the type of template you want to request

Text Templates This is a plain text templates, you can specify links, emoji's as well, maximum characters for text template is 1024

Media Templates Media templates are structured messages where you can pass header, body and footer , currently only images, videos & documents are allowed in media templates.

Interactive Buttons WhatsApp Template supports sending message with Interactive buttons mainly with Quick Replies & Call to Action, Read More How it Works​

​

For images you must pass body text along with variables while requesting templates, footer is optional , if you use footer then the body text character is limited to 160 and footer text is limited to 60 characters. You can't pass dynamic variables in footer text.

​

For Documents only PDF is supported now , header and footer is optional but if you are passing header and footer then body text character is limited to 160 and header and footer character limit is 60, if you are not passing header and footer then body character limit is 1024. Footer contents will be fixed however header text can pass dynamically using variables.

Language

You can specify the language of the template, one template can be requested in many languages supported by WhatsApp, WhatsApp will not translate your templates into any local languages instead you need to specify the language so that WhatsApp approval team can easily review and approve the same.

For multiple languages you dont need to request multiple templates, you can request multiple languages through a single template by specifying the language. Please go through the supported language by clicking the below URL.

Template Limitations

  1. Currently its not possible to edit an approved WhatsApp template

  2. Maximum number of template can be requested from a WhatsApp Business Account is limited to 250

  3. Marketing, Promotional, Discount Coupons, Up selling, cold call messages, surveys or polls, free gifts etc are not allowed to send through templates.

  4. All templates are subjected to manual approval from WhatsApp and we dont have any role in the this process.

  5. New Line, Tabs, 4 consecutive spaces are not allowed in the dynamic variable actual message content.

  6. Text message type character is limited to 1024 and for document type when you pass Header & Footer , body character is limited to 160 and header & footer is limited to 60 characters, if you are not passing header and footer in a document type then you can pass upto 1024 character in the body.

  7. Only Video, Image & Document (PDF) is supported in media template.

  8. Footer is fixed and no option to pass dynamic data (Footer is optional) If a template carries a footer it will auto append with messages.

​