When initiating a conversation with a customer, you must use a Message Template. Message Templates must be approved by WhatsApp and can be submitted via the WhatsApp Template Manager on the MessageBird Dashboard. Note that you can only create a Message Template if you have an active channel. It is not possible to submit your own Message Template when testing using our Sandbox.
In this article, we will discuss the following:
- What do I need to create a Template Message?
- What types of messages are allowed as Template Messages?
- What does a Template Message look like?
- How can I submit a Template Message?
- Best Practices
What do I need to create a Template Message?
- A name: The name of the Template Message has to be formatted in small letters only, and spaces need to be replaced with an underscore. The name should be as descriptive as possible. For example: shipping_alert_1
- A body (1024 character limit)
- Variable(s)/placeholder(s): The Template Message uses numbered placeholders '{{x}}' for each variable in the message. Each variable can be replaced with text that contains letters, digits, special characters, or spaces.
When submitting the Template Message for approval, you should keep in mind that it needs to contain the full body of the message, with the option to add unique parameters represented as placeholders. At least one parameter is required and the template should not contain any spelling mistakes.
What types of messages are supported as Template Messages?
Supported | Not supported |
|
|
What does a Template Message look like?
Template Message should be submitted as follows:
Name: account_registration
Hi {{1}}! Thanks for starting your personal training plan. We’ll send you a {{2}} update with your new schedule. You can log-in online using your training ID {{3}}. Stay fit!
Your customer will receive:
Hi Joey! Thanks for starting your personal training plan. We’ll send you a weekly update with your new schedule. You can log-in online using your training ID 123456. Stay fit!
How can I submit a Template Message?
Only if you have WhatsApp access, you can submit a Template Message from your Dashboard via the WhatsApp Template Manager. If you do not have WhatsApp access yet, sign up to get started.
- Head to the WhatsApp Template Manager in the WhatsApp Section on the left side of your Message Dashboard.
- Click on Create template, a pop-up will open.
- Fill out all the information
- Name: in small letters only and spaces need to be replaced with an underscore
- Category: should describe the purpose of the message
- Language: the language of the template
- Content: is the full body of the message, with the option to add unique parameters represented as placeholders.
- Make sure to include at least one variable, like
{{1}}
- Make sure to include at least one variable, like
- Double-check all the information and, once you're ready, click on Submit for approval.
Keep in mind that once submitted for approval, a message template cannot be edited.
Best Practices
When submitting your Template Message, you should keep the following things in mind:
- Your template should include at least one parameter “{{x}}”
- Your template should not contain any spelling mistakes
- Your template should be formatted correctly, including parameters, as described above.
- Your template should have a clear title name, for example instead of using a name like "template_014," use "bus_ticket_details"
- Your template cannot be edited once it has been submitted
- Your template cannot contain any shortened URLs (like bit.ly)
- Your 'body' section should be within the 1024 character limit