Обзор

Мини-приложения работают только внутри MAX и не могут существовать автономно. Они расширяют функциональность основной платформы и позволяют разработчиками быстро запускать проекты

Что потребуется

Устройства с операционной системой Windows, macOS или Linux
Мобильное устройство для регистрации профиля в MAX
Редактор кода и навыки работы с командной строкой

Что упростит разработку

Библиотека MAX Bridge, с которой мини-приложение сможет взаимодействовать с API MAX и API устройства пользователя
Библиотека React-компонентов MAX UI, с которой мини-приложение легко стилизовать под интерфейс MAX
Мини-приложения работают на базе стандартных веб-технологий — HTML, JavaScript, CSS

Как добавить мини-приложение в MAX

Подключить мини-приложение к MAX и управлять им можно только с помощью бота. Из чат-бота пользователи смогут запускать сервис без авторизации

Действия перед подключением

Зарегистрируйте в MAX чат-бот по инструкции
Загрузите файлы мини-приложения на хостинг статики, например, через Vercel или Github Pages — .html, .css, .js и другие медиафайлы
Проверьте, что приложение работает по защищённому соединению — https

Подключение

Выберите в настройках бота Мини-приложения → Добавить или изменить → отправьте ссылку на мини-приложение, она должна начинаться с https:// → Готово. Мини-приложение теперь в MAX!

Подключение мини-приложения к MAX

Как только вы подключите мини-приложение к платформе, в чате с его ботом появится заметная кнопка для быстрого запуска сервиса. Пользователям достаточно будет найти в списке чатов бота

Запуск мини-приложения из чата с ботом

Как обновить или удалить мини-приложение

Обновления

Если у мини-приложения статичный URL, после деплоя пользователи просто запустят новую версию приложения.
Если ссылка поменялась, самостоятельно обновите её через @MasterBot: /list → выберите бота → Настройки → Мини-приложение → Добавить или изменить → отправьте боту новую ссылку

Удаление

Чтобы удалить мини-приложение, отправьте в чат с @MasterBot команду /delete_app или выберите в настройках бота Мини-приложение → Удалить. Подтвердить действие и проверьте, что доступа к мини-приложению из чат-бота больше нет

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