How to design WhatsApp HSMs?
If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.
- Getting Started
- Bot Building
- Conversation Design
- Developer Guides
- Agent Setup
- Analytics & Reporting
- Troubleshooting Guides
- Release Notes
Table of ContentsHighly Structured Message (HSM) TemplatesOpt-InsTypes of WhatsApp NotificationsBest practices for getting WA notifications approvedHow to design HSMs for WhatsApp?Why do notifications get rejected on WhatsApp?Unpermitted Notification TypesWhy Do Numbers Get Flagged on WhatsApp?
WhatsApp HSMs or WhatsApp Notifications - Another powerful way to leverage the WhatsApp Business API. You can send outbound notifications to keep users updated at all times.
Highly Structured Message (HSM) Templates/Notifications are business initiated, templated messages that can be sent to an existing user.
- Notifications enable you to:
- Deliver important, timely messages during your customer’s path to purchase
- Continue the conversation with customers who respond to your notifications
- Businesses can only initiate chats if you are sending a transactional notification, and only via approved Message Templates.
- Haptik will approve these notification templates on behalf of the business.
- Businesses cannot send advertising, marketing, or promotional messages.
An HSM is a template message with placeholders for dynamic data. All HSMs need to be approved by WhatsApp before they can be sent to the user. Read more about how to send notifications here.
As per WhatsApp’s rules, a consumer opt-in is mandatory. A robust opt-in and good quality content is necessary to maintain the status of the registered WhatsApp phone number. Lack of attention here can result in the number getting flagged for content or warned.
We have a repository of ways a user can Opt-In on WhatsApp, view it here.
Text Notifications - You can send textual notifications to your customers in the format mentioned below. You can choose to format it using Header, body, and footer or just add your message in the body section to send a simple text notification.
Media Notifications - Send messages containing images or documents (pdfs) to your customers.
Interactive Notifications - Message templates that can be used with a customized call-to-action buttons and quick replies.
Read more about media HSMs here.
- Check that templates do not contain promotional messaging, which is against our Business Policy
- Ensure content is informative and helpful for your core customers
- Confirm you are sending notifications to customers who have explicitly opted-in to receive them
- Use the correct format & correctly tag templates
- Spellcheck message language
- Evaluate the frequency at which you are contacting your customers
Read more about guidelines of HSMs here.
WhatsApp comes with restrictions on how to design an HSM, the main restriction being no promotional content, so when there is a client requirement for adding bits of promotion they have to be tackled with care.
Some examples of approved vs rejected HSMs are mentioned below -
- WhatsApp allows brands to engage with consumers only if they want to engage with you, it’s a medium to connect with existing customers and not for making new ones which is why promotional content is a big no-no in WA, which is why any notifications which have promotional content in them will be rejected by WA. WhatsApp will notify you if the HSM is rejected but the whole message is marked as promotional and rejected.
- No spam content - WhatsApp is only a way of communicating with a brand's existing customers whose messages can only be sent as notifications, alerts, announcements, or one-to-one conversations, and any content that WhatsApp finds spammy they will reject instantly.
- Invalid message format - If you submit an HSM with dynamic values in one curly bracket they get rejected. We have to follow WhatsApp’s HSM structure for approval.
- Sales, discounts, promotions, product recommendations or offers
- Recurring content
- Customer re-engagement
- Product or marketing/brand surveys
- Businesses asking customers to review their app
- Businesses asking a customer to share notifications with multiple customers
- Businesses that send reminders or alerts that a customer may have indicated an interest in seeing (not related to a purchase or event)
There are different statuses for phone numbers that usually refer to its connection status (e.g., Connected, Offline, etc.). Occasionally, a phone number may show one of two particular statuses that are related to quality and messaging limits: Flagged and Restricted.
Which brands can send notifications and build IVAs on WhatsApp? You can read about it here.
You can read about best practices for notifications given by WhatsApp here.