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

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

К тарифу Профессиональный своих ботов можно подключить отдельной опцией за 1 000 ₽/мес — оставьте заявку прямо на вкладке «Свой бот TG» или «Свой бот 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 (если участник открывал диалог с ним), а если ни того ни другого — письмо на email. Накопленная достижимость бота Orbo на ваш бот не переносится — попросите участников написать новому боту.

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

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

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

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

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

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

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

Отключение

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