MHUB

Для контентных продуктов / Цифровой продукт

Интеграция цифрового продукта через API и бота MHUB

Как подключить MHUB к цифровому продукту: проект, бот, YooKassa, webhook и выдача доступа после оплаты.

Обновлено 19 марта 2026 г.

Формат: wiki

Что дает интеграция через MHUB

  • Вы принимаете оплату за цифровой продукт или подписку в MAX без ручной переписки после каждой оплаты.
  • MHUB берет на себя выдачу доступа, продление и отключение, если доступ закончился.
  • Один админ-бот может вести несколько проектов: клуб, архив, курс, закрытый канал или отдельные продуктовые линии.

Общая схема работы

  1. Вы запускаете админ-бота MHUB и создаете проект.
  2. Подключаете клиентского MAX-бота, через которого будет идти сценарий оплаты.
  3. Привязываете закрытый чат или канал к проекту.
  4. Создаете RUB-тариф.
  5. Настраиваете YooKassa для клиентского бота.
  6. Отдаете пользователю ссылку на оплату или кнопку оплаты в боте.
  7. После успешной оплаты MHUB получает webhook и активирует доступ.

Когда такой сценарий подходит

  • У вас есть свой MAX-бот, сайт или воронка, где пользователь уже выбирает продукт.
  • Вам нужно выдать доступ после оплаты в канал, чат или архив без ручной модерации.
  • Вы хотите разделить несколько продуктов по разным проектам и видеть это в одной системе.

Пошаговая настройка

Шаг 1. Запустите админ-бота MHUB

Откройте бота:

https://max.ru/id272000734358_bot

Внутри:

  1. Нажмите Проекты.
  2. Создайте новый проект.
  3. Подключите токен клиентского бота.
  4. Выберите чат или канал, куда будет выдаваться доступ.

Шаг 2. Создайте тариф

В выбранном проекте:

  1. Откройте Тарифы.
  2. Создайте RUB-тариф.
  3. Укажите длительность доступа и цену.

Пример:

  • Название: Доступ на 30 дней
  • Срок: 30 дней
  • Цена: 990 RUB

Шаг 3. Настройте YooKassa

В проекте откройте:

Настройки проекта → Платежные системы → YooKassa

Укажите:

  • ShopID
  • секретный ключ
  • webhook URL из MHUB

После этого именно этот клиентский бот начнет использовать YooKassa для генерации ссылок оплаты.

Шаг 4. Интегрируйте оплату в свой продукт

У вас есть два базовых сценария:

  1. Использовать готовый сценарий клиентского бота MHUB, где пользователь нажимает кнопку оплаты внутри MAX.
  2. Создавать инвойс из вашего продукта и направлять пользователя на полученный payment URL.

Для MVP чаще всего достаточно первого варианта: клиентский бот показывает тарифы и сам ведет пользователя к оплате.

Ключевые API-узлы MHUB

Проверка доступа

GET /v1/checkmember/{project_id}/{member_id}

Используйте, если ваш продукт должен быстро понять, есть ли у участника активный доступ.

Ссылка доступа

GET /v1/getaccesslink/{project_id}/{tariff_id}/{capacity}

Используйте, если нужно выдать одноразовую или ограниченную по capacity ссылку доступа к цели проекта.

Создание проектной оплаты

Внутри MHUB проектная оплата создается через сценарий проекта и связанный клиентский бот. Если у этого бота настроена YooKassa, MHUB выберет ее как основной способ оплаты.

Webhook YooKassa

POST /v1/integrations/yookassa/webhook

После успешной оплаты MHUB:

  1. проверяет платеж,
  2. находит нужный invoice,
  3. активирует подписку,
  4. выдает доступ пользователю.

Что передавать и хранить на своей стороне

Минимальный набор:

  • внутренний идентификатор пользователя,
  • member_id в контексте проекта,
  • max_user_id, если вы уже знаете его на момент оплаты,
  • project_id,
  • tariff_id.

Если ваш продукт уже знает пользователя до оплаты, связывайте ваш внутренний user id с member_id и max_user_id. Тогда после webhook можно быстро открыть нужный функционал без дополнительного поиска.

Пример payload для подписочного webhook в MAX

{
  "update_type": "subscription_event",
  "payload": {
    "event_id": "evt-1001",
    "event_type": "subscription_create",
    "project_id": 1,
    "member_id": "member-42",
    "source_bot_id": "client-max-bot-1",
    "tariff_id": 2,
    "expires_at": "2030-01-01T00:00:00Z",
    "max_user_id": 123456789,
    "block_on_remove": false
  }
}

Практический сценарий для контентного продукта

Если вы продаете доступ к закрытому каналу или архиву:

  1. создаете проект Клуб,
  2. подключаете бот club_bot,
  3. настраиваете YooKassa,
  4. создаете тариф 30 дней,
  5. отправляете пользователя в бот или даете кнопку оплаты,
  6. после webhook MHUB выдает доступ в нужный MAX-чат.

Рекомендации по запуску

  • Сначала соберите один рабочий проект, не пытайтесь запустить сразу все продукты.
  • Разделяйте проекты по логике доступа, а не только по маркетинговому названию.
  • Перед боевым запуском проверьте полный цикл: оплата → webhook → выдача доступа → окончание срока → отключение.
  • Для каждой платежной связки держите отдельный тестовый сценарий.

Что проверить перед production

  • клиентский бот привязан к проекту,
  • закрытый чат или канал выбран правильно,
  • у тарифа есть цена в RUB,
  • webhook YooKassa настроен,
  • в админ-боте виден корректный статус платежной системы,
  • после тестовой оплаты пользователю реально выдается доступ.
Назад к wikiОткрыть админ-бот MHUB