Skip to main content

WhatsApp Message Template

To learn more regarding WhatsApp Message Templates, please learn more on WhatsApp Template Fundamentals.

Creation​

Use the message template panel in NusaSMS to create a template.

You can create a maximum of 100 templates in a WhatsApp Business Account per hour.

Names​

Every template must have a name, but names are not unique. This flexibility allows you to create multiple templates with the same name, but in different languages.

Template names are limited to a maximum of 512 characters, consisting of lowercase alphanumeric characters and underscores.

Categories​

Each template must be categorized as authentication, marketing, or utility. Visit template categorization guides for more guides.

Note that template categories also factor into pricing.

Languages​

You must select a template language when createing a tempalte. Template strings and variables are not translated by NusaSMS or Meta, so you are responsible for supplying strings and example parameters in their appropriate language.

Components​

Templates are made up of various text, media, and interactive UI components, which you define upon template creation. The template components guide describes all possible components and how to define them.

Parameters​

Some template components allow you to define strings that contain one or more parameters (described as “variables” in WhatsApp Manager). These are replaced with values included by you in your send message payload when you send the template.

Upon template creation, if a string includes one or more parameters you must include an example value for each parameter.

Parameters must be ordered array index numbers, starting from 1, wrapped in double curly brackets: ({{1}}...{{2}}...and so on). Example values in template creation payloads and real values in template send payloads must appear in the order in which their corresponding placeholders appear in the component text string.

Template review​

Templates are automatically reviewed upon creation. If your template is approved, its status is set to APPROVED and you can begin sending it in template messages. If it is rejected, or if its status changes to any other value, it cannot be sent in template messages.

Template status​

Templates must have a status of APPROVED before they can be sent in template messages. A template’s status is initially set by the template review process, but can be changed to another value based on usage and quality feedback.

Quality rating​

Template quality rating is a system used to evaluate the quality of message templates, based on usage, customer feedback, and engagement. This rating helps maintain a high-quality messaging ecosystem and helps ensure that you are sending relevant and well-received messages.

Delivery sequence of multiple messages​

When sending a series of messages, the order in which messages are delivered is not guaranteed to match the order of your API requests. If you need to ensure the sequence of message delivery, confirm receipt of a delivered status in a status messages webhook before sending the next message in your message sequence.

Template management​

See Template management for a list of endpoints commonly used for getting, updating, and deleting templates.