WhatsApp

GetMyBot підключає WhatsApp через WhatsApp Cloud API (Meta Graph API). Після підключення бот приймає вхідні повідомлення з WhatsApp і застосовує до них ваші реакції, а оператори можуть вести листування в діалогах. Загальний огляд мультиканальності — на сторінці Канали.

Підключення WhatsApp-каналу

Для підключення потрібні п'ять реквізитів із вашого застосунку Meta (WhatsApp Cloud API). Усі вони обов'язкові:

  • Phone number ID — ідентифікатор номера WhatsApp Business.
  • WABA ID — ідентифікатор WhatsApp Business Account.
  • Access token — токен доступу застосунку Meta.
  • Verify token — довільний рядок, який ви вигадуєте самі. Він використовується під час верифікації вебхука в Meta (див. нижче).
  • App secret — секрет застосунку Meta. Потрібен для перевірки HMAC-підпису вхідних вебхуків (заголовок X-Hub-Signature-256).

Кроки в інтерфейсі:

  1. Відкрийте Боти → «Додати канал» → WhatsApp.
  2. Заповніть п'ять полів вище і, за бажанням, назву каналу (необов'язково).
  3. Натисніть «Перевірити» — GetMyBot валідує реквізити через Meta.
  4. Натисніть «Підключити».

Налаштування вебхука в Meta

Після підключення у каналу з'являється Callback URL виду {адреса}/ch/{channelID} (в інтерфейсі — іконка вебхука 🔗). Його разом із вашим Verify token потрібно вказати в застосунку Meta: WhatsApp → Configuration → Webhook.

Як це працює:

  1. Meta надсилає на Callback URL verify-запит і звіряє переданий verify_token з вашим Verify token. При збігу вебхук вважається підтвердженим.
  2. Далі Meta шле на цю адресу події (вхідні повідомлення, статуси доставки, вердикти модерації шаблонів).
  3. Кожен вхідний запит підписаний заголовком X-Hub-Signature-256; GetMyBot перевіряє підпис за допомогою App secret — тому цей реквізит і потрібен при підключенні.

24-годинне сесійне вікно

WhatsApp обмежує ініціативне листування: вільні повідомлення можна надсилати користувачеві лише протягом 24 годин після його останнього вхідного повідомлення. Кожне нове вхідне повідомлення від користувача оновлює вікно.

Поза 24-годинним вікном надіслати вільне повідомлення не можна — єдиний спосіб знову написати користувачеві (re-engage) — це схвалений шаблон повідомлення. Тому шаблони — ключовий інструмент для розсилок і нагадувань у WhatsApp.

Шаблони повідомлень

Шаблон (message template) — заздалегідь узгоджене з Meta повідомлення, яке можна надсилати поза сесійним вікном. Керування шаблонами — в інтерфейсі GetMyBot.

Де керувати шаблонами

Боти → у WhatsApp-каналу іконка «Шаблони повідомлень» (📄) → діалог «Шаблони WhatsApp-каналу». У діалозі є кнопки:

  • «Створити шаблон» — зібрати новий шаблон.
  • «Синхронізувати» — підтягнути каталог шаблонів з Meta (актуалізувати статуси й список).

Категорії шаблонів

  • MARKETING (Маркетинг) — акції, анонси, розсилки.
  • UTILITY (Сервісний) — сповіщення за діями користувача (статуси замовлень, нагадування).
  • AUTHENTICATION (Автентифікація) — коди підтвердження.

Поля шаблону

  • Ім'я — малі латинські літери, цифри й _, до 512 символів.
  • Мова — локаль Meta.
  • Категорія — одна з трьох вище.

Для категорій Маркетинг і Сервісний додатково:

  • Заголовок — немає / текст / зображення / відео / документ. Для медіа-заголовка завантажується файл-приклад.
  • Тіло — обов'язково, до 1024 символів. Змінні позначаються {{1}}, {{2}}, … строго по порядку від 1 до N, без пропусків.
  • Футер — до 60 символів.
  • Кнопки — до 10: швидка відповідь, посилання (до 2), телефон (1), копіювання коду (1).
  • На кожну змінну {{n}} потрібно задати приклад значення — це вимога Meta для модерації.

Для категорії Автентифікація тіло фіксоване самою Meta; налаштовуються: термін дії коду (1–90 хвилин), рекомендація щодо безпеки й текст кнопки копіювання коду.

Модерація

Кнопка «Створити» одразу надсилає шаблон на модерацію Meta — окремого кроку «надіслати на перевірку» немає. Вердикт приходить асинхронно (через вебхук), список шаблонів автооновлюється. Статуси:

  • PENDING (На перевірці)
  • APPROVED (Схвалено)
  • REJECTED (Відхилено) — із зазначенням причини
  • а також PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Редагувати можна шаблони в статусах APPROVED, REJECTED, PAUSED. Ім'я та мову змінювати не можна; у схвалених шаблонів категорія теж заблокована.

Використання шаблону в реакції

Надсилання шаблону — це дія реакції:

  1. У конструкторі реакції відкрийте «Дії» → «Додати дію» → «Надіслати шаблон WhatsApp».
  2. Дія доступна, лише якщо у бота підключений WhatsApp-канал із підтримкою шаблонів.
  3. Обирається лише схвалений (APPROVED) шаблон.
  4. Заповнюються параметри: значення змінних {{n}} у тілі, текстовий заголовок, медіа-заголовок за посиланням, параметри URL-кнопок. У параметрах можна використовувати підстановки-змінні.

Реальний канал надсилання визначається каналом події: якщо подія прийшла з WhatsApp, шаблон піде у WhatsApp.

Діалоги та вкладення

Оператор може відповідати у WhatsApp-діалозі й надсилати вкладення — зображення, відео або документ — з урахуванням 24-годинного вікна (поза вікном вільне листування недоступне). Вхідні медіа від підписників підтягуються через проксі й відображаються в діалозі.

Тарифікація

GetMyBot веде облік WhatsApp-розмов (conversations) за категоріями — marketing / utility / authentication / service. У поточній версії це лише запис для спостережуваності (record-only): баланс за розмови не списується.

Що далі

  • Канали — мультиканальність і матриця можливостей.
  • Реакції: основи — як зібрати поведінку бота.
  • Розсилки — масове надсилання (у WhatsApp — через схвалені шаблони).