Loader

Templates (HSM)

 

What is a WhatsApp template message (HSM)?

A template message (also known as a Highly Structured Message or HSM) is a special message type for business-initiated and re-engagement conversations. Businesses can register content for their most commonly used messages and simply send the relevant variable parameters instead of recreating the entire message during the API call each time it is used.

For the consumers who receive a notification message from your verified business for the first time and do not have the business saved as a contact in their phone book, the WhatsApp application will recognize the registered template and display the message without any warnings. This will reduce the likelihood of your messages being marked as spam by the consumer.

Standard text templates. Create rich text-based template messages to send to your customers. Formatting options like bold, italic, pre-formatted, or strike-through are supported.

Note: templates can only be sent to users who have opted in and given your app permission to send them messages; all templates must be approved by WhatsApp before it can be sent to customers


Message types

Business-specific template messages

Once the business is verified by WhatsApp, you can proceed with the registration and approval of the template messages that your business requires. When registering a template message, you will have to provide the information as stipulated below under Applying for message templates.

Clickatell default template messages

Clickatell provides a few default template messages for all approved and verified businesses to use. This also allows the business the ability to test and implement this functionality while the business-specific templates are being registered.

Re-engagement messages

Messages sent from business to consumer for the first time or more than 24 hours after the consumer last messaged the business are known as “re-engagement messages”. All such messages are required to be a template message. Regular text messages or media messages (i.e. any non-template messages) attempted in this a scenario will fail to be delivered to the consumer and an error will be returned by the Clickatell API. Businesses are urged to register a valid template message for this scenario or re-consider their engagement process with the consumer to ensure a good experience.


Applying for message templates

You can register new templates or review your existing approved templates from within the portal.

Navigate to WhatsApp → WhatsApp Templates from the left panel.

 

 

You will see two tabs:

  • Default templates: these approved templates created by Clickatell are added to your account by default – use them to get started quickly or when testing your API integration.

 

 

  • Business templates: view existing and create and submit new templates for approval; only available once your WhatsApp Business profile has been approved and verified by WhatsApp. 

 



 

Best practices

When creating a new message template, a business must follow the below best practices:

  • Template name – A unique name to identify the template use case for the business. It should be all in lower case, with no spaces. You may use an underscore to indicate a space.
  • Template parameters – A template message must contain at least one parameter, and all message formatting options (e.g. bold, italics) applies. Parameters cannot have new line/tab characters or more than four consecutive spaces. All parameters will be defined within curly open/close braces and listed in chronological order starting at {{1}}
  • Template Tag – Type of information contained in the template (e.g. account update, issue resolution, auto reply). Select the value from a predefined set of categories during registration.


Template Examples

Template name
Template Tag
Template message
Parameter details
optin_confirmation Account Update

Dear {{1}}. You are now subscribed to receive account-related alerts for your account ending in {{2}}.

{{1}} – Name of the recipient, eg. John 

{{2}} – Last 4 digits of the account, eg. 1234

transfer_update Personal Finance Update

Your funds transfer request of {{1}} from account ending in: {{2}} has been initiated.

{{1}} – Total amount, eg. $50 

{{2}} – Last 4 digits of the account, eg. 1234

You must also select the language that your template will be written in. Currently, the following languages are available (with more to be added soon):

  • Afrikaans
  • English
  • English (UK)
  • English (US)
  • Portugese (BR)
  • Portugese (POR)
  • Spanish (ARG)
  • Spanish (SPA)
  • Spanish (MEX)

Rejection reasons

If your template(s) are rejected, it may be because of one of the following reasons:

  • Template(s) may be considered to be promotional
    • Advertising, marketing or promotional messages offering coupon codes and/or free gifts and upselling are not permitted in templates
      • E.g. “Here is your boarding pass, with seat assignment and gate information. If you would like to save 10% on your in-flight dinner, order your meal through our app.”
    • Cold call messages
      • E.g. “Is now a good time to talk?”, “Thank you for your interest, can we speak now?”, “I tried contacting you but you weren’t available. When are you free?
    • Sending a survey or poll to collect data
      • E.g. “Hi, we’re interested in knowing how you feel about certain food groups. Do you mind participating in a survey?
    • Inclusion of certain words or phrases that make the message template promotional (even though the content of your template may be acceptable)
      • Tip: Think about how your template sounds when you read it aloud.
  • Template(s) has floating parameters
    • I.e. just parameters and no text 
      • E.g. “Hello {{1}}”, “{{1}} – {{2}}”
    • It is important to surround the parameters with contextual text so it’s clear what will be inserted for the parameters.
  • Template(s) contain incorrect formatting
    • E.g. templates containing spelling mistakes
  • Template(s) contain potentially abusive or threatening content
    • E.g. templates that threaten customers with a legal course of action or that threaten to add customers to a WhatsApp group with their friends and family to shame them if they don’t pay back their loans 
 
Additional guidelines to help accelerate the Message Template approval process
  • Make your message template name clear, e.g. instead of using a name like “template_014” rather use “order_update”.
  • Remember that someone outside of your business will be reviewing your templates. Providing more clarity gives reviewers context around how the template will be used.
  • If you need to write a message template to re-open the 24-hour window, we would suggest starting with some mention of the previous conversation thread, e.g. “I’m sorry that I wasn’t able to respond to your concerns yesterday but I’m happy to assist you now. If you’d like to continue this discussion, please reply with ‘yes’.” or “I was able to do some follow-up based on our previous conversation, and I’ve found the answer to your question about our refund policy. If you’d like to continue our conversation, please say ‘yes’.”
 
Sending a message template

Use Clickatell’s One API to send a template to one or more customers. You cannot sent template messages directly from the portal.

 

 

Did you find this information informative?

Other Resources

Ask the Community

Visit Stack Overflow to join our community of developers and find the answer you need

Contact Support

Contact our support team and one of our agents will be in touch with you to answer any questions you have