# HSM-шаблони в WhatsApp Business API

## Що таке HSM-шаблони? <a href="#what-hsm-templates-is" id="what-hsm-templates-is"></a>

**HSM (Highly Structured Message) шаблони** - це заздалегідь погоджені з Meta типові повідомлення, які компанії можуть використовувати для початку спілкування з клієнтами через WhatsApp Business API. Повідомлення можуть містити нагадування про зустрічі, інформацію про доставку оновлення інформації про платежі і т.д.&#x20;

{% hint style="success" %}
Створення та погодження шаблону здійснюється через [WhatsApp Manager](https://business.facebook.com/wa/manage/message-templates/).&#x20;
{% endhint %}

Шаблон може включати заголовок (текст або вкладення: зображення, відео, PDF-файл), основний текст з можливістю додавання змінних, нижній колонтитул та кнопки.

{% hint style="info" %}
На даний момент не підтримується шаблони, що містять Каталог,  Розташування та шаблони Автентифікації з автозаповненням (шаблони Автентифікації з можливістю копіювання коду підтримуються).
{% endhint %}

***

### 24-годинне вікно для спілкування <a href="#id-24-hour-rule" id="id-24-hour-rule"></a>

WhatsApp Business використовує 24-годинні сесії для обміну повідомленнями.

Коли клієнт надсилає повідомлення на ваш номер, відкривається 24-годинне вікно, протягом якого ви можете писати користувачам повідомлення у вільній формі.

Поза межами 24-годинного вікна обслуговування клієнтів ви можете надсилати лише затверджені HSM-шаблони. Як тільки клієнт відповість на повідомлення з шаблоном, відкривається нове 24-годинне вікно для спілкування.

Використання HSM-шаблонів дозволяє ініціювати діалог навіть із клієнтами, які ще не писали до компанії.

***

## Відправка HSM-шаблону з NovaTalks <a href="#send-hsm-template" id="send-hsm-template"></a>

Для відправки HSM-шаблону з NovaTalks необхідно у панелі відправки повідомлень ввести текст у відповідній розмітці, що складається з кількох рядків:

* **@HSM@ -** мітка, що інформує систему, що здійснюється відправка HSM-шаблону.
* **назва\_шаблону|мова -** назва шаблону з маленької літери з нижнім підкресленням та [код мови](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/supported-languages). Мають бути такі ж як і в конструкторі шаблонів Meta.
* **Змінні шаблону -** начення змінних шаблону (якщо існують).

Якщо шаблон містить **вкладення**, то воно має бути прикріплене до повідомлення.

{% hint style="warning" %}
**Особливості додавання змінних:**

* Якщо у шаблонні використовується декілька змінних, то кожна змінна має бути прописана з нового рядка за послідовністю, яка вказана в шаблоні.&#x20;
* Якщо у шаблоні є кнопка, що містить змінну, то значення цієї змінної має бути додано до розмітки.
* Якщо шаблон містить змінні, а в повідомленні вони не вказані, то такий шаблон не буде відправлений.
* Якщо шаблон містить кнопку **Копіювати код**, то в розмітці повідомлення для відправки з NovaTalks код повинен бути вказаний двічі: як значення змінної в основному тексті та як значення змінної для кнопки.
* Ви можете підставляти Змінні NovaTalks. Для цього у відповідному рядку необхідно ввести дві подвійні фігурні дужки {{ після чого з’явиться перелік доступних змінних.
  {% endhint %}

Після відправки шаблону, до повідомлення, що надійде клієнту, підтягнеться текст та інші елементи, з шаблону прописаного в WhatsApp Manager.&#x20;

Користувач NovaTalks у вікні історії повідомлень в Conversation буде бачити його у вигляді розмітки.&#x20;

{% hint style="danger" %}
Перед відправкою шаблону переконайтеся, що повідомлення не містить зайвих пробілів чи символів і чітко відповідає структурі. Інакше воно не буде доставлене.
{% endhint %}

{% hint style="success" %}
Для зручності структуру HSM-шаблону рекомендуємо додати до [Швидких відповідей](/ua/get-started/settings/canned-responses.md).
{% endhint %}

***

## Приклади HSM-шаблонів <a href="#hsm-templates-examples" id="hsm-templates-examples"></a>

### HSM-шаблон без змінних та вкладень <a href="#hsm-template-without-variables-and-attachments" id="hsm-template-without-variables-and-attachments"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/3bNbkqll9sWC5dSljLVP" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/H0SREfS76C94uvV7S81a" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/2J6LSbPa5bIvTqX5JHpJ" alt=""><figcaption></figcaption></figure>

### HSM-шаблон із змінними в Основному тексті <a href="#hsm-template-with-variables-in-body" id="hsm-template-with-variables-in-body"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/meTa0zukDoGRtU07uwfM" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/pR5Lh9i168vUuj3uOcP8" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/Sk6iwrZQ0FA54xTNpPA1" alt=""><figcaption></figcaption></figure>

### HSM-шаблон з використанням змінної **NovaTalks**  <a href="#hsm-template-using-the-novatalks-variable" id="hsm-template-using-the-novatalks-variable"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/PiqiTxHHPB6UVpI68KOC" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/5ovLHntXS5FEnlIMeb0h" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/OBAWpOdCPPxb7S4fpi6N" alt=""><figcaption></figcaption></figure>

### HSM-шаблон з Кнопкою <a href="#hsm-template-with-a-button" id="hsm-template-with-a-button"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/bhDjQhwSg7ruSbl1lNBq" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/1ryeZRdyaXBhlXpboT7E" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/lH52FPh9QXUpyqJe9PdO" alt=""><figcaption></figcaption></figure>

### HSM-шаблон із змінними в Заголовку, Основному тексті та Кнопці <a href="#hsm-template-with-variables-in-the-header-body-and-button" id="hsm-template-with-variables-in-the-header-body-and-button"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/kWH8gfrMXWDOeSQGF6qv" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/itchIWqyrz36R0q1h50B" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/kwqZoLtXImviKV2HFcyf" alt=""><figcaption></figcaption></figure>

### HSM-шаблон із вкладенням <a href="#hsm-template-with-attachment" id="hsm-template-with-attachment"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/JmaxmHAtmefxndtW1oEC" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/4zSgcEMXLPq28IaOCgh8" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/AS254Kc6HoOArwqXdGt2" alt=""><figcaption></figcaption></figure>

### HSM-шаблон Автентифікації  <a href="#authentication-hsm-template" id="authentication-hsm-template"></a>

**Налаштування шаблону в Meta:**

<figure><img src="/files/UppmBuWKB5NaBB1Bh9q6" alt=""><figcaption></figcaption></figure>

**Розмітка шаблону для відправки в NovaTalks:**

<figure><img src="/files/vFJhLb3VKYW4NbIfcZXW" alt=""><figcaption></figcaption></figure>

**Повідомлення, що отримає клієнт:**

<figure><img src="/files/zc47Pl70f1iiw4ZJkOM2" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/ua/get-started/conversations/conversation-panel/hsm-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.