Білдер MaviBot також підтримує офіційний WhatsApp Business API.

Як підключити WhatsApp Business

Щоб підключити WhatsApp Business API (WABA) до вашого проєкту, перейдіть у розділ Messengers і виберіть WhatsApp Business API.

Підключення WhatsApp Business API

У вікні, що відкриється, увійдіть за допомогою свого облікового запису Facebook. Потім натисніть кнопку «Connect via Facebook».

Якщо потрібно, введіть пароль від Facebook, щоб продовжити.

Налаштування завершено. Вам не потрібно постійно тримати телефон онлайн; бот працюватиме стабільно та автономно.

Шаблони повідомлень для WhatsApp Business API

Під час використання WhatsApp Business API користувачі не можуть писати клієнтам у будь-який час доби та надсилати необмежену кількість повідомлень під час створення бота, подібно до сірого WhatsApp, поза 24-годинним вікном обслуговування клієнтів.

Поза 24-годинним вікном можна використовувати лише шаблони повідомлень WhatsApp (або шаблонні повідомлення WhatsApp), під час яких спілкування відбувається безкоштовно в межах вибраної категорії.

Ця функціональність використовується у WhatsApp для запобігання спам-розсилкам шляхом обмеження кількості дозволених повідомлень у певному часовому інтервалі, а також шляхом призначення категорії шаблонам.

Meta встановила такі категорії повідомлень для WhatsApp Business API:

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. Перейдіть у розділ Channels, виберіть WhatsApp Business API, а потім оберіть Message templates.

  1. Натисніть кнопку «Create template». Відкриється сторінка створення шаблону.
  2. Шаблони прив’язані до блоків у вашому потоці. За замовчуванням вміст шаблону береться з блоку, але ви можете вказати власний текст і кнопки.

  1. Шаблон повідомлення буде надіслано на модерацію після створення. Ви можете використовувати лише схвалені шаблони. Модерація зазвичай займає близько 8 годин, максимум 48 годин.

Типи шаблонів

Доступні 3 типи шаблонів на вибір.

Ви можете прикріпити зображення до шаблону MARKETING у таких форматах: SVG, PNG, JPG і GIF.

Як передавати змінні в шаблонах

Змінні в шаблонах обробляються так само, як і в усьому MaviBot, а не за рідним форматом WhatsApp.

Наша система адаптована для змінних MaviBot і не підтримує змінні у форматі {{1}}

Використання змінних у шаблонних повідомленнях WhatsApp

Якщо вам потрібно використовувати змінні в шаблонах повідомлень, дотримуйтеся цього правила: завжди пишіть назви змінних лише латинськими літерами, наприклад, #{example}. Після надсилання перевірте, чи правильно обробляються змінні, перевіривши повідомлення за наданим посиланням.

Якщо шаблон містить змінну, але бот не присвоює їй значення або значення відсутнє, повідомлення не буде надіслано!

Як працюють кнопки в шаблонах

Шаблони повідомлень підтримують кнопки. У MaviBot кнопки задаються подібно до синтаксису

Facebook API. Ви можете ознайомитися з ним за посиланням:

Кнопки задаються у форматі JSON-масиву.

Параметри створення кнопок:

Параметр Обов’язковий Опис
type Так Значення: PHONE_NUMBER, URL і QUICK_REPLY
text Так Текст кнопки
url Ні

URL-адреса, яка відкриється

під час натискання кнопки. Ви можете використовувати змінні для

створення динамічних посилань.
phone_number Ні

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

буде здійснено дзвінок під час натискання кнопки
example Ні

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

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

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

Наприклад: Повідомлення з двома кнопками: [{"type":"QUICK_REPLY", "text": "Yes, convenient"}, {"type":"QUICK_REPLY", "text": "Inconvenient"}]

Особливості кнопок у шаблонах

У шаблонних повідомленнях доступні два типи кнопок:

  1. Call-To-Action (CTA): кнопка для посилання або номера телефону (відображається зі значком посилання або трубки поруч із текстом).
  2. Quick Reply: стандартні текстові кнопки з обмеженням у 20 символів.

Обмеження:

  • Один шаблон може містити до 3 кнопок Quick Reply і до 2 кнопок Call-to-Action. Однак не можна використовувати два посилання або два номери телефонів одночасно.
  • Кнопки не можуть містити змінні, розриви рядків, емодзі або символи форматування.

Поведінка:

  • Натискання кнопки Quick Reply надсилає її текст як повідомлення-відповідь від користувача.
  • Кнопка Call-to-Action може відкривати посилання на файл.
  • Натискання кнопки Call-to-Action для телефонного дзвінка відкриває стандартний набірник. У WhatsApp Web з’явиться сповіщення про те, що дзвінки неможливо здійснювати з десктопної версії.

Як працює модерація шаблонів

Кожен шаблон надсилається на модерацію одразу після створення. Процес зазвичай займає близько 8 годин, максимальний час перевірки — 48 годин.

Ви можете відстежувати статус модерації у списку шаблонів.

Якщо шаблон відхилено, буде надано причину відхилення.

Шаблони з високою ймовірністю схвалення зазвичай:

  • Використовують чітку, професійну мову.
  • Служать конкретній, легітимній меті (наприклад, нагадування про зустріч, оновлення замовлень).

Важливо: Текст курсивом може бути змінним і налаштовуватися.

Привіт, ми не змогли зв’язатися з вами. Чи зручно вам продовжити спілкування тут?

Привіт, ви залишили повідомлення на сайті та попросили зв’язатися з вами. (може змінюватися)

Привіт, я Джон Сміт із MaviBot. Раніше ви подали заявку на створення чат-бота. Ми раді повідомити вам, що маємо для вас новини.

Шаблони, які не пройдуть модерацію:

будь-який рекламний текст

Як перевірити, чи ви в межах 24-годинного вікна

Ви можете визначити, скільки днів минуло з моменту останнього повідомлення клієнта, використовуючи функцію days_from_last_message() у вашій умові тригера.

Приклад перевірки 24-годинного вікна:

days_from_last_message() == 0

Обмеження для неперевірених облікових записів

Неперевірені облікові записи Facebook Business мають такі обмеження:

  • 50 шаблонних повідомлень на день (включено в щомісячну плату).
  • Без обмежень на вхідні повідомлення.

Щоб зняти ці обмеження, ваша компанія має пройти процес Business Verification, який зазвичай займає 2–3 тижні.

Платіжні системи

Уточніть у свого реселера вартість вхідних і вихідних повідомлень для неперевірених облікових записів.

Оплата здійснюється безпосередньо 360dialog.

Помилки надсилання повідомлень

Можливі причини збою доставки:

  1. Номер телефону отримувача не зареєстрований у WhatsApp.
  2. Спроба надіслати шаблон із категорії «Authentication» користувачу WhatsApp із кодом країни +91 (Індія). Наразі шаблони категорії Authentication не можуть бути доставлені користувачам в Індії.
  3. Отримувач не прийняв оновлені Умови надання послуг та Політику конфіденційності.
  4. Повідомлення не було доставлено для підтримки високоякісного користувацького досвіду (це загальне блокування політики).

Конверсії з реклами Click-to-WhatsApp

Доповнення до документації для функції fb_pixel_event().

Meta* позначає кожен клік із реклами Click-to-WhatsApp ідентифікатором кліку ctwa_clid. Він отримується разом із першим повідомленням клієнта у WhatsApp і використовується для атрибуції конверсії з розмови до конкретної реклами — подібно до того, як події пікселя атрибуються до кліку на вебсайті.

Сигнатура

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Нові параметри

Параметр Опис
ctwa_clid Ідентифікатор кліку для реклами Click-to-WhatsApp. Якщо цей параметр не вказано, використовується клієнтська змінна ctwa_clid, яку бот зберігає автоматично. Необов'язковий.
messaging_channel Канал обміну повідомленнями, де сталася конверсія. За замовчуванням — whatsapp. Необов'язковий.

Нове значення action_source

До таблиці значень action_source додано такий рядок:

Значення Опис
business_messaging Конверсія відбулася в розмові після того, як клієнт натиснув рекламу Click-to-WhatsApp.

Подія надсилається як конверсія в обміні повідомленнями, якщо виконується принаймні одна з таких умов:

  • надано action_source="business_messaging";
  • надано ctwa_clid;
  • надано messaging_channel.

У цьому випадку Meta* отримує комбінацію action_source + messaging_channel + ctwa_clid. Без цієї комбінації клік по рекламі не буде зараховано до конверсії.

Значення website не можна використовувати для конверсій в обміні повідомленнями: подія дійде до пікселя, але не буде зарахована до реклами.

Клієнтські змінні

Коли клієнт надсилає повідомлення WhatsApp після натискання на рекламу, бот зберігає дані про клік у клієнтських змінних. Вам не потрібно заповнювати ці змінні вручну.

Змінна Опис
ctwa_clid Ідентифікатор кліку. Автоматично додається до події.
ctwa_clid_time Час отримання ідентифікатора у форматі Unix time. Його можна використовувати, щоб визначити, скільки часу минуло з моменту кліку.
wa_ads_data Дані про рекламу у форматі JSON: URL реклами, ID реклами (source_id), заголовок, опис, тип креативу та URL креативу.

Ідентифікатор кліку автоматично береться з клієнтської змінної, тому вам не потрібно передавати його у функцію явно.

Номер телефону клієнта автоматично додається до події, якщо його не вказано в data.

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

Обмеження

Ідентифікатор кліку отримується лише з першим повідомленням клієнта після натискання кнопки в рекламі. Він не включається в наступні повідомлення. Тому подію можна надіслати в будь-який момент розмови, але лише якщо перше повідомлення надійшло з реклами.

Meta* надає ctwa_clid для кліків із застосунків Facebook* та Instagram* на Android та iOS.

Ідентифікатор не надається, коли клієнт натискає з браузера або натискає звичайний допис, а не кнопку в рекламі. Конверсії з таких взаємодій не можуть бути зараховані до реклами.

Якщо клієнт пізніше натискає іншу рекламу, змінні перезаписуються. Конверсія зараховується до останньої реклами, з якої прийшов клієнт.

Якщо ідентифікатор кліку відсутній і в параметрах функції, і в клієнтських змінних, функція повертає помилку No ctwa_clid variable in client variables, і подія не надсилається.