Mini Apps в MAX — это веб-приложения, которые работают только внутри экосистемы MAX и подключаются к боту. Базовая схема у платформы прямая: приложение собирается на обычных веб-технологиях, выкладывается на статический хостинг с https, затем его URL привязывается к боту в партнёрской панели MAX.
Кто может подключить Mini Apps
Подключение Mini Apps доступно для юрлиц и ИП — резидентов РФ. Перед стартом нужен профиль организации в платформе MAX для партнёров и бот, к которому приложение будет привязано.
Стек технологий
По стеку всё довольно земное: мини-приложения работают на HTML, JavaScript и CSS. Для интеграции с клиентом есть MAX Bridge, который подключается через max-web-app.js и отдаёт глобальный объект window.WebApp. Через него приложение получает данные запуска, информацию о пользователе и чате, платформу запуска и методы управления интерфейсом. Для интерфейса отдельно есть MAX UI — библиотека React-компонентов с поддержкой React 18+, TypeScript, светлой и тёмной темы.
Путь запуска
Если упростить путь запуска, он выглядит так:
• собрать фронтенд;
• выложить его на статический хостинг;
• проверить https;
• зайти в партнёрскую панель MAX;
• открыть нужного бота;
• в разделе «Чат-бот и мини-приложение» вставить ссылку на приложение и выбрать кнопку запуска.
Поддерживаются кнопки «Открыть», «Старт», «Играть» или вариант без подписи. URL должен быть на https, длиной до 1024 символов.
Mini App неотделим от бота
Mini App в MAX не живёт отдельно от бота. Даже прямая ссылка открывается в формате https://max.ru/<botName>?startapp, а дополнительные параметры передаются через startapp=<payload>. Payload ограничен 512 символами. Это полезно для реферальных хвостов, промо-сценариев и трекинга источников.
Валидация данных запуска
MAX рекомендует не доверять клиентским данным «как есть», а проверять WebAppData через HMAC-SHA256 с использованием токена бота. Алгоритм: извлечь параметры из URL-фрагмента, убрать hash, отсортировать пары key=value, собрать строку параметров и сверить подпись с оригинальным хешем. Для продовой разработки это обязательная база.
Для каких сценариев подходят Mini Apps
Mini Apps лучше всего подходят там, где обычного бота уже мало, а отдельное мобильное приложение делать рано или невыгодно: каталоги, формы, интерактивные подборки, кабинеты пользователя, игровые механики, бронирование, витрины акций, квизы, сервисные панели.
Какие боты уместны рядом
Из ботов здесь естественнее всего встроить Converter Bot, Welcome Bot и Statistic Bot. Converter Bot уместен, если Mini App работает с файлами или изображениями. Welcome Bot может вести пользователя в Mini App из стартового сценария: объяснить, что это за сервис, дать ссылку на запуск и разложить навигацию. Statistic Bot полезен после запуска — смотреть, как живёт связка «бот + мини-приложение» и меняется ли динамика аудитории.
Ограничения, которые лучше знать заранее
Правила MAX требуют, чтобы приложение не вводило пользователей в заблуждение, не содержало вредоносный код, корректно обрабатывало ошибки и защищало данные от подмены. Конкурсы и стимулирующие мероприятия внутри приложения допускаются только после согласования с компанией.
Итог
Разработка Mini Apps в MAX — это уже не эксперимент «на коленке», а нормальная продуктовая разработка с понятной инфраструктурой. Платформа даёт веб-модель, Bridge, UI-библиотеку и рабочий запуск через бота. Но вход через организацию и договорный контур. Подробнее о том, как устроены боты в MAX и их настройка, — в отдельном материале.