База знаний 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-кнопки и reply-клавиатура, callback (нажатие кнопки → реакция), реакции-эмодзи, deep-link /start, редактирование, удаление и пересылка сообщений, reply как триггер, события участников, права и модерация. Фотокарусель листается кнопками в одном сообщении. Форматирование текста: Plain / HTML / Markdown. Шаблонов, списков и сессионного окна нет (они не нужны в Telegram).

WhatsApp (через WhatsApp Cloud API): своя специфика: inline-кнопки, callback, реакции-эмодзи, deep-link /start, шаблоны сообщений, списки (interactive list) и 24-часовое сессионное окно. Форматирование: Plain / Markdown. Не поддерживает reply-клавиатуру, редактирование, удаление и пересылку сообщений, reply как триггер, события участников, права/модерацию и листание карусели в одном сообщении. Подробнее: на странице WhatsApp.

VK: сообщения и вложения, inline-кнопки и reply-клавиатура, 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: оформленаdonut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: продленаdonut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: закончиласьdonut_subscription_expiredнет
VK Donut: отмененаdonut_subscription_cancelledнет

{{event.donut_amount}}: сумма платежа, {{event.donut_amount_without_fee}}: сумма без комиссии VK. У «закончилась» и «отменена» сумм нет: окончание оплаченного срока ничего о деньгах не говорит, и подставить туда прошлый платёж значило бы придумать цифру.

Это событие о подписчике, а не сообщение от него. Поэтому оно не отмечает диалог доступным для личных сообщений, не снимает блокировку, не двигает «последнюю активность» и не увеличивает счётчик сообщений: списание с карты не означает, что человек написал. Если такого подписчика платформа ещё не знает, он создаётся: иначе к нему нельзя было бы применить метки и права.

Типовой сценарий «клуб по подписке»:

  1. Реакция на VK Donut: оформлена (и такая же на продлена): действие Изменить метки → добавить метку «Клуб» со сроком ttl_days = 31, плюс сообщение со ссылкой на закрытое сообщество клуба и просьбой подать заявку на вступление.
  2. Одобрение заявки: отдельный шаг после того, как подписчик её подал. Действие Изменить права → Одобрить заявку принимает уже поданную заявку (groups.approveRequest); пока заявки нет, одобрять нечего. Поставьте его в реакцию, которая срабатывает после шага 1: например, на кнопку «Я отправил заявку» под тем же сообщением, или на следующее событие продлена.
  3. Реакция на Метка истекла (label_expired): действие Изменить права → Исключить. Так подписчик выходит из клуба ровно тогда, когда истёк срок метки, независимо от того, пришло ли от VK событие «закончилась». Подробнее: Триггеры → Метка истекла.
  4. Реакция на VK Donut: отменена и закончилась: Изменить метки → удалить «Клуб» и при необходимости Исключить сразу.

Поле «Чат» (chat_id) в действиях с правами для VK должно содержать идентификатор подключённого сообщества (то же число, что показано у канала 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 зарегистрируйте показанный MyBot адрес в настройках сервера сообщества и задайте совпадающие секрет и код подтверждения. Long Poll не требует публичного адреса и этих двух значений. Для WhatsApp зарегистрируйте адрес в приложении Meta, введите такой же Verify Token и подпишитесь на нужные события сообщений. Одних данных для отправки недостаточно для настройки входящих сообщений.

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

Мастер подключения открывает авторизацию Meta. Войдите под аккаунтом, который управляет нужной страницей Facebook или профессиональным Instagram-аккаунтом, предоставьте запрошенные права, затем выберите аккаунты для этого проекта. Мастер проверяет права, подписку на вебхук и готовность доставки; устраните неудачные проверки перед использованием канала. В существующем подключении можно пересмотреть выбранные аккаунты.