You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<td style={{ paddingLeft: '40px' }}><b>Last Updated: October 2025</b></td>
7
+
<td style={{ paddingLeft: '40px' }}><b>Last Updated: December 2025</b></td>
8
8
</tr>
9
9
</table>
10
10
</h3>
11
11
12
-
13
-
**HSM (Highly Structured Message) templates are pre-approved message formats required for sending outbound messages to contacts outside the 24-hour WhatsApp session window.
12
+
**HSM (Highly Structured Message) templates are pre-approved message formats required for sending outbound messages to contacts outside the 24-hour WhatsApp session window.
14
13
These templates help ensure compliance with WhatsApp’s policies and are commonly used to send notifications, alerts, or support messages.
15
14
Templates can include placeholders for personalized content and are essential for initiating conversations once the 24- hour session window has expired.**
16
15
@@ -24,7 +23,6 @@ Session Window - A session window refers to the 24-hour period following a user'
24
23
25
24
- For initiating conversation with the contacts after the 24-hour session window is closed, such as sending reminders or important follow-ups.
26
25
27
-
28
26
- For broadcasting standardized updates, like activity schedules, weather alerts, crop advisories, appointment confirmations, service announcements,programs and events
29
27
30
28
---
@@ -49,65 +47,69 @@ Session Window - A session window refers to the 24-hour period following a user'
49
47
<br />
50
48
<br />
51
49
52
-
4. Fill in the following details in the form.
50
+
4.Fill in the following details in the form.
53
51
54
-
a.`Is Active`- the check box is by default checked. Keep it checked.
55
-
56
-
b. `Language` - Select the preferred language from the dropdown to ensure the template gets approved in that specific language.
52
+
a.`Is Active`- the check box is by default checked. Keep it checked.
b. `Language` - Select the preferred language from the dropdown to ensure the template gets approved in that specific language.
59
55
60
-
c. `Translate existing HSM` - Select this if the HSM template you are trying to apply has a language variant of an existing HSM template in a different language. If not then no need to enable it.
61
-
62
-
d. `Element Name` - Provide a title for WABA namespace for the HSM template. Incase the translate existing HSM is selected, this field becomes a drop down. From the list select the element name of the HSM template for which the language variant is being applied.
63
-
64
-
e. `Title` - Enter the name you want for your HSM Template as it would appear in Glific (It should be what use case does this template serves eg. OTP, Optin,
c. `Translate existing HSM` - Select this if the HSM template you are trying to apply has a language variant of an existing HSM template in a different language. If not then no need to enable it.
70
59
71
-
f. `Message` - Type the message you want to send to users in this HSM template.
60
+
d. `Element Name` - Provide a title for WABA namespace for the HSM template. Incase the translate existing HSM is selected, this field becomes a drop down. From the list select the element name of the HSM template for which the language variant is being applied.
72
61
73
-
g. `Add Variable` - Click on add variable if you'd like to insert a variable values (ex- preferred names, locations, any other value being captured in flow or contact variables). This provides further fields below to enter a sample value for the variables.
62
+
e. `Title` - Enter the name you want for your HSM Template as it would appear in Glific (It should be what use case does this template serves eg. OTP, Optin,
_(Ensure Title and Template Name are not identical to avoid mapping issues.)_
76
68
77
-
78
-
h. `Footer` - Add the message which you want to act like a subtext.
69
+
f. `Message` - Type the message you want to send to users in this HSM template.
79
70
80
-
i. `Add Buttons` - You can use `Add Buttons` checkbox to use buttons in HSM templates.
81
-
82
-
- Quick Replies is selected by default which allows to add 3 buttons to the message
71
+
g. `Add Variable` - Click on add variable if you'd like to insert a variable values (ex- preferred names, locations, any other value being captured in flow or contact variables). This provides further fields below to enter a sample value for the variables.
- Call to action buttons: Add a Call to Action (CTA) button in an HSM (template) message when the recipient is expected to take a specific action directly from the message.
75
+
h. `Footer` - Add the message which you want to act like a subtext.
i. `Add Buttons` - You can use `Add Buttons` checkbox to use buttons in HSM templates.
78
+
79
+
- Call to Action is selected by default. Click the dropdown and select the Quick Replies option.
80
+
81
+
<imgwidth="389"height="212"alt="Screenshot 2025-12-09 at 1 40 59 PM"src="https://github.com/user-attachments/assets/ba9a52ae-b85a-4aa9-bbf5-de326270766d" />
82
+
83
+
- You can add up to 10 buttons in the Quick Reply option.
84
+
<imgwidth="398"height="746"alt="Screenshot 2025-12-09 at 1 43 19 PM"src="https://github.com/user-attachments/assets/8a60319d-1d42-46df-94e0-46b13c3773e4" />
89
85
90
-
- There are two main options:
91
86
92
-
-**Phone number** and **URL**.
93
-
94
-
-**Note:-** Phone numbers without country code (for example Exotel numbers) will be added in HSM as an `Call to actions` option. As a workaround, you can add these numbers in the body of the message.
95
87
96
-
- If selected **URL**, must choose between **Static** and **Dynamic** links.
88
+
- Call to action buttons: Add a Call to Action (CTA) button in an HSM (template) message when the recipient is expected to take a specific action directly from the message.
89
+
90
+
<imgwidth="366"height="326"alt="Screenshot 2025-12-09 at 1 52 47 PM"src="https://github.com/user-attachments/assets/bdc55bb6-64f6-4d04-9430-3d19ee4acce5" />
97
91
98
-
Here's a simple explanation with examples:
92
+
93
+
- There are two main options:
94
+
95
+
-**Phone number** and **URL**.
96
+
97
+
-**Note:-** Phone numbers without country code (for example Exotel numbers) will be added in HSM as an `Call to actions` option. As a workaround, you can add these numbers in the body of the message.
98
+
99
+
- If selected **URL**, must choose between **Static** and **Dynamic** links.
100
+
101
+
Here's a simple explanation with examples:
99
102
100
103
**Static URL**
101
104
102
105
- A Static URL is a fixed link. It will be the same for everyone who receives the message.
103
106
104
107
- Use it when the link doesn't change.
105
108
106
-
107
109
**Example:**
108
110
109
111
- Sending a message about online training. The requirement is that all users visit the same registration page.
110
-
Button Title: Register Now
112
+
Button Title: Register Now
111
113
112
114
- Button Value: `https://xyz.org/register`
113
115
@@ -119,7 +121,6 @@ Button Title: Register Now
119
121
120
122
- Use it when the link includes unique details per user.
121
123
122
-
123
124
**Example:**
124
125
125
126
- Send a personalized health report to each user.
@@ -130,35 +131,33 @@ Button Title: Register Now
130
131
131
132
- When sent, `{{1}}` will be replaced by the user's specific ID, like 12345 or abc678.
132
133
133
-
134
134
<imgwidth="503"alt="Screenshot 2024-07-01 at 5 13 14 PM"src="https://github.com/glific/docs/assets/141305477/09ec727f-46bf-4242-a95a-caebb6763491"/>
135
135
136
-
137
-
j. `Category` - Select the most relevant category from the dropdown. Ex. Utility or Marketing.
136
+
j. `Category` - Select the most relevant category from the dropdown. Ex. Utility or Marketing.
138
137
139
-
- Utility: Used for transactional messages to keep your customers in the loop with essential order updates, shipping status, about their accounts, orders, appointment reminders, and important alerts.
140
-
141
-
- Marketing: Elevate your brand by sending promotional content, announcing new products, and offering special deals to captivate your audience. For instance, promotional messages, including special offers, product launches, and loyalty programs
138
+
- Utility: Used for transactional messages to keep your customers in the loop with essential order updates, shipping status, about their accounts, orders, appointment reminders, and important alerts.
142
139
143
-
144
-
k. `Attachment type` - Select the attachment type to send an attachment in your HSM template message Ex. Image, Audio, Video, etc.
145
-
146
-
l. `Attachment URL` - Paste the attachment URL ( public URL) from the GCS bucket. Refer [Upload files on GCS](https://glific.github.io/docs/docs/Pre%20Onboarding/GCS%20Setup/Upload%20files%20on%20GCS/#upload-media-files-in-the-gcs-bucket)
147
-
Note - Attachment Type & URL are optional. It needs to be filled only if an attachment is required to be sent in the HSM template to the beneficiary.For more info please check [this](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines)
140
+
- Marketing: Elevate your brand by sending promotional content, announcing new products, and offering special deals to captivate your audience. For instance, promotional messages, including special offers, product launches, and loyalty programs
148
141
149
-
Notice a simulator available in the form, as you will fill in the details of the HSM template, it will start previewing the message.
142
+
k. `Attachment type` - Select the attachment type to send an attachment in your HSM template message Ex. Image, Audio, Video, etc.
143
+
144
+
l. `Attachment URL` - Paste the attachment URL ( public URL) from the GCS bucket. Refer [Upload files on GCS](https://glific.github.io/docs/docs/Pre%20Onboarding/GCS%20Setup/Upload%20files%20on%20GCS/#upload-media-files-in-the-gcs-bucket)
145
+
Note - Attachment Type & URL are optional. It needs to be filled only if an attachment is required to be sent in the HSM template to the beneficiary.For more info please check [this](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines)
146
+
147
+
Notice a simulator available in the form, as you will fill in the details of the HSM template, it will start previewing the message.
150
148
Simulator helps you to get an idea about how the message will look like when the contact receives it.
m. `Tag`s - Add tags if required, not a mandatory step.
153
+
m. `Tag`s - Add tags if required, not a mandatory step.
154
+
155
+
n. Click on `Submit for Approval`,
156
+
157
+
- Click on the Sync button on the HSM list page, after a couple of minutes to see the change in status of HSM from Pending to either `Approved` or `Rejected`
156
158
157
-
n. Click on `Submit for Approval`,
158
-
- Click on the Sync button on the HSM list page, after a couple of minutes to see the change in status of HSM from Pending to either `Approved` or `Rejected`
Generally it takes a maximum of `2 mins to 48 hours` to get approval from WhatsApp.
163
162
Once you get your message approved, you can start sending it to your contacts. Verify that the `Status` of your message has turned **Approved** from the `Templates` page
164
163
@@ -171,7 +170,6 @@ Once you get your message approved, you can start sending it to your contacts. V
171
170
172
171
- A new template must be created to replace the rejected one.
173
172
174
-
175
173
## Can I Edit a Template After Approval?
176
174
177
175
- No, WhatsApp approval is immutable.
@@ -196,15 +194,16 @@ You can use approved HSM templates in your flow, to send to multiple users autom
<imgwidth="613"height="463"alt="Screenshot 2025-12-10 at 7 07 20 PM"src="https://github.com/user-attachments/assets/252d355c-a3b4-4b54-bf23-c7b60fd63eb6" />
200
198
201
199
3 . Select the HSM template you want to send from the dropdown list. Refer [HSM Templates](https://glific.github.io/docs/docs/Product%20Features/HSM%20Templates/) to know more about how to create HSM templates.
<imgwidth="604"height="465"alt="Screenshot 2025-12-10 at 7 08 27 PM"src="https://github.com/user-attachments/assets/2c611989-9d82-4c7f-af8d-f7420468a2f5" />
208
207
209
208
5 . Click on `Ok` button.
210
209
@@ -315,6 +314,13 @@ Multiple templates can also be applied by using Bulk Apply HSM templates using G
315
314
1.`Quick Reply 1 Title:` Add Text that would appear on first button when button type is `QUICK_REPLY`
316
315
1.`Quick Reply 2 Title:` Add Text that would appear on second button when button type is `QUICK_REPLY`
317
316
1.`Quick Reply 3 Title:` Add Text that would appear on third button when button type is `QUICK_REPLY`
317
+
1.`Quick Reply 4 Title:` Add Text that would appear on fourth button when button type is `QUICK_REPLY`
318
+
1.`Quick Reply 5 Title:` Add Text that would appear on fifth button when button type is `QUICK_REPLY`
319
+
1.`Quick Reply 6 Title:` Add Text that would appear on sixth button when button type is `QUICK_REPLY`
320
+
1.`Quick Reply 7 Title:` Add Text that would appear on seventh button when button type is `QUICK_REPLY`
321
+
1.`Quick Reply 8 Title:` Add Text that would appear on eight button when button type is `QUICK_REPLY`
322
+
1.`Quick Reply 9 Title:` Add Text that would appear on ninth button when button type is `QUICK_REPLY`
323
+
1.`Quick Reply 10 Title:` Add Text that would appear on tenth button when button type is `QUICK_REPLY`
318
324
319
325
4. Click on `File` -> `Download` -> `Comma Separated Values(.csv)` to download sheet in csv format
320
326
@@ -353,4 +359,3 @@ By default, there is a **limit of 250 HSM templates per phone number**. If incas
353
359
**Note** - The HSM templates need to be in one language. Do not mix the languages in one template (Ex. words of both English and Hindi language should not be in one HSM template).
0 commit comments