Платформы • Max

Что понадобится

Аккаунт MAX и доступ к кабинету бота / платформе для бизнеса (создание бота и токен).

Права на настройку приложения в личном кабинете Sunblaze (раздел «Настройки → Платформы»).

Публичный HTTPS API Sunblaze (webhook бота регистрируется автоматически при сохранении токена).

Шаг 1. Создайте бота и подключите платформу

1. Создайте бота в MAX
   В кабинете разработчика / «MAX для бизнеса» создайте бота и скопируйте токен Bot API.
2. Подключите платформу в Sunblaze
   Личный кабинет → приложение → «Настройки → Платформы» → Max → вставьте токен и сохраните. После сохранения система зарегистрирует webhook на platform-api2.max.ru и выдаст ссылку Mini App.

Шаг 2. Привяжите Mini App к боту

1. Укажите URL Web App
   В настройках бота MAX укажите URL мини-приложения из Sunblaze (поле «URL мини-приложения»). Кнопка старта / меню должна открывать этот HTTPS-адрес.
2. Проверьте запуск
   Откройте бота в MAX и запустите Mini App. Витрина должна загрузиться; вход — по email (bind MAX после авторизации), как в Telegram.

Каталог в личном чате с ботом

В MAX нет inline-режима как у Telegram (@бот в любом чате). Покупатель пишет название товара боту в личку — бот отвечает карточками SKU с кнопкой «Открыть в магазине» (open_app → товар).

1. Проверка
   Откройте диалог с ботом (не команду со слэшем) и напишите часть названия товара из каталога. Должны прийти до трёх карточек со ссылкой в Mini App.
2. Если карточек нет
   Убедитесь, что токен Max сохранён, webhook активен, в каталоге есть товары по запросу. Короткие реплики («ок», «да») и команды /… не ищут каталог — уходят в поддержку/AI.

Чеклист готовности к «MAX для бизнеса»

Ниже — технические требования к Mini App перед подачей партнёрского листинга. Сама заявка, тексты и GTM — отдельный процесс (продуктовый рост); здесь только готовность канала.

1. Стабильный Mini App URL
   Работает HTTPS-ссылка из Sunblaze; URL в кабинете бота MAX совпадает с выданным в настройках платформы.
2. Кнопка старта / меню
   Бот открывает Mini App одной кнопкой; deep-link product_{id} и order_{id} открывают нужный экран.
3. Сценарий покупки
   Каталог → корзина → оформление → оплата (редирект T-Bank/ЮKassa) проходят без критических ошибок. Native Max pay / Stars-аналог для физтоваров не используется.
4. Уведомления бота
   После заказа пользователь получает сообщение бота (статус/ссылка в Mini App), если канал уведомлений включён.
5. Шаринг и медиа
   Проверьте шаринг карточки товара из Mini App и подготовьте скриншоты (каталог, карточка, чекаут) плюс короткое описание магазина для заявки вне этой инструкции.
6. QR (опционально)
   На устройствах MAX доступен сканер QR в списке заказов (товар/заказ по payload). Не обязателен для листинга.

Полезные ссылки