> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HSM Templates

> Learn what HSM templates are and how to use them

## What are HSM templates?

HSM (Highly Structured Messages) templates are predefined messages that are used in WhatsApp Business API conversations.

## Why does Meta require HSM templates?

Meta implements HSM templates as a protection measure for WhatsApp users. This system helps to:

* Prevent spam and unwanted messages
* Ensure that business messages are relevant and expected
* Maintain the quality of business communication
* Protect user privacy

Templates must be approved by Meta before they can be used, which ensures they comply with policies and quality standards.

## 24-hour messaging window

When a user interacts with a business message on WhatsApp, a 24-hour "messaging window" opens. During this period:

1. The business can send messages without using HSM templates
2. More fluid and natural communication is allowed
3. Any type of content allowed by WhatsApp can be sent

Once the 24-hour window expires, the business must use an approved HSM template to initiate a new conversation.

## HSM template categories

Meta classifies templates into four main categories:

### 1. Marketing

* Promotions and offers
* Product launches
* Newsletters
* Brand updates
* Event invitations
* [Carousel](./carousel) (templates with multiple interactive cards)

**Note**: Marketing templates have stricter approval requirements and must provide a clear opt-out option.

### 2. Service

* Order confirmations
* Shipping updates
* Appointment reminders
* Customer service notifications
* Account status updates

### 3. Authentication

* Verification codes
* Login confirmations
* Password reset
* Two-step verification
* Security codes

### 4. Utility

* Registration confirmations
* Account updates
* System notifications
* Important alerts
* Billing information

Each category has its own guidelines and approval times. For example:

* Authentication templates are usually approved more quickly
* Marketing templates require more review time
* Service and utility templates have an intermediate approval process

## How to use HSM templates in Treble?

Treble allows you to create HSM templates and use them in your conversational flows.

To create an HSM template, follow these steps:

1. Go to the **HSM Templates** section in Treble.
2. Click on "New template".

<img src="https://mintcdn.com/trebleai/5XNOo1Uq3QVPV6lD/images/where-create-hsm.gif?s=7720991eeff594f443ec50af3c07a4f9" width="2398" height="1466" data-path="images/where-create-hsm.gif" />

3. Enter the template content.
   1. Enter the template name.
   2. Choose the template category and language.
   3. You can customize the template content in three parts:
      * Header: Template header.
      * Body: Template body.
      * Footer: Template footer.
   4. Enter the template language.

4. Click on "Create Template".

**Note**: Once you create the template, Meta reviews it. This process can take 1 to 3 days. Fortunately, Meta has accelerated the HSM template approval process to be almost instantaneous.

<CardGroup cols={1}>
  <Card title="Best practices for HSM templates" icon="whatsapp" href="https://treble.ai/blog/hsm-de-whatsapp/">
    Creating effective HSM templates is key to successful communication with
    your customers. Read our guide to learn the best practices for creating HSM
    templates.
  </Card>
</CardGroup>

## Customize HSM templates with variables

You can customize HSM templates with variables. Variables are dynamic information that you can use in your HSM templates. For example, you can use variables to personalize a customer's welcome message, or to send a customer's name in a message.

To create a variable, you just need to write the variable name in the template content. For example, if you want to send a customer's name in a message, you can write `{{customer_name}}`.

<Note>
  It is important to understand the structure of variables. We recommend that
  the variable name be a clear and descriptive name that does not contain
  special characters or spaces. The variable must be enclosed in double braces `   {{}}`. Additionally, we recommend that the variable be in lowercase and not
  contain spaces.
</Note>

### Example of using variables

<img src="https://mintcdn.com/trebleai/og8nLWcDGdX1vO72/images/sample-vars.png?fit=max&auto=format&n=og8nLWcDGdX1vO72&q=85&s=8300fb356145738da488197cf2b6f150" width="1996" height="1276" data-path="images/sample-vars.png" />

As you can see in the example, the `{{name}}` variable is replaced by the customer's name in the message and the `{{company}}` variable is replaced by the company name in the message.

Treble recognizes the variables you use in your HSM templates and allows you to use them in your conversational flows. When you are going to send a conversation, you can specify the value of the variables for each user you want to send the conversation to.

<CardGroup cols={1}>
  <Card title="Send conversation with variables" icon="paper-plane" href="/en/docs/main-platform/send-convo">
    Learn how to send conversations with variables in Treble.
  </Card>
</CardGroup>

## Approval status of HSM templates

You can see the approval status of your HSM templates in the **HSM Templates** section in Treble. When you first create a template, its status will be "Pending".

<img src="https://mintcdn.com/trebleai/fEXY_VeSPQYS96-P/images/hsm-state.png?fit=max&auto=format&n=fEXY_VeSPQYS96-P&q=85&s=e3a12b56d8027753c6be58f312d9d9aa" width="2470" height="1302" data-path="images/hsm-state.png" />

Once Meta approves the template, its status will change to "Approved".

<img src="https://mintcdn.com/trebleai/fEXY_VeSPQYS96-P/images/hsm-state-approved.png?fit=max&auto=format&n=fEXY_VeSPQYS96-P&q=85&s=bb37296fffa4d31bc80a77ecb476911c" width="2470" height="1302" data-path="images/hsm-state-approved.png" />

We recommend that you always check the approval status of your HSM templates before using them in your conversational flows. Since Meta's approval time can vary, it is important that you always keep an eye on this status, you just need to refresh the page to see the updated status.

From this view you can also see the approval status of each template. There are different approval statuses:

* **Approved** 🟢: The template has been approved by Meta. The template can be used in your conversational flows.
* **Pending** 🟡: The template is in the approval process.
* **Rejected** 🔴: The template has been rejected by Meta. The template can be rejected for different reasons, such as inappropriate content, lack of clarity in the opt-out option, or non-compliance with WhatsApp policies.

## Edit HSM templates

You can edit an HSM template in the **HSM Templates** section in Treble. To do this, click on the **"Edit"** button <Icon icon="pencil" iconType="solid" /> on the template you want to edit. When you click, you will be redirected to the template editing view. Keep in mind that you can only edit the content of the template, you cannot change the category, name, or language of the template.

<img src="https://mintcdn.com/trebleai/aaCrgms9mLKayuxp/images/edit-hsm.png?fit=max&auto=format&n=aaCrgms9mLKayuxp&q=85&s=374f4395a678d3a95dede1888e20c95a" width="2464" height="1296" data-path="images/edit-hsm.png" />

<div class="hr" />

## Frequently asked questions

<AccordionGroup>
  <Accordion title="For my outbound conversations, do I need to approve all message blocks?">
    No, you do not need to approve all message blocks. You only need to approve
    the message block that initiates the conversation. When your customer
    responds, you can use any message block.
  </Accordion>
</AccordionGroup>