Свой бот и мини-приложение

На тарифе Клубный сообщество может работать через собственного бота — с вашим именем и аватаром вместо ботов Orbo. Поддерживаются обе площадки: Telegram и MAX.

Где настраивается

В меню слева раздел «Группы» → значок шестерёнки → вкладки «Свой бот TG» и «Свой бот MAX». Вкладки видны только владельцу и администраторам и только на Клубном тарифе.

Telegram

  1. Найдите в Telegram бота @BotFather и отправьте ему команду /newbot. Придумайте имя и юзернейм (должен заканчиваться на _bot).
  2. Там же отправьте /setprivacy → выберите своего бота → Disable. Без этого бот не видит сообщения в группах, и аналитика будет пустой.
  3. Скопируйте токен в поле на вкладке «Свой бот TG» и нажмите «Подключить».
  4. Удалите @orbo_community_bot из своих групп и добавьте вместо него своего — администратором.

В Telegram ваш бот заменяет @orbo_community_bot полностью: и работу в группах, и личные сообщения участникам.

MAX

  1. Откройте в MAX мини-приложение «MAX для бизнеса» и пройдите верификацию профиля организации. Без неё создать бота нельзя — это отличие от Telegram, где бот заводится за минуту.
  2. Создайте бота и скопируйте токен во вкладку «Свой бот MAX».
  3. Добавьте бота в свои MAX-группы администратором — права нужны, чтобы он видел состав группы и мог выдавать доступ по членству.
  4. На вкладке «Max» нажмите «Проверить» у каждой группы — статусы пересчитаются уже по вашему боту.

Важное отличие от Telegram. В MAX ваш бот работает в группах — публикует анонсы, ведёт учёт участников, выдаёт доступ по членству. А личные сообщения по-прежнему отправляет бот Orbo. Причина в самой площадке: бот в MAX не может написать человеку первым, диалог всегда открывает участник — и открывает его с конкретным ботом. Если перевести личку на нового бота, вся накопленная доставка обнулится и каждому придётся начинать диалог заново.

Мини-приложение

Мини-приложение (членство, регистрация на события, анкеты) открывается через бота — имя бота стоит в самой ссылке. Поэтому подключённый бот это половина дела: само мини-приложение на нём не появляется, его нужно зарегистрировать.

  • Telegram: @BotFather → /newapp → выберите своего бота → название, описание, картинка → адрес https://my.orbo.ru/tg-app
  • MAX: «MAX для бизнеса» → ваш бот → раздел мини-приложений → адрес https://my.orbo.ru/max-app

После этого поставьте галочку «Мини-приложение зарегистрировано» на вкладке своего бота — только тогда ссылки начнут вести на него.

Пока галочка снята, ссылки ведут на бота Orbo и всё работает. Так сделано нарочно: если переключить ссылки раньше, чем мини-приложение заведено, участники откроют пустой экран.

Если бот перестал отвечать

Раз в сутки Orbo проверяет связь с вашим ботом. Если он не отвечает (например, токен отозван), владелец и администраторы получают уведомление — в Telegram, а если его нет, то на почту. Проверить вручную можно кнопкой «Проверить связь» на той же вкладке.

Отключение

Кнопка «Отключить» снимает бота с подписки на события. Группы продолжат работать через бота Orbo, если он в них есть — поэтому перед отключением своего бота верните в группы бота Orbo.