Каналы: 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. У «закончилась» и «отменена» сумм нет: окончание оплаченного срока ничего о деньгах не говорит, и подставить туда прошлый платёж значило бы придумать цифру.
Это событие о подписчике, а не сообщение от него. Поэтому оно не отмечает диалог доступным для личных сообщений, не снимает блокировку, не двигает «последнюю активность» и не увеличивает счётчик сообщений: списание с карты не означает, что человек написал. Если такого подписчика платформа ещё не знает, он создаётся: иначе к нему нельзя было бы применить метки и права.
Типовой сценарий «клуб по подписке»:
- Реакция на VK Donut: оформлена (и такая же на продлена): действие Изменить метки → добавить метку «Клуб» со сроком
ttl_days= 31, плюс сообщение со ссылкой на закрытое сообщество клуба и просьбой подать заявку на вступление. - Одобрение заявки: отдельный шаг после того, как подписчик её подал. Действие Изменить права → Одобрить заявку принимает уже поданную заявку (
groups.approveRequest); пока заявки нет, одобрять нечего. Поставьте его в реакцию, которая срабатывает после шага 1: например, на кнопку «Я отправил заявку» под тем же сообщением, или на следующее событие продлена. - Реакция на Метка истекла (
label_expired): действие Изменить права → Исключить. Так подписчик выходит из клуба ровно тогда, когда истёк срок метки, независимо от того, пришло ли от VK событие «закончилась». Подробнее: Триггеры → Метка истекла. - Реакция на VK Donut: отменена и закончилась: Изменить метки → удалить «Клуб» и при необходимости Исключить сразу.
Поле «Чат» (chat_id) в действиях с правами для VK должно содержать идентификатор подключённого сообщества (то же число, что показано у канала VK в списке каналов). VK может управлять участниками только этого сообщества. Если указать другой ID, действие будет отклонено до отправки в VK. Для управления другим сообществом подключите его отдельным каналом.
Как включить события:
- Long Poll: бот подписывается на них сам: при подключении канала и при каждом запуске платформы, так что уже подключённым сообществам ничего делать не нужно.
- Callback API: откройте в настройках сообщества Работа с API → Callback API → Типы событий → VK Donut и включите все четыре события из таблицы выше.
Как подключить канал
Каналы добавляются на странице Проекты.
- Откройте Проекты и найдите нужный проект.
- Нажмите Добавить канал на карточке проекта.
- Выберите платформу: Telegram, WhatsApp или VK.
- Введите реквизиты канала (для Telegram: токен, для WhatsApp: набор реквизитов Meta, для VK: реквизиты сообщества).
- Нажмите Проверить: платформа проверит реквизиты на стороне мессенджера.
- Нажмите Подключить.
Для WhatsApp и VK после подключения у канала появляется адрес вебхука (иконка 🔗). Этот адрес нужно прописать на стороне платформы (в приложении Meta для WhatsApp, в настройках сообщества для VK), чтобы входящие события доходили до бота. Как это сделать для WhatsApp: см. 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-аккаунтом, предоставьте запрошенные права, затем выберите аккаунты для этого проекта. Мастер проверяет права, подписку на вебхук и готовность доставки; устраните неудачные проверки перед использованием канала. В существующем подключении можно пересмотреть выбранные аккаунты.