Платформы • MAX
Пошагово: бот на «MAX для партнёров» и модерация, токен доступа в Sunblaze, ссылка мини-приложения в настройках бота, проверка.
Что понадобится
Профиль организации, ИП или самозанятого на платформе «MAX для партнёров» (business.max.ru). Ботов в MAX создают только юрлица, ИП и самозанятые — резиденты России; профиль проходит проверку.
Время на модерацию: новый бот проверяется до 48 часов в рабочие дни. Токен и настройки бота появляются только после неё.
Доступ к кабинету Sunblaze с правом настраивать магазин.
Если бот уже опубликован, начните с шага 2.
Шаг 1. Создайте бота в MAX
- Откройте «Чат-боты»Зайдите на business.max.ru/self (или в мини-приложение «MAX для бизнеса») и откройте раздел «Чат-боты».
- Нажмите «Создать»Заполните карточку: логотип (квадрат 500×500, до 5 МБ), «Название чат-бота» (до 59 символов, без эмодзи) и описание до 200 символов. Никнейм бота MAX назначает сам — выбрать его нельзя.
- Дождитесь модерацииСтатус «На модерации» сменится на «Опубликован» или «Нужны исправления» — причина будет в карточке бота. Уведомление придёт от бота «MAX для бизнеса».
Шаг 2. Скопируйте токен доступа
Токен даёт полное управление ботом. Не публикуйте его и не пересылайте в чаты.
- Откройте настройки бота«Чат-боты» → у нужного бота «⋮» → «Настройки».
- Скопируйте «Токен доступа»В блоке «Чат-бот» нажмите значок копирования у поля «Токен доступа». Значок обновления рядом перевыпускает токен: старый перестаёт работать, новый нужно вставить в Sunblaze.
Шаг 3. Вставьте токен в Sunblaze
- Откройте «Каналы продаж»Кабинет Sunblaze: «Витрина → Каналы продаж» (в прежнем меню — «Настройки → Платформы»). Нажмите строку MAX.
- Вставьте токен в поле «Токен доступа бота MAX» и нажмите «Подключить»Sunblaze проверит токен в MAX и подключит бота к магазину: сообщения покупателей будут приходить в кабинет, в «Покупатели → Переписка».
- Скопируйте «Ссылка для подключения»Она появится в окне после подключения — адрес вида https://m.sbaps.ru/?token=… Кнопка копирования — справа в поле.
Шаг 4. Укажите ссылку мини-приложения в MAX
Этот шаг делается в MAX вручную: Sunblaze не может поставить ссылку за вас. Без него бот отвечает на сообщения, но витрина в MAX не открывается.
- Откройте настройки бота«Чат-боты» → «⋮» → «Настройки», блок «Мини-приложение».
- Вставьте ссылкуВ поле «Введите ссылку» вставьте «Ссылку для подключения» из Sunblaze — целиком, без пробелов. MAX принимает только адреса https://.
- Выберите кнопку и сохранитеВ «Выберите кнопку открытия мини-приложения» выберите надпись — «Открыть», «Старт», «Играть» или без надписи — и нажмите «Сохранить».
Шаг 5. Проверьте
- Откройте бота в MAXВ чате с ботом появится кнопка открытия мини-приложения. Нажмите её — должна открыться витрина.
- Найдите товар в чатеНапишите боту часть названия товара — он ответит карточками с кнопкой «Открыть в магазине». Короткие реплики и команды со слэшем каталог не ищут.
- Сделайте тестовый заказЗаказ появится в кабинете в «Заказах».
Поля в окне подключения
| Поле в окне Sunblaze | Что вводить и где взять | Обязательно |
|---|---|---|
| Токен доступа бота MAX | «MAX для партнёров» → «Чат-боты» → ⋮ → «Настройки» → «Токен доступа». Есть только у бота, прошедшего модерацию. | Да — при подключении. Потом пустое поле значит «оставить прежний» |
| Ссылка для подключения | Заполняется сама: https://m.sbaps.ru/?token=… Её вставляют в MAX: «Мини-приложение» → «Введите ссылку». | Нет — только чтение, но вставить в MAX обязательно |
| Канал работает | Выключите, чтобы временно закрыть канал: покупатели не входят, бот не отвечает, а ссылка, QR-коды и токен остаются. Включите — и всё откроется по прежним ссылкам. «Отключить» в таблице, в отличие от этого, удаляет подключение, и ссылка при повторном подключении другая. | Нет — по умолчанию включено |
| Служебный токен Sunblaze | Служебный идентификатор подключения. Никуда вводить не нужно — в кабинет платформы вставляется ссылка. | Нет — только чтение |
Частые ошибки
- «MAX не узнал этот токен доступа бота»Токен скопирован не целиком или перевыпущен. Скопируйте его заново в настройках бота.
- Нужно ненадолго закрыть каналОткройте строку платформы и выключите «Канал работает» (или «Приостановить» в меню строки). Покупатели не входят, бот не отвечает, но ссылка, QR-коды и токен остаются — включите обратно, и всё работает по прежним ссылкам. «Отключить» удаляет подключение: ссылка при повторном подключении другая, и её придётся заменить везде, где она вставлена.
- Как проверить, что бот и ссылка работаютВ окне платформы нажмите «Отправить тестовое сообщение себе»: бот напишет вам с кнопкой «Открыть магазин». Нужен привязанный к кабинету аккаунт мессенджера и нажатый у бота «Старт». Пришло сообщение и кнопка открывает магазин — токен, чат и ссылка запуска в порядке.
- Покупатель прислал фото или файлБот читает только текст. Подпись к фото попадает в чат как сообщение с пометкой о вложении, а покупателю бот один раз отвечает, что вложения не принимает и надо написать словами. Сами файлы пока не сохраняются.
- «Не удалось проверить токен в MAX»MAX не ответил, токен не сохранён. Повторите через минуту.
- «Этот бот уже подключён к магазину другого владельца»Один бот работает с магазинами одного владельца. Создайте для этого магазина отдельного бота на «MAX для партнёров» и вставьте его токен.
- В столбце «Состояние» — «Токен не принят»Токен перевыпустили в настройках бота («Чат-боты» → ⋮ → «Настройки»). Скопируйте новый токен, вставьте в окне MAX и нажмите «Сохранить», затем «Проверить сейчас»: Sunblaze проверяет бота каждые полчаса и пишет владельцу, когда токен перестаёт приниматься.
- В настройках бота нет «Токена доступа»Бот ещё на модерации. Дождитесь статуса «Опубликован».
- Магазин просит открыть его зановоДанные запуска из MAX действуют ограниченное время (по умолчанию сутки). Если мини-приложение долго лежало открытым и вход не прошёл, покупателю показывается подсказка: закрыть магазин и открыть его заново.
- Бот отвечает, но магазин не открываетсяНе сделан шаг 4: ссылка не вставлена в «Мини-приложение», вставлена не целиком или это старая ссылка. Скопируйте «Ссылку для подключения» из Sunblaze заново.
Перед размещением бота в каталоге MAX
- Ссылка работаетВитрина открывается кнопкой в чате с ботом и по «Ссылке для подключения» в браузере.
- Покупка проходитКаталог → корзина → оформление → оплата проходят без ошибок.
- УведомленияПосле заказа покупатель получает сообщение бота о статусе.
- МедиаПодготовьте скриншоты витрины и короткое описание магазина.
Инструкция сверена с документацией платформы и кабинетом Sunblaze 11 октября 2026 года. Если экраны платформы выглядят иначе, ищите те же названия разделов и полей — они меняются редко.
