Как подключить мини-приложение к боту в MAX: пошаговая инструкция

Что нужно перед началом

Прежде чем подключать мини-приложение, у вас должно быть:

1.Аккаунт в MAX (скачайте приложение на телефон или зайдите через браузер)

2.Бизнес-аккаунт на MAX Business — регистрация на business.max.ru

3.Готовое мини-приложение — его можно создать в MiniMaxApp за 20 минут

Если мини-приложение ещё не готово, сначала создайте его в студии MiniMaxApp. Вы получите ссылку вида https://minimaxapp.ru/apps/ваш-проект — она понадобится на шаге 4.

Шаг 1. Создайте бота в MAX Business

Откройте business.max.ru и войдите в свой аккаунт. В левом меню выберите «Боты», затем нажмите «Создать бота».

Заполните карточку бота:

•Название: — имя вашего бизнеса (например, «Барбершоп Стиль»)

•Описание: — коротко о том, что делает бот

•Аватар: — логотип или фото

После сохранения вы попадёте в настройки бота. Здесь важно найти раздел «Токен» — он понадобится для следующего шага.

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

В настройках бота найдите раздел «Токен доступа» и скопируйте его. Токен выглядит примерно так:

001.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.yyyyyyyyyyyyyyyyyyyy

Храните токен в безопасном месте — он даёт полный доступ к управлению ботом. Никому не передавайте его.

Токен используется при API-запросах. Базовый URL MAX API: https://platform-api.max.ru. Все запросы требуют заголовок:

Authorization: Bearer ВАШ_ТОКЕН

Но для подключения мини-приложения через интерфейс MAX Business токен копировать вручную не нужно — достаточно интерфейса.

Шаг 3. Соберите мини-приложение в MiniMaxApp

Если ещё не сделали — зайдите на minimaxapp.ru, создайте аккаунт (это бесплатно) и соберите мини-приложение:

1.Выберите шаблон (Запись, Каталог, Доставка, Промо или Квиз)

2.Опишите ваш бизнес в поле — AI за 20 секунд построит структуру

3.Отредактируйте содержимое: услуги, цены, контакты, фото

4.Нажмите «Опубликовать» — получите ссылку на ваше приложение

Скопируйте URL вашего мини-приложения.

Шаг 4. Подключите мини-приложение в MAX Business

Вернитесь в MAX Business → раздел «Боты» → откройте вашего бота → перейдите в раздел «Чат-бот и мини-приложение».

В поле «URL мини-приложения» вставьте ссылку, которую вы получили в MiniMaxApp.

Шаг 5. Настройте кнопку

После вставки URL вам предложат выбрать тип кнопки, которую будут видеть пользователи в чате с ботом:

•Открыть: — стандартная кнопка для сервисных приложений

•Старт: — для первичного запуска (подходит для квизов и онбординга)

•Играть: — если у вас игровое или развлекательное приложение

Для большинства бизнесов подходит «Открыть». Введите текст кнопки, например: «Записаться», «Открыть меню» или «Смотреть каталог».

Шаг 6. Протестируйте

После сохранения настроек найдите своего бота в MAX (через поиск по имени) и напишите ему что-нибудь. В ответе появится кнопка. Нажмите её — должно открыться ваше мини-приложение прямо внутри мессенджера.

Если что-то пошло не так, проверьте:

•Правильно ли скопирована ссылка (без лишних пробелов в начале или конце)

•Опубликовано ли приложение (не черновик)

•Сохранены ли настройки в MAX Business

Шаг 7. Поделитесь ботом с клиентами

Теперь осталось рассказать клиентам о боте. Несколько способов:

Deep link — специальная ссылка, которая сразу открывает бота в MAX. Её можно разместить на сайте, в соцсетях или в email-рассылке. Формат: https://max.ru/join/ИМЯ_БОТА

QR-код — сгенерируйте QR на deep link и разместите его в заведении, на упаковке или в рекламных материалах.

Кнопка на сайте — добавьте виджет «Открыть в MAX» рядом с другими мессенджерами.

После запуска отслеживайте статистику в MAX Business: сколько пользователей открыли бота, сколько нажали кнопку мини-приложения, сколько завершили целевое действие.