Начало работы / MHUB
Полный гайд: подключение платного канала в MAX
Пошаговая инструкция: создайте закрытый канал, подключите бота, настройте тарифы и платёжную систему. Полный онбординг для новых пользователей.
MHUB позволяет продавать доступ в закрытый канал или чат MAX через бота. Подписчики оплачивают тариф — бот автоматически добавляет их в канал и удаляет при истечении подписки.
При создании проекта вы выбираете один из двух режимов работы:
| Свой бот | Без своего бота | |
|---|---|---|
| Что нужно | Бот в MAX с токеном | Ничего — используется технический бот MHUB |
| Как пользователи платят | Через вашего бота | Через публичную страницу оплаты MHUB |
| Кто управляет ботом | Вы | MHUB |
| Подходит для | Полный контроль, свой брендированный бот | Быстрый запуск без регистрации бота |
Если вы не уверены — начните с режима «Без своего бота». Перейти на свой бот можно позже.
Вариант А. Свой бот в MAX
Шаг 1. Создайте закрытый канал в MAX
- Откройте приложение MAX и создайте новый канал.
- В настройках канала установите тип «Закрытый».
- ⚠️ Важно: отключите «Заявки на вступление» в настройках канала.
Если заявки на вступление включены — каждое добавление придётся подтверждать вручную. Бот сам управляет участниками, поэтому заявки должны быть отключены.
Шаг 2. Создайте бота в MAX
- Подтвердите статус ИП в MAX Business — это необходимо для создания бота.
- После подтверждения создайте бота по инструкции.
- Бот проходит модерацию — обычно занимает несколько часов.
- После модерации получите токен бота (длинная строка из букв и цифр).
Токен выглядит примерно так:
003.AbCdEfGhIjKlMnOpQrStUvWxYz...
Подробная инструкция: Где взять токен клиентского бота
Шаг 3. Создайте проект в MHUB
- Откройте админ-бот MHUB в MAX.
- Нажмите «Создать проект».
- Выберите тип «Платная подписка».
- Введите название проекта (видно только вам).
- Выберите режим «У меня есть свой бот в MAX».
- Если у вас уже есть подключённые боты — выберите нужного из списка. Если нет — вставьте токен бота, полученный на шаге 2.
- Выберите канал или чат из списка доступных (бот автоматически подтянет список чатов, в которых состоит).
Если канал не появился в списке — убедитесь, что бот добавлен в канал как администратор (шаг 4).
Шаг 4. Добавьте бота в канал администратором
- Откройте ваш закрытый канал в MAX.
- Перейдите в настройки → Администраторы.
- Добавьте вашего бота как администратора.
- Выдайте боту права: добавление участников, удаление участников.
Без прав администратора бот не сможет добавлять и удалять подписчиков.
Шаг 5. Настройте тарифы
- После создания проекта бот предложит создать первый тариф. Нажмите «Создать тариф» (или перейдите позже: ваш проект → Продажи → Тарифы → Создать тариф).
- Заполните поля:
- Название — отображается в боте (например: «1 месяц», «3 месяца», «Навсегда»).
- Цена — сумма в рублях.
- Длительность — количество дней доступа (0 = бессрочно).
- Выберите, к каким каналам/чатам даёт доступ этот тариф (если у проекта несколько каналов).
- Создайте столько тарифов, сколько нужно — они все появятся в боте кнопками.
Шаг 6. Подключите платёжную систему
MHUB поддерживает три платёжные системы: YooKassa, Robokassa и Prodamus.
Перейдите в ваш проект → Продажи → Платёжные системы и выберите нужную.
YooKassa
- Зарегистрируйтесь в YooKassa.
- Получите ShopID и Секретный ключ в личном кабинете YooKassa.
- В админ-боте MHUB → ваш проект → Продажи → Платёжные системы → YooKassa → введите ShopID и секретный ключ.
- В личном кабинете YooKassa пропишите Webhook URL:
https://mhub-max.ru/v1/integrations/yookassa/webhook
Событие: payment.succeeded
Подробная инструкция: Подключение YooKassa
Robokassa
- Зарегистрируйтесь в Robokassa.
- Получите Merchant Login, Пароль 1 и Пароль 2 в кабинете Robokassa.
- В админ-боте MHUB → ваш проект → Продажи → Платёжные системы → Robokassa → введите данные.
- В кабинете Robokassa → Технические настройки → Result URL пропишите:
https://mhub-max.ru/v1/integrations/robokassa/result
Подробная инструкция: Подключение Robokassa
Prodamus
- Зарегистрируйтесь на Prodamus.
- Создайте платёжную страницу и скопируйте ссылку на неё (вида
https://demo.payform.ru/). - Скопируйте секретный ключ из настроек страницы.
- В админ-боте MHUB → ваш проект → Продажи → Платёжные системы → Prodamus → введите ссылку и секретный ключ.
- В кабинете Prodamus → Настройки → Уведомления → URL уведомлений пропишите:
https://mhub-max.ru/v1/integrations/prodamus/webhook
⚠️ Без настройки Webhook/Result URL оплаты не будут подтверждаться автоматически.
Подробная инструкция: Подключение Prodamus
Вариант Б. Без своего бота
Если у вас нет своего бота в MAX или вы хотите запуститься быстрее — используйте режим без бота. Подписчики будут оплачивать через публичную страницу оплаты MHUB, а технический бот MHUB автоматически выдаст доступ в канал.
Шаг 1. Создайте закрытый канал в MAX
- Откройте приложение MAX и создайте новый канал.
- В настройках канала установите тип «Закрытый».
- ⚠️ Важно: отключите «Заявки на вступление» в настройках канала.
Шаг 2. Добавьте технического бота MHUB в канал
- Добавьте бота MHUB (его ID покажет админ-бот на этапе создания проекта) администратором в ваш закрытый канал.
- Выдайте боту права: добавление участников, удаление участников.
Шаг 3. Создайте проект в MHUB
- Откройте админ-бот MHUB в MAX.
- Нажмите «Создать проект».
- Выберите тип «Платная подписка».
- Введите название проекта.
- Выберите режим «Без своего бота».
- Перешлите любое сообщение из вашего закрытого канала в админ-бот. Это нужно, чтобы MHUB определил канал.
- Альтернативно можно ввести числовой chat_id канала вручную.
⚠️ Перед пересылкой убедитесь, что технический бот MHUB уже добавлен администратором в канал (шаг 2). Без этого привязка не сработает.
После создания проекта MHUB автоматически сгенерирует публичную страницу оплаты по адресу вида:https://mhub-max.ru/pay/<ваш-слаг>
Этот адрес можно изменить в настройках проекта.
Шаг 4. Настройте тарифы
Аналогично варианту А — бот предложит создать первый тариф сразу после создания проекта.
Шаг 5. Подключите платёжную систему
Аналогично варианту А — поддерживаются YooKassa, Robokassa и Prodamus. Настройки и webhook-адреса те же.
При регистрации в платёжных системах вам потребуются юридические документы (оферта, политика конфиденциальности). Их можно сгенерировать прямо в MHUB: ваш проект → Настройки → Реквизиты и документы → Юр. документы.
Как работает бот с подписчиком
После настройки система автоматически выполняет весь цикл:
| Событие | Что происходит |
|---|---|
Пользователь пишет /start боту (свой бот) или открывает страницу оплаты (без бота) |
Отображаются тарифы с ценами |
| Выбор тарифа и оплата | Генерируется ссылка на оплату, пользователь переходит на страницу платёжной системы |
| Оплата прошла | Пользователь получает подтверждение и ссылку-приглашение в канал |
| Добавление в канал | Автоматически после подтверждения оплаты |
| За 1 день до конца | Напоминание о скором окончании подписки |
| Подписка истекла | Уведомление и предложение продлить |
| Удаление из канала | Автоматически после истечения подписки |
Дополнительные возможности
Несколько каналов в одном проекте
В настройках проекта → Каналы и чаты можно добавить несколько каналов или чатов. Каждый тариф можно привязать к своему набору каналов — например, базовый тариф открывает один канал, а премиум — три.
Промокоды
Создайте промокод в проекте → Продажи → Промокоды → Создать:
- Скидка — процент от цены тарифа (например, 30%).
- Срок сгорания — через сколько дней промокод сгорает у пользователя после активации.
- Лимит активаций — максимальное число использований (или без ограничений).
- Действителен до — конкретная дата окончания действия.
Пользователь вводит промокод перед оплатой — цена автоматически пересчитывается.
Ссылки для бесплатного доступа
В проекте → Подписчики → Выдать подписку можно создать ссылку для бесплатного доступа:
- Пользователь переходит по ссылке → попадает в бота → подписка активируется без оплаты.
- Удобно для раздачи бесплатного доступа, переноса подписчиков или партнёрских программ.
- Можно ограничить количество активаций.
Настройка сообщений бота
В настройках проекта → Тексты и кнопки можно кастомизировать:
- Приветствие — текст при первом обращении к боту.
- Список тарифов — заголовок перед тарифами.
- Окончание подписки — текст при истечении.
- Напоминание — текст за день до окончания.
Юридические документы
В настройках проекта → Реквизиты и документы → Юр. документы можно:
- Сгенерировать оферту и политику конфиденциальности автоматически.
- Или указать ссылки на свои документы.
Эти документы понадобятся при регистрации в платёжных системах.
Рассылки
В проекте → Рассылки можно отправлять массовые сообщения подписчикам.
Ручная выдача доступа
Администратор может вручную выдать доступ пользователю без оплаты — через раздел управления подписками в проекте.
Частые ошибки
Бот не добавляет в канал
→ Проверьте, что бот является администратором канала с правами на добавление и удаление участников.
Пользователи попадают в канал без оплаты
→ Убедитесь, что «Заявки на вступление» отключены в настройках канала в MAX.
Бот не отвечает на сообщения
→ Проверьте правильность токена в настройках проекта. Если используете режим «без бота» — это нормально, взаимодействие происходит через страницу оплаты.
Оплата прошла, но доступ не выдан
→ Проверьте Webhook/Result URL в кабинете платёжной системы — он должен точно совпадать с указанным в настройках:
- YooKassa:
https://mhub-max.ru/v1/integrations/yookassa/webhook - Robokassa:
https://mhub-max.ru/v1/integrations/robokassa/result - Prodamus:
https://mhub-max.ru/v1/integrations/prodamus/webhook
Канал не появляется при создании проекта (свой бот)
→ Бот должен быть добавлен в канал до создания проекта. Добавьте бота администратором и повторите.
«Привязка не сработает» при создании проекта (без бота)
→ Технический бот MHUB должен быть добавлен администратором в канал до пересылки сообщения. Добавьте бота и повторите.