# WhatsApp Business API Конструктор MaviBot також підтримує офіційний WhatsApp Business API. ## Як підключити WhatsApp Business Щоб підключити WhatsApp Business API (WABA) до свого проєкту, перейдіть до **Месенджери** розділ і виберіть **WhatsApp Business API**.
**Підключення WhatsApp Business API**
У вікні, що відкриється, увійдіть за допомогою свого облікового запису Facebook. Потім натисніть кнопку "Підключити через Facebook". За потреби введіть пароль Facebook, щоб продовжити.
Налаштування завершено. Вам не потрібно постійно тримати телефон онлайн; бот працюватиме стабільно й автономно. ## Шаблони повідомлень для WhatsApp Business API Під час використання WhatsApp Business Api користувачі не можуть писати клієнтам у будь-який час доби та надсилати необмежену кількість повідомлень під час створення бота, подібно до сірого Whatsapp, поза 24-годинним вікном обслуговування клієнтів. Поза межами 24-годинного вікна можна використовувати лише шаблони повідомлень WhatsApp (або шаблонні повідомлення WhatsApp), під час яких спілкування відбувається безкоштовно в межах обраної категорії. Ця функція використовується в WhatsApp для запобігання спам-розсилкам шляхом обмеження кількості дозволених повідомлень у певний проміжок часу, а також шляхом призначення категорії для шаблонів. У WhatsApp Business Api від Meta встановлено такі категорії повідомлень: 1\. Корисні шаблони (містять конкретну інформацію про транзакції, рахунки, платежі тощо); 2\. Шаблони для маркетингу (інформація про компанію, організацію, стратегії, рекламу та просування); 3\. Шаблони для верифікації та автентифікації.
Шаблони, створені для WABA, проходять модерацію. ### Основні причини відхилення шаблонів Значна кількість шаблонів не проходить модерацію WhatsApp з кількох причин: 1. **Надмірна реклама:** WhatsApp Business відхиляє шаблони, перевантажені рекламою та промоконтентом. Якщо модератори або ШІ платформи визначать, що реклама затьмарює основне повідомлення, шаблон буде заблоковано. 2. **Порушення політики щодо продуктів:** шаблони, що просувають заборонені товари, такі як наркотики, психотропні речовини, алкоголь, тютюн, інтимні послуги або будь-який контент, який вважається таким, що принижує людську гідність, буде відхилено. 3. **Неоднозначність, замовчування або неправдивість:** якщо модератори WhatsApp виявлять прихований підтекст, оманливу інформацію або брак чітких відомостей про вашу компанію чи послугу, шаблон не буде схвалено. 4. **Збір конфіденційної інформації:** шаблони, призначені для збору чутливих даних користувачів (наприклад, номерів паспортів, даних банківської картки, номерів особистих документів, домашніх адрес), не пройдуть модерацію. 5. **Образливий контент:** будь-яке повідомлення, що містить інформацію, яка може образити користувачів за ознакою раси, національності, статі, ідентичності або інших критеріїв, буде відхилено. 6. **Відхилення на розсуд:** модератори WhatsApp залишають за собою право відхиляти шаблони без пояснення конкретної причини. Як встановити шаблони повідомлень Оскільки шаблони створюються з блоків, спочатку потрібно створити блок у вашому сценарії, перш ніж використовувати його для шаблону WhatsApp Business API. * **Вартість і перше повідомлення:** Надсилання шаблонних повідомлень безкоштовне в межах 24-годинного вікна розмови. **перше повідомлення** клієнту може бути лише шаблон, схвалений Meta (Facebook). * **Після 24 годин:** Після того як мине 24 години з моменту відкриття чату, ви можете надіслати лише інший схвалений шаблон, щоб знову залучити користувача. * **Примітка щодо модерації:** Шаблони можуть не пройти модерацію, якщо вони містять змінні (кирилицею або латиницею). ## **Створення шаблонів у MaviBot** 1. Перейдіть на вкладку **Розділ** , виберіть **WhatsApp Business API**і потім оберіть **Шаблони повідомлень**.
2. Натисніть **кнопку "Створити шаблон"** . Відкриється сторінка створення шаблону. 3. Шаблони прив’язуються до блоків у вашому сценарії. За замовчуванням вміст шаблону береться з блоку, але ви можете вказати власний текст і кнопки.
4. Шаблон повідомлення буде надіслано на модерацію після створення. **Ви можете використовувати лише схвалені шаблони.** Модерація зазвичай триває близько 8 годин, максимум — 48 годин. ## Типи шаблонів Доступні 3 типи шаблонів на вибір. Ви можете додати зображення до **MARKETING** шаблону в таких форматах: SVG, PNG, JPG і GIF. #### Як передавати змінні в шаблонах Змінні в шаблонах обробляються так само, як і в усьому MaviBot, а не відповідно до нативного формату WhatsApp. {% hint style="danger" %} Наша система адаптована для змінних MaviBot і **не підтримує** змінні у `{{1}}` форматувати {% endhint %} #### Використання змінних у шаблонних повідомленнях WhatsApp Якщо вам потрібно використовувати змінні в шаблонах повідомлень, дотримуйтеся такого правила: **завжди пишіть назви змінних лише латинськими літерами**, наприклад, `#{example}`. Після надсилання перевірте, чи змінні обробляються правильно, переглянувши повідомлення через наданий [посилання](https://business.facebook.com/wa/manage/message-templates/). Якщо шаблон містить змінну, але бот не призначає їй значення або значення відсутнє, повідомлення **не буде надіслано**! ## Як працюють кнопки в шаблонах Шаблони повідомлень підтримують кнопки. У MaviBot кнопки налаштовуються подібно до синтаксису Facebook API. Ознайомитися з ним можна, перейшовши за [посилання](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): Кнопки задаються у форматі масиву JSON. **Параметри створення кнопок:** | Параметр | Обов’язково | Опис | | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | type | Так | Значення: PHONE\_NUMBER, URL і QUICK\_REPLY | | text | Так | Текст кнопки | | url | Ні |

URL, який буде відкрито

коли кнопку натиснуто. Ви можете використовувати змінні, щоб

створювати динамічні посилання.

| | phone\_number | Ні |

Номер телефону, на який

буде здійснено дзвінок, коли кнопку натиснуть

| | приклад | Ні |

Надає приклад можливих даних для вашого шаблону. Це допомагає під час перевірки та схвалення, щоб ви могли

зрозуміти, яке повідомлення ви плануєте надсилати. Переконайтеся

що це приклади і вони не містять жодної конфіденційної чи особистої інформації.

| Наприклад: Повідомлення з двома кнопками: \[{"type":"QUICK\_REPLY", "text": "Так, зручно"}, {"type":"QUICK\_REPLY", "text": "Незручно"}] ### Функції кнопок у шаблонах У шаблонних повідомленнях доступні два типи кнопок: 1. **Call-To-Action (CTA):** Кнопка для посилання або номера телефону (відображається з іконкою посилання або слухавки поруч із текстом). 2. **Швидка відповідь:** Стандартні текстові кнопки з обмеженням у 20 символів. **Обмеження:** * Один шаблон може містити до **3 кнопок швидкої відповіді** та до **2 кнопок Call-to-Action**. Однак ви не можете одночасно використовувати два посилання або два номери телефону. * Кнопки не можуть містити змінні, розриви рядка, емодзі або символи форматування. **Поведінка:** * Натискання на **кнопку** Швидка відповідь * Один **Call-to-Action** може відкривати посилання на файл. * Натискання на **Call-to-Action** кнопка для телефонного дзвінка відкриває стандартну клавіатуру набору номера. У WhatsApp Web з’явиться сповіщення про те, що дзвінки не можна здійснювати з десктопної версії. ### Як працює модерація шаблонів Кожен шаблон надсилається на модерацію одразу після створення. Зазвичай процес триває **близько 8 годин**, а максимальний час перевірки становить **48 годин**. Ви можете відстежувати статус модерації у своєму списку шаблонів. Якщо шаблон відхилено, буде вказано причину відхилення. **Шаблони з високою ймовірністю схвалення зазвичай:** * Використовують зрозумілу, професійну мову. * Служать для конкретного, легітимного випадку використання (наприклад, нагадування про зустрічі, оновлення замовлень). **Важливо:** Текст у *курсив* може бути змінним і налаштовуваним. Привіт, нам не вдалося з вами зв’язатися. Чи було б вам зручно продовжити спілкування тут? Привіт, ви залишили повідомлення на сайті й попросили мене зв’язатися з вами. (може бути змінено) Привіт, я Джон Сміт із MaviBot. Раніше ви подали заявку на створення чат-бота. Раді повідомити, що в нас для вас є новини. Шаблони, які не пройдуть модерацію: будь-який рекламний текст #### **Як перевірити, чи ви в межах 24-годинного вікна** Ви можете визначити, скільки днів минуло з моменту останнього повідомлення клієнта, використовуючи `days_from_last_message()` функцію у вашій умові тригера. **Приклад перевірки 24-годинного вікна:** `days_from_last_message() == 0` ### Як використовувати кнопки без шаблонів Поза шаблонами доступні два типи кнопок, які налаштовуються так само, як і в інших месенджерах: 1. [**Кнопки відповіді:**](/doc/uk/chatbot/builder/knopki.md) Максимум **3** можна використовувати в блоці. 2. [**Вбудовані кнопки**](/doc/uk/chatbot/builder/knopki.md)**:** Ви можете створити до **10**, і вони відображаються, як показано в прикладі. **Важливі обмеження для кнопок без шаблонів:** * Кнопки можуть містити лише **text**. **Посилання не підтримуються.** * Їхня єдина функція — **переміщувати клієнта з одного блоку до іншого** у вашому сценарії. *** **Обмеження для неперевірених облікових записів** Неперевірені бізнес-облікові записи Facebook мають такі обмеження: * **50 шаблонних повідомлень на день** (включено до щомісячної плати). * **Без обмежень** на вхідні повідомлення. Щоб зняти ці обмеження, ваша компанія має пройти **Business Verification** процес, який зазвичай триває **2–3 тижні**. ## Платіжні системи Уточніть у свого реселера вартість вхідних і вихідних повідомлень для неперевірених облікових записів. {% hint style="info" %} Оплата здійснюється безпосередньо до **360dialog**. {% endhint %} ## Помилки надсилання повідомлень **Можливі причини невдалого доставлення:** 1. Номер телефону отримувача не зареєстрований у WhatsApp. 2. Спроба надіслати шаблон із **"Authentication"** категорії користувачеві WhatsApp з кодом країни **+91 (Індія)**. Наразі шаблони категорії Authentication не можуть бути доставлені користувачам в Індії. 3. Отримувач не прийняв оновлені **Умови надання послуг** та **Політика конфіденційності**. 4. Повідомлення не було доставлено, щоб підтримувати високоякісний досвід користувача (це загальне блокування за політикою). --- # 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://docs.mavibot.ai/doc/uk/chatbot/mesendzheri/waba.md?ask= ``` 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.