> For the complete documentation index, see [llms.txt](https://help.novatalks.com.ua/ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.novatalks.com.ua/ua/get-started/conversations/conversation-panel/hsm-templates.md).

# 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>