MHUB продаёт доступ в ваш закрытый канал или чат MAX. Подписчик оплачивает
тариф — бот сам добавляет его в канал, напоминает о продлении и автоматически
удаляет, когда подписка закончилась.

---

С чего начать: выберите режим работы

При создании проекта бот спросит, как подписчики будут платить. Есть два режима.

	🤖 Свой бот	🧭 Без своего бота
Что нужно	Свой бот в MAX (нужен статус ИП в MAX Business)	Ничего — работает через технического бота MHUB
Как платят подписчики	Внутри вашего бота	На публичной странице оплаты MHUB (ссылка вида .../pay/ваш-канал)
Кто владеет ботом	Вы	MHUB
Кому подойдёт	Нужен свой брендированный бот и полный контроль	Быстрый запуск без регистрации и модерации бота

Не уверены — начните с «Без своего бота». Перейти на свой бот можно позже.

⚠️ Обе схемы требуют, чтобы бот (ваш или технический MHUB) был
администратором канала с правом добавлять и удалять участников — иначе
он не сможет выдавать и закрывать доступ.

---

Вариант А. Свой бот в MAX

Шаг 1. Создайте закрытый канал

1. Откройте приложение MAX и создайте новый канал.
2. В настройках канала выберите тип «Закрытый».
3. Отключите «Заявки на вступление».
   Если заявки включены, каждое добавление придётся подтверждать вручную, и
   автоматика работать не будет — бот добавляет людей сам.

Шаг 2. Получите бота и его токен

1. Подтвердите статус ИП в MAX Business — без него бота создать нельзя.
2. Создайте бота по инструкции MAX.
3. Дождитесь модерации (обычно несколько часов).
4. Скопируйте токен — длинную строку вида
   003.AbCdEfGh....

📄 Подробнее: Где взять токен клиентского бота.

Шаг 3. Добавьте бота в канал администратором

1. Откройте канал → Настройки → Администраторы.
2. Добавьте вашего бота администратором.
3. Выдайте права: добавление участников и удаление участников.

Сделайте это до создания проекта — тогда канал появится в списке автоматически.

Шаг 4. Создайте проект в MHUB

1. Откройте админ-бот MHUB в MAX.
2. 📂 Проекты → ➕ Создать проект.
3. Выберите тип «💰 ПЛАТНАЯ ПОДПИСКА».
   (Тип «🛒 РАЗОВАЯ ПОКУПКА» — для продажи разового доступа без продления; для
   платного канала выбирайте подписку.)
4. Введите название проекта (видно только вам).
5. Выберите режим «🤖 Подключить своего бота».
6. Выберите бота из списка уже подключённых или нажмите
   «🤖 Подключить нового бота» и пришлите токен из шага 2.
7. Выберите канал из списка — бот сам подтянет чаты, где он состоит.
   Если нужного канала нет — нажмите «🔄 Обновить список чатов» или пришлите
   chat_id канала одним сообщением.

Канал не появился в списке? Проверьте, что бот добавлен администратором (шаг 3),
и обновите список.

Шаг 5. Настройте тарифы

Сразу после создания проекта бот предложит создать первый тариф. Позже:
💰 Продажи → 💰 Тарифы → ➕ Создать тариф.

Бот спросит по очереди:

1. Название — как тариф виден подписчику (например «1 месяц», «Навсегда»).
2. Цена — сумма в рублях (целое число).
3. Длительность — сколько дней действует доступ. Введите 0 для
   бессрочного доступа.
4. Каналы и чаты — отметьте, к чему даёт доступ этот тариф (если в проекте
   несколько каналов).

Создайте столько тарифов, сколько нужно — все они появятся у подписчика кнопками.

Шаг 6. Подключите приём оплаты

💰 Продажи → 💳 Платежные системы. Доступны четыре варианта:

• ЮKassa — введите ShopID и секретный ключ (из личного кабинета
  ЮKassa). В кабинете ЮKassa пропишите Webhook:
  https://mhub-max.ru/v1/integrations/yookassa/webhook, событие
  payment.succeeded (для рекуррентных списаний добавьте и
  payment.canceled).
  📄 Подробнее про ЮKassa.
• Robokassa — введите название магазина (Merchant Login) и оба пароля
  через пробел одним сообщением (Пароль 1 и Пароль 2). В кабинете Robokassa →
  Технические настройки → Result URL:
  https://mhub-max.ru/v1/integrations/robokassa/result.
  📄 Подробнее про Robokassa.
• Prodamus — введите ссылку на платёжную страницу (вида
  https://demo.payform.ru/) и секретный ключ. В кабинете Prodamus →
  Настройки → Уведомления → URL уведомлений:
  https://mhub-max.ru/v1/integrations/prodamus/webhook.
  📄 Подробнее про Prodamus.
• Карта / СБП (вручную) — без онлайн-кассы: вы задаёте реквизиты для оплаты,
  подписчик присылает чек-скриншот, а вы подтверждаете оплату кнопкой в боте.
  📄 Подробнее про ручную оплату.

⚠️ Без правильно прописанного Webhook / Result URL оплаты не будут
подтверждаться автоматически. Адрес в кабинете платёжной системы должен
точно совпадать с указанным выше.

---

Вариант Б. Без своего бота

Быстрый старт: подписчики платят на публичной странице MHUB, а технический бот
MHUB сам выдаёт доступ.

Шаг 1. Создайте закрытый канал

Так же, как в Варианте А, шаг 1 (тип «Закрытый», заявки на вступление отключены).

Шаг 2. Добавьте технического бота MHUB в канал

1. Админ-бот покажет ID технического бота на этапе создания проекта.
2. Добавьте этого бота администратором в ваш закрытый канал.
3. Выдайте права: добавление и удаление участников.

Шаг 3. Создайте проект в MHUB

1. Админ-бот MHUB → 📂 Проекты → ➕ Создать проект.
2. Тип «💰 ПЛАТНАЯ ПОДПИСКА», введите название.
3. Режим «🧭 Без своего бота».
4. Перешлите любое сообщение из вашего закрытого канала в админ-бот — так
   MHUB определит канал. Или нажмите «⌨️ Ввести chat_id вручную» и пришлите
   числовой ID канала (например -1002799094178).

⚠️ Технический бот должен быть добавлен администратором до пересылки
сообщения (шаг 2) — иначе привязка не сработает.

После создания проекта MHUB сгенерирует публичную страницу оплаты вида
https://mhub-max.ru/pay/ваш-слаг. Адрес можно изменить: ⚙️ Настройки →
🎨 Платёжная страница.

Шаг 4. Настройте тарифы

Так же, как в Варианте А, шаг 5.

Шаг 5. Подключите приём оплаты

Так же, как в Варианте А, шаг 6 — те же четыре системы и те же webhook-адреса.

Для регистрации в платёжных системах понадобятся юридические документы
(оферта, политика конфиденциальности). Их можно сгенерировать прямо в MHUB:
⚙️ Настройки → 📋 Реквизиты → 📄 Юр. документы (доступно для проектов
«без своего бота»).

---

Как всё работает после настройки

Событие	Что происходит
Подписчик открывает бота (свой бот) или страницу оплаты (без бота)	Видит тарифы с ценами
Выбрал тариф и оплатил	Переходит на страницу платёжной системы
Оплата подтверждена	Получает подтверждение и автоматически добавляется в канал (если добавить не удалось — приходит ссылка-приглашение)
За сутки до конца подписки	Одно напоминание о продлении
Подписка закончилась	Уведомление с кнопкой «Продлить»
Доступ в канал после окончания	Подписчик автоматически удаляется из канала — сервис сверяет доступ каждые несколько минут

Удаление после окончания подписки

Это происходит автоматически и по умолчанию: когда подписка заканчивается,
MHUB сам исключает подписчика из канала (сверка идёт каждые несколько минут) и
присылает ему уведомление с кнопкой «Продлить». Ничего включать не нужно —
единственное условие: у бота должны быть права администратора на удаление
участников (шаг 4 / шаг 2).

Отдельно: реакция на «зайцев» (кто попал в канал без оплаты)

Не путайте с окончанием подписки. Это про людей, которые оказались в канале
в обход оплаты — например, их добавили вручную или они попали по старой
ссылке, минуя бота. Поведение настраивается:
⚙️ Настройки → 🛡 Реакция на новых участников:

• 🔔 Уведомлять меня (по умолчанию) — MHUB пишет вам в личку, вы решаете
  «оставить» или «удалить».
• 🗑 Удалять автоматически — сервис сам исключает таких участников.
• ⏸ Не реагировать — ничего не делать.

Эта проверка «зайцев» работает только на платном тарифе MHUB и не влияет
на удаление по окончании подписки — то происходит всегда.

---

Дополнительные возможности

Несколько каналов в одном проекте. ⚙️ Настройки → 📡 Каналы и чаты — добавьте
несколько каналов/чатов и привяжите к каждому тарифу свой набор (например,
базовый тариф — один канал, премиум — три). Набор каналов у тарифа выбирается
при его создании.

Промокоды. 💰 Продажи → 🎟 Промокоды → ➕ Создать:

• 💯 Скидка — процент от цены тарифа (5–100%).
• 🔥 Срок сгорания — через сколько дней промокод сгорает после активации.
• 🔢 Лимит активаций — сколько раз можно использовать.
• 📅 Действителен до — дата окончания действия.

Подписчик вводит промокод перед оплатой — цена пересчитывается автоматически.

Бесплатный доступ / ручная выдача. 👥 Подписчики → 🎁 Выдать подписку —
создайте персональную ссылку доступа без оплаты (перенос подписчиков, партнёрам,
подарки). Каждая такая ссылка рассчитана на одну активацию.

Настройка сообщений бота. ⚙️ Настройки → ✉️ Тексты и кнопки — измените:
приветствие, заголовок списка тарифов, текст напоминания за день, текст после
окончания подписки (а также догоняющие сообщения и кнопку техподдержки).

Юридические документы. ⚙️ Настройки → 📋 Реквизиты — заполните реквизиты; для
проектов «без своего бота» можно сгенерировать оферту и политику
конфиденциальности автоматически или указать ссылки на свои документы. Эти
документы пригодятся при регистрации в платёжных системах.

Рассылки. 📨 Рассылки — массовые сообщения подписчикам (по сегментам).

---

Частые ошибки

Бот не добавляет в канал.
→ Проверьте, что бот — администратор канала с правами добавлять и удалять участников.

Люди попадают в канал без оплаты.
→ Отключите «Заявки на вступление» в настройках канала MAX.

Просроченные подписчики остаются в канале.
→ Удаление по окончании подписки происходит автоматически, но требует, чтобы у
бота были права администратора на удаление участников. Проверьте права бота
в настройках канала. Сверка идёт каждые несколько минут — небольшая задержка
после окончания подписки это норма.

Оплата прошла, а доступ не выдан.
→ Проверьте Webhook / Result URL в кабинете платёжной системы — он должен точно
совпадать:

• ЮKassa: 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 должен быть администратором канала до пересылки сообщения.