Мини-приложение в MAX: что это и как его создать
Мини-приложение в MAX — это веб-страница (HTML, CSS, JavaScript), которая открывается прямо внутри мессенджера из чата с ботом: каталог, запись, личный кабинет, программа лояльности. Ниже — по документации dev.max.ru: кому доступно, что нужно подготовить, как подключить мини-приложение к боту, как работают ссылки ?startapp=, что умеет библиотека MAX Bridge — и честно, в каких случаях бизнесу мини-приложение не нужно и достаточно бота с перепиской.
Что такое мини-приложение MAX
По документации MAX мини-приложения работают только внутри чат-ботов и не могут существовать автономно. То есть сначала нужен бот, а мини-приложение — это ссылка на ваш сайт-приложение, привязанная к нему. Когда вы его подключаете, в чате с ботом появляется заметная кнопка запуска: клиент нажимает её и видит ваш интерфейс, не выходя из MAX.
| Бот | Мини-приложение | |
|---|---|---|
| Что видит клиент | Переписку: сообщения, кнопки, файлы | Полноценный экран: каталог, форма, корзина, кабинет |
| Из чего сделано | Сценарии через Bot API или сервис по токену | Ваш веб-код на хостинге с https |
| Без программиста | Да, через готовые сервисы | Обычно нет — это разработка веб-приложения |
| Где живёт | Чат с ботом | Внутри бота, отдельно не существует |
Кому доступно
Подключение к платформе MAX для партнёров — и к ботам, и к мини-приложениям — доступно юрлицам, ИП и самозанятым, резидентам РФ. Значит, порядок такой: верифицировать профиль, создать бота и пройти его модерацию (как это сделать — в статье /blog/kak-sozdat-bota-v-max), и только потом подключать мини-приложение.
Что подготовить
Попробуйте Моночат бесплатно
Сайт, Telegram, ВКонтакте, MAX, Авито (бета) и почта — в одном окне, ИИ-консультант по вашей базе знаний. Вход через Яндекс или Google, без карты. 14 дней тарифа «Про» в подарок.
- Компьютер на Windows, macOS или Linux и телефон для регистрации профиля в MAX.
- Само приложение: файлы .html, .css, .js и медиа. Мини-приложения работают на обычных веб-технологиях.
- Хостинг с защищённым соединением https — например, VK Cloud (у него есть хостинг мини-приложений в рамках интеграции с MAX), GitHub Pages или Yandex Cloud.
- Для разработки пригодятся библиотека MAX Bridge (связь с API MAX и устройства), React-компоненты MAX UI и гайдлайн интерфейса в формате .FIG.
Как подключить мини-приложение к боту
- Откройте платформу MAX для партнёров (или мини-приложение «MAX для бизнеса» — шаги совпадают) → «Чат-боты».
- Выберите бота → «⋮» → «Настройки».
- Вставьте URL мини-приложения в поле для ссылки.
- Выберите вид кнопки открытия — «Открыть», «Старт», «Играть» или без названия — и нажмите «Сохранить».
| Требование к URL | Значение по документации |
|---|---|
| Длина | Не более 1024 символов |
| Протокол | Только https:// |
| Символы | Латинские буквы, цифры, точка и дефис; пробелы не поддерживаются |
Там же, в настройках бота, ссылку обновляют (если сменился адрес), меняют вид кнопки и удаляют мини-приложение — для удаления достаточно стереть URL и сохранить.
Ссылки на мини-приложение: ?startapp=
Мини-приложение открывается по ссылке вида https://max.ru/<имя_бота>?startapp=<payload>. Payload необязателен, до 512 символов, допустимы латинские буквы, цифры, подчёркивание и дефис — иначе параметр будет удалён. В приложении значение доступно как window.WebApp.initDataUnsafe.start_param.
| Сценарий | Пример ссылки | Где разместить |
|---|---|---|
| Отзыв о визите | max.ru/MyBot?startapp=feedback_rest123 | QR на чеке или столике |
| Промокод | max.ru/MyBot?startapp=promo123 | Рассылка в канале, листовка |
| Источник перехода | max.ru/MyBot?startapp=your_site | Разные ссылки на сайте, в соцсетях, на упаковке |
| Статус заказа | max.ru/MyBot?startapp=order_12345 | Страница «Спасибо за заказ» на сайте |
Что умеет мини-приложение через MAX Bridge
- Получить данные пользователя (id, имя, язык) и чата при запуске — для входа без пароля. Для проверки подлинности на сервере используется строка initData с хешем, а не initDataUnsafe.
- Запросить номер телефона в нативном окне MAX (requestContact) — по правилам MAX такие данные можно использовать только для работы этого мини-приложения: регистрация в программе лояльности, проверка заказа, идентификация.
- Открыть ссылку во внешнем браузере или диплинк внутри MAX, скачать файл, поделиться контентом в чатах MAX.
- Сканировать QR-код, хранить данные на устройстве (в том числе в защищённом хранилище — до 10 ключей на пользователя), использовать биометрию и вибрацию на мобильных.
- Кнопка «Назад» в шапке и предупреждение о потере заполненных данных при закрытии.
Часть функций работает не везде: хранилища и шеринг во внешние приложения не поддерживаются в веб-версии, биометрия и вибрация — на десктопе и в вебе, камера и микрофон пока доступны только на Android и в веб-клиенте. Проверяйте window.WebApp.platform и предусматривайте запасной сценарий.
Нужно ли мини-приложение вашему бизнесу
| Задача | Что выбрать |
|---|---|
| Отвечать на вопросы о ценах, наличии, адресе | Бот с перепиской — мини-приложение не нужно |
| Запись к мастеру на 1–2 услуги | Бот или ссылка на вашу онлайн-запись; мини-приложение — если запись уже есть как веб-страница |
| Каталог на сотни товаров с корзиной | Мини-приложение |
| Личный кабинет, бонусы, статус заказа | Мини-приложение + переписка в том же боте |
Даже с мини-приложением клиенты продолжают писать боту: «а есть другой размер?», «можно перенести?». Переписку удобно вести в общем окне: в Моночате бот MAX подключается по токену («Каналы» → MAX, вебхук ставится автоматически), сообщения приходят вместе с чатом сайта, Telegram, ВКонтакте и почтой, а ИИ-сотрудник отвечает по базе знаний или готовит черновик оператору. Кнопка мини-приложения при этом настраивается на платформе MAX и живёт в настройках бота — Моночат её не создаёт и не заменяет.
По теме в Моночате
Попробуйте Моночат бесплатно
Сайт, Telegram, ВКонтакте, MAX, Авито (бета) и почта — в одном окне, ИИ-консультант по вашей базе знаний. Вход через Яндекс или Google, без карты. 14 дней тарифа «Про» в подарок.