> 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FovQ8u5txgh6fHvmx152b%2Fimage.png?alt=media&amp;token=00aedcdb-6a6d-4f03-9546-2be29ed2143c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F9jmNCYflHD9VGllmOgA6%2Fimage.png?alt=media&amp;token=db14e896-a7b0-428c-9999-a21d93ec2688" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F2fZKl8RuOUgZ66o0cDn3%2Fimage.png?alt=media&amp;token=e194a366-bc97-4497-9935-033a6c589375" 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2Fwn78MlZOq4GkSAi2ozRW%2Fimage.png?alt=media&amp;token=6deb384d-1119-4f0e-b4e1-be883819e91c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FGlhwEYVMWd37B7XXvwtw%2Fimage.png?alt=media&amp;token=fa929bfe-b303-46bd-9010-d7db9ba20eec" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FtGXm13FuzhCgwvD0WYEl%2Fimage.png?alt=media&amp;token=1afee9aa-fe0a-41c2-bf62-46772f849005" 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FaghauReKjYo70uqZEKMO%2Fimage.png?alt=media&amp;token=229ddb67-5cd6-4c18-b1dc-cb2b35edfef8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F2MXjrlMgXdPRheEJwwYQ%2Fimage.png?alt=media&amp;token=71502fc1-13d0-428c-85f8-57f143245549" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F0PHd8nSD4u0DyBDYnAa2%2Fimage.png?alt=media&amp;token=68bf52a0-829a-42bd-9bc3-2339a5730e8b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FI5ZevJlxAzWK7lE3LmM3%2Fimage.png?alt=media&amp;token=da0d341b-46bf-4527-b60b-f847a94d6009" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FdffEAkGCt69RFEA3H0r9%2Fimage.png?alt=media&amp;token=f7796f2f-5655-4565-8c1f-443a3bcca5ee" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F2o6agYfvpjQCBl68nXuA%2Fimage.png?alt=media&amp;token=5f18faf7-a2ad-4804-b000-c3afe23b108d" 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="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FFpIVlie8gFrEBAyg06wN%2Fimage.png?alt=media&amp;token=5aa3b0a9-2efe-4e4e-988a-fc4fb2d90daa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FaRtyFCjH5j2aSoDqkYuP%2Fimage.png?alt=media&amp;token=03b6c6f7-0ad3-4e02-8b15-0c3e9442c726" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FrUVab4u00aH0hNAmK82m%2Fimage.png?alt=media&amp;token=19e5c6be-0d5d-4f24-b148-f58129c59222" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FTq76Tz6777vTTx8afhan%2Fimage.png?alt=media&amp;token=412b2077-cecb-4c6f-b82c-cfb867ee2c96" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FLMfBegw6sWXON6gQ5thB%2Fimage.png?alt=media&amp;token=ad21a7b1-ac85-410c-ad37-f1eaeea5c566" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FbKqXlW3CEuKfJK6gvY61%2Fimage.png?alt=media&amp;token=3b4a385a-c20a-4123-bf28-a4c2acea3021" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2F6G7kNn7GkA4zMTvMIEsM%2Fimage.png?alt=media&amp;token=5651a5a2-d3e7-4f24-8641-de25611fb2bb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FgnY0ffOvTgEjKYNKAuui%2Fimage.png?alt=media&amp;token=eaf53ff9-485c-4c9a-bec8-f4a543d3fabe" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2328171809-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fth75wDp9OEz0ABIMvgWP%2Fuploads%2FUa2I8Wxf0OI1ePCNlsFz%2Fimage.png?alt=media&amp;token=f70b4689-1d55-4f6b-b0f0-782f50f167c5" alt=""><figcaption></figcaption></figure>