База знань GetMyBot

Канали: Telegram, WhatsApp, VK

Як підключити Telegram, WhatsApp і VK до одного проєкту. Відмінності між каналами й те, куди бот надсилає відповідь.

На цій сторінці

Один проєкт GetMyBot може відповідати в Telegram, WhatsApp і VK. Наприклад, реакція з розкладом занять працюватиме в усіх трьох месенджерах. Відповідь повернеться туди, звідки написала людина.

Коли підключаєте ще один месенджер, перевірте кнопки й дії: можливості платформ різняться. Нижче наведено основні відмінності та порядок підключення.

Що таке канал

Канал – це підключений спосіб доставки: певний Telegram-бот, номер WhatsApp Business або спільнота VK. Один проєкт GetMyBot може мати кілька каналів. Реакції спільні для всіх: якщо підписник напише у WhatsApp, подію оброблять ті самі реакції, що й у Telegram, а відповідь піде назад у WhatsApp.

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

Основний канал (primary_channel)

У кожного бота є основний канал (primary_channel): платформа, з якою він насамперед пов’язаний. Зазвичай це Telegram, але бота можна відразу створити як WhatsApp- або VK-бота, без Telegram. Основний канал визначається під час створення й відображається у списку ботів. Інші канали можна додати пізніше.

Можливості каналів

Нижче перелічено можливості кожного месенджера. Актуальну матрицю в машинному форматі повертає API: GET /api/channels/capabilities.

Telegram має повний набір можливостей: inline-кнопки та клавіатуру відповідей, callback (натискання кнопки запускає реакцію), реакції-емодзі, deep-link /start, редагування, видалення й пересилання повідомлень, відповідь як тригер, події учасників, права й модерацію. Фотокарусель можна гортати кнопками в одному повідомленні. Форматування тексту: Plain / HTML / Markdown. Шаблонів, списків і сесійного вікна немає, бо в Telegram вони не потрібні.

WhatsApp через WhatsApp Cloud API підтримує inline-кнопки, callback, реакції-емодзі, deep-link /start, шаблони повідомлень, інтерактивні списки (interactive list) та 24-годинне сесійне вікно. Форматування: Plain / Markdown. Не підтримує клавіатуру відповідей, редагування, видалення й пересилання повідомлень, відповідь як тригер, події учасників, права й модерацію та гортання каруселі в одному повідомленні. Докладніше – у статті WhatsApp.

VK підтримує повідомлення й вкладення, inline-кнопки та клавіатуру відповідей, callback, реакції-емодзі, deep-link /start, редагування, видалення й пересилання повідомлень, події учасників, блокування й розблокування, схвалення вже поданої заявки на вступ до закритої спільноти та події платної підписки VK Donut. Форматування – лише звичайний текст: HTML і Markdown видаляються під час відображення. Шаблонів WhatsApp, списків, гортання каруселі в одному повідомленні та сесійного вікна у VK немає.

Усі три канали підтримують inline-кнопки, callback, реакції-емодзі та deep-link /start. Блок фотокаруселі доступний у каналах, що підтримують фото. У Telegram картки можна гортати в одному повідомленні, якщо для всіх фото є придатні ідентифікатори файлів. У WhatsApp і VK, а також у Telegram без таких ідентифікаторів, картки надсилаються окремими фотоповідомленнями. Докладніше – у статті Повідомлення та кнопки.

VK Donut

Якщо у спільноті ввімкнено VK Donut, бот отримує системні події платної підписки:

Подія в конструкторіКлючПідстановки
VK Donut: subscription created (оформлено)donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolonged (продовжено)donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expired (термін сплив)donut_subscription_expiredнемає
VK Donut: subscription cancelled (скасовано)donut_subscription_cancelledнемає

{{event.donut_amount}} – сума платежу, {{event.donut_amount_without_fee}} – сума без комісії VK. Події завершення або скасування підписки не містять сум: завершення оплаченого періоду не є новим платежем, тому підставляти попередню суму було б помилкою.

Це подія про підписника, а не повідомлення від нього. Вона не робить діалог доступним для особистих повідомлень, не знімає блокування, не змінює час останньої активності й не збільшує лічильник повідомлень. Списання грошей із картки не означає, що людина написала боту. Якщо платформа ще не знає підписника, його профіль буде створено, інакше до нього неможливо застосувати мітки та права.

Приклад клубу за підпискою:

  1. Створіть реакції на VK Donut: subscription created і VK Donut: subscription prolonged. У кожній додайте дію Змінити мітки → додати мітку «Клуб» із терміном ttl_days = 31, а також повідомлення з посиланням на закриту спільноту й проханням подати заявку на вступ.
  2. Схвалення заявки – окремий крок після того, як підписник її подав. Дія Змінити права → Схвалити заявку приймає вже подану заявку (groups.approveRequest); поки заявки немає, схвалювати нічого. Додайте цю дію до реакції, що спрацьовує після першого кроку: наприклад, на кнопку «Я подав заявку» під тим самим повідомленням або на наступну подію VK Donut: subscription prolonged.
  3. Створіть реакцію на Label expired (label_expired) з дією Змінити права → Виключити. Підписник залишить клуб, щойно закінчиться термін мітки, незалежно від того, чи прийде від VK подія завершення підписки. Докладніше – у статті Тригери → термін мітки сплив.
  4. Створіть реакції на VK Donut: subscription cancelled і VK Donut: subscription expired з дією Змінити мітки → видалити «Клуб» і, за потреби, Виключити підписника одразу.

У полі Чат (chat_id) для дій із правами VK вкажіть ID підключеної спільноти. Це те саме число, яке показано біля VK-каналу у списку каналів. VK може керувати учасниками лише цієї спільноти. Якщо вказати інший ID, дію буде відхилено ще до звернення до VK. Для керування іншою спільнотою підключіть її окремим каналом.

Як увімкнути події:

  • Long Poll: бот підписується на них автоматично під час підключення каналу й кожного запуску платформи. Для вже підключених спільнот нічого робити не потрібно.
  • Callback API: відкрийте в налаштуваннях спільноти Робота з API → Callback API → Типи подій → VK Donut і ввімкніть усі чотири події з таблиці.

Як підключити канал

Канали додаються на сторінці Проєкти.

  1. Відкрийте Проєкти і знайдіть потрібний проєкт.
  2. Натисніть Додати канал на картці проєкту.
  3. Виберіть Telegram, WhatsApp або VK.
  4. Введіть дані каналу: для Telegram – токен, для WhatsApp – дані Meta, для VK – дані спільноти.
  5. Натисніть Перевірити: платформа перевірить дані на боці месенджера.
  6. Натисніть Підключити.

Для WhatsApp і VK після підключення з’явиться адреса вебхука (іконка 🔗). Укажіть її на боці відповідної платформи: у застосунку Meta для WhatsApp або в налаштуваннях спільноти для VK. Так вхідні події надходитимуть до бота. Інструкція для WhatsApp – у статті WhatsApp → Налаштування вебхука.

Що далі

Облікові дані каналу

Telegram використовує повний токен BotFather. Для VK потрібні токен спільноти та числовий ID спільноти; для Callback API також потрібні секретний рядок і код підтвердження. Для WhatsApp вкажіть Phone Number ID, ID бізнес-акаунта WhatsApp, токен із доступом до акаунта, Verify Token вебхука й App Secret застосунку Meta.

Перевірте дані перед підключенням. Коли змінюєте ключ, оновлюйте пов’язане налаштування у провайдера: Verify Token підтверджує адресу вебхука, App Secret перевіряє підпис вхідних подій. Вони не замінюють токен доступу до API.

Вхідні події та адреси вебхуків

Для VK Callback API зареєструйте показану GetMyBot адресу в налаштуваннях сервера спільноти та вкажіть ті самі секрет і код підтвердження. Long Poll не потребує публічної адреси й цих двох значень. Для WhatsApp зареєструйте адресу в застосунку Meta, вкажіть той самий Verify Token і підпишіться на потрібні події повідомлень. Самих даних для надсилання недостатньо, щоб налаштувати приймання повідомлень.

Авторизація Instagram і Messenger

Майстер підключення відкриває авторизацію Meta. Увійдіть до акаунта, який керує потрібною сторінкою Facebook або професійним акаунтом Instagram, надайте запитані права й виберіть акаунти для цього проєкту. Майстер перевіряє права, підписку на вебхук і готовність доставки. Усуньте помилки перевірки, перш ніж користуватися каналом. У наявному підключенні можна переглянути й змінити вибрані акаунти.