Коротко
Мини-приложение в МАКС — это веб-интерфейс, который запускается из чат-бота прямо внутри мессенджера. Чтобы его подключить, нужно зарегистрировать бота, разместить frontend по публичному HTTPS-адресу и привязать этот URL к карточке бота на платформе МАКС для партнёров. Для взаимодействия с окружением мессенджера используется библиотека MAX Bridge; данные пользователя нужно проверять на backend, а не доверять только клиенту.
В этой статье — что такое мини-приложение, чем оно отличается от сайта и бота, как его подключить и какие сценарии подходят бизнесу.
Когда бизнесу нужно мини-приложение
Мини-приложение нужно, когда диалог уже не справляется с задачей и клиенту требуется отдельный интерфейс. Это типично для следующих сценариев:
- запись на услугу с выбором времени и специалиста;
- каталог товаров или услуг с карточками и фильтрами;
- заказ с несколькими шагами: выбор → корзина → контакты;
- бронирование столика, номера, занятия;
- личный кабинет: история обращений, статусы, документы, бонусы;
- статус обращения или заказа без долгой переписки;
- сервисный сценарий: вызов мастера, заявка на ремонт, обращение в УК.
Чем мини-приложение отличается от сайта
Сайт — это публичная витрина в открытом интернете. Мини-приложение работает внутри МАКС: его невозможно открыть напрямую в браузере как обычный сайт без входа в мессенджер.
Главное отличие в пути клиента. На сайте клиент ищет нужный раздел, проходит по меню, заполняет форму. В мини-приложении он попадает в нужный сценарий из бота и сразу выполняет действие. Это короче и понятнее, особенно на телефоне.
Мини-приложение не заменяет сайт. Сайт остаётся точкой входа из поисковика и из рекламы, а мини-приложение собирает действия пользователей, которые уже находятся в мессенджере.
Чем мини-приложение отличается от чат-бота
Бот — это диалог. Он хорошо подходит для коротких сценариев: один-два вопроса, заявка, передача оператору. Когда сценарий вырастает — бот начинает «допрашивать» пользователя длинной цепочкой сообщений.
Мини-приложение — это интерфейс. В нём то же действие можно выполнить за один экран: выбрать услугу, время, оставить контакт, нажать «Записаться».
На практике бот и мини-приложение работают вместе: бот встречает пользователя, объясняет, что делать, и открывает мини-приложение по кнопке. После действия в мини-приложении бот может прислать подтверждение или напоминание.
Как добавить мини-приложение в МАКС
- Откройте платформу МАКС для партнёров под профилем организации.
- Перейдите в раздел чат-ботов и выберите нужного бота. Если бота ещё нет, сначала создайте его и пройдите модерацию.
- Откройте раздел настроек, отвечающий за мини-приложение (например, «Чат-бот и мини-приложение» → «Настроить»). Точные названия — в актуальной документации на dev.max.ru.
- Вставьте URL вашего мини-приложения — публичный HTTPS-адрес frontend-приложения.
- Выберите вид кнопки открытия (например, «Открыть», «Старт», «Играть» или без названия), если такие варианты доступны в актуальной документации.
- Сохраните настройки и проверьте запуск приложения из чата с ботом.
Перед публикацией обязательно проверьте мини-приложение на телефоне — большая часть пользователей будет открывать его именно с мобильного устройства.
Что такое URL мини-приложения
URL мини-приложения — это адрес веб-приложения, которое открывается внутри МАКС. Требования к нему типичные:
- HTTPS с валидным TLS-сертификатом;
- стабильная доступность;
- корректная работа на мобильных устройствах;
- отсутствие тяжёлых зависимостей, которые ломаются в WebView.
Технически это может быть SPA на любом современном фреймворке. Главное — что приложение должно нормально загружаться, не блокировать скролл, не открывать всплывающие окна и адекватно работать на разных размерах экрана.
Что такое MAX Bridge
MAX Bridge — это техническая библиотека для взаимодействия мини-приложения с окружением МАКС: получение информации о пользователе, обращение к API, обработка сигналов от мессенджера. В бизнес-смысле это «мост», через который мини-приложение узнаёт, что оно открыто внутри МАКС, и взаимодействует с возможностями платформы.
Полная документация по доступным методам и событиям — на dev.max.ru/docs/webapps/bridge. Для бизнеса важно понимать, что использование MAX Bridge — стандарт, а не «магия»: библиотека подключается на frontend и даёт нужные точки расширения.
Валидация данных
Мини-приложение получает данные о пользователе через MAX Bridge. На клиентской стороне эти данные удобны для UX: можно показать имя, аватар, статус. Но доверять им как «доказательству личности пользователя» нельзя — клиентский код может быть изменён.
Поэтому при действиях, которые меняют данные на сервере (создать запись, оформить заказ, изменить статус), backend должен проверять подпись данных, полученных из MAX Bridge. Алгоритм валидации описан в документации dev.max.ru/docs/webapps/validation.
Это защищает бизнес от поддельных запросов и накруток.
Примеры бизнес-сценариев
Онлайн-запись
Клиент выбирает услугу, специалиста, дату и время, оставляет контакт. Заявка уходит администратору и в систему учёта. После подтверждения бот отправляет напоминание.
Интернет-магазин
Каталог товаров с карточками и категориями, корзина, выбор способа доставки и оплаты. Заказ передаётся в CRM или ERP, клиент получает подтверждение и статус в чате.
Оформление заявки
Форма с типом запроса, регионом, описанием задачи и контактом. Подходит сервисным компаниям, агентствам, B2B-сервисам. Заявка попадает менеджеру, бот отправляет автоответ.
Личный кабинет клиента
История заявок и заказов, текущие статусы, документы, бонусы или подписки. Подходит компаниям с регулярным обслуживанием — образованию, медицине, B2B-поставкам.
Каталог услуг
Описания направлений с ценами и условиями. Подходит компаниям, у которых много услуг и сложно держать всё в одном диалоге с ботом.
Что важно для бизнеса
Мини-приложение работает на стыке нескольких ответственных за результат: маркетолог отвечает за сценарий, дизайнер — за интерфейс, разработчик — за код, юрист — за обработку персональных данных, операционная команда — за обработку заявок. Если хоть одна часть провисает, эффект от мини-приложения теряется.
Перед публикацией обязательно нужны политика обработки персональных данных, согласие на коммуникации и понятный текст ошибок. Это не формальность — это часть продукта.
Частые ошибки
- Делать мини-приложение без бота — пользователю некуда «зайти», нет точки запуска.
- Не продумывать мобильный интерфейс — на телефоне ломаются формы и кнопки.
- Не предусматривать backend — заявки попадают «в никуда» или теряются.
- Доверять данным пользователя только на клиенте — это уязвимость.
- Не подготовить политику обработки персональных данных — нельзя собирать контакт без правовой базы.
- Перегружать первую версию функциями — сценарий становится непонятным.
Заметка
Интерфейс и правила платформы МАКС могут обновляться. Перед запуском проверьте актуальную документацию на dev.max.ru и business.max.ru.
Частые вопросы
Можно ли запустить мини-приложение без чат-бота?
Технически нет: мини-приложение привязывается к боту и открывается из его карточки. Бот — это «дверь» в мини-приложение.
Что должно быть в первой версии?
Один сильный сценарий: запись, заказ, заявка или личный кабинет. Не пытайтесь сделать «всё сразу» — лучше выпустить узкую версию, проверить спрос и потом расширять.
На каком стеке делать мини-приложение?
Можно использовать любые современные фронтенд-фреймворки. Главное — стабильный HTTPS-хостинг, работа на мобильных и подключение MAX Bridge для взаимодействия с мессенджером.
Нужно ли проверять данные пользователя на backend?
Да, при любых действиях, которые меняют данные на сервере. Без валидации backend не отличит поддельный запрос от реального.
Как MAXYapp может помочь?
Мы проектируем сценарий, делаем интерфейс под мобильный контекст, разрабатываем frontend и backend, подключаем MAX Bridge и связываем мини-приложение с ботом. Подробнее — мини-приложения в МАКС.
Если хотите запустить мини-приложение без долгого разбора
MAXYapp может спроектировать сценарий, разработать мини-приложение и связать его с ботом и CRM. Подходящие услуги: мини-приложения в МАКС, бот и мини-приложение под ключ, интеграции с CRM и оплатой.