Мини-приложения MAX: экран живёт внутри бота, а оплату придётся выносить наружу

Разработчик присылает ссылку со словами «вот ваше мини-приложение в MAX». Вы вбиваете название компании в поиск мессенджера и находите бота. Экран с каталогом открывается кнопкой внизу чата с ним, работает быстро и выглядит как в Telegram. Через день бухгалтер спрашивает, где в нём кнопка «Оплатить», и выясняется, что её не будет.

Оба сюрприза заложены в устройство площадки, и оба описаны в её документации. Ниже то, что стоит знать до сметы: что такое мини-приложение в MAX, чем оно отличается от бота и от Telegram Mini App, как подключается и чего от вашей компании потребует.

Короткий ответ

• Мини-приложение в MAX — веб-страница на HTML, CSS и JavaScript, которая открывается поверх чата. Оно работает только внутри бота и отдельно от него не существует.
• Подключить его могут юрлица, ИП и самозанятые, резиденты России. Сначала профиль компании и бот, потом адрес экрана в настройках этого бота.
• Открывается экран кнопкой в чате с ботом или ссылкой на бота с параметром startapp.
• Из телефона экран может получить номер с согласия человека, прочитать QR-код, сохранить данные в защищённое хранилище и спросить отпечаток или лицо. Часть этого работает только в мобильном приложении.
• Оплаты и геолокации в описании MAX Bridge нет. Платёж делается ссылкой на вашу платёжную страницу, договор эквайринга ваш.
• Цену мини-приложения в MAX мы называем после проверки экранов. Для сравнения: Mini App в Telegram с экранами, каталогом и заявкой стоит у нас от 50 000 ₽.

Что такое мини-приложение в MAX

Это ваш сайт, который открывается внутри мессенджера и знает, кто его открыл. Страница лежит на вашем хостинге, а MAX показывает её поверх чата с ботом и передаёт ей данные о человеке и о том, откуда он пришёл. Документация так и описывает стек: стандартные веб-технологии, плюс библиотека MAX Bridge для связи с приложением и устройством.

Сама площадка формулирует назначение прямо: мини-приложения нужны, чтобы запустить онлайн-витрину или сайт компании для прямых продаж. Живых примеров уже несколько, и все устроены одинаково. «Портал грантов» открывается кнопкой «Открыть приложение» в чате с одноимённым ботом и даёт фильтровать гранты по категориям, регионам, суммам и срокам. Платформа для партнёров MAX с июля 2026 года сама доступна как мини-приложение «MAX для бизнеса». У VK Рекламы есть ассистент в MAX, где рекламодатель правит отклонённые объявления и пополняет баланс.

Общее у всех трёх: сначала человек попадает в бота, потом нажимает кнопку. Отдельной витрины мини-приложений, куда компания могла бы выставить своё, в документации мы не нашли. Бот ищется по имени, а экран находят через него.

Чем мини-приложение отличается от бота

Бот ведёт разговор, мини-приложение показывает экран. В переписке человек нажимает кнопки, которые вы придумали заранее, и видит одну позицию за раз. На экране он сам отбирает, сравнивает, листает сетку расписания и возвращается к заполненному. Граница проходит там, где человеку нужно выбирать из многого.

Для MAX у этого правила есть поправка: без бота экрана не будет, так что вопрос звучит «хватит ли одного бота или к нему нужен экран». Разбор по шести частым задачам, от каталога до длинной анкеты, с ответом, где хватает переписки, лежит на странице мини-приложения в MAX

Чем мини-приложение MAX отличается от Telegram Mini App

Идея та же, различия в трёх местах, и все три влияют на смету. Сравнение по восьми строкам стоит сразу после текста

1. Кто может завести. В Telegram бота с экраном создаёт любой через BotFather. В MAX только организация, ИП или самозанятый: профиль подтверждает руководитель, бот проходит модерацию, и лишь потом в его настройках появляется поле для адреса экрана.
2. Оплата. У Telegram в документации есть метод openInvoice и подписки в Stars. В описании MAX Bridge платёжных методов нет, и оплата уходит на внешнюю страницу. Меморандум MAX и НСПК о платёжном мини-приложении с QR-кодом по СБП, подписанный в июне 2026 года, описывает сервис самой площадки для её пользователей. Принять оплату в вашем приложении он не поможет.
3. Геолокация и режимы экрана. В Telegram есть LocationManager, полноэкранный режим и ярлык на домашнем экране. В описании MAX Bridge этих методов нет. Зато есть сканер QR-кодов и, на Android, работа с NFC.

Если Mini App у вас уже работает в Telegram, переписывать его с нуля обычно не нужно. Вёрстка, логика и сервер остаются, вызовы библиотеки Telegram заменяются на MAX Bridge, а то, чего в Bridge нет, выносится наружу: оплата на страницу, выбор адреса в форму. Как мы раскладываем такой перенос по шагам до договора, описано на странице переноса из Telegram

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

Подключение занимает пять шагов, и первый из них за разработчика не сделать: его проходит руководитель компании. Всё ниже взято из описания мини-приложений на dev.max.ru.

1. Профиль компании и бот. Профиль на платформе для партнёров подтверждает руководитель, бот проходит модерацию. Как это выглядит по шагам и сколько ждать, разобрано в инструкции по созданию бота в MAX.
2. Хостинг с https. Файлы экрана кладут на любой хостинг; документация называет VK Cloud, GitHub Pages и Yandex Cloud, а VK Cloud запустила отдельный хостинг под мини-приложения. Соединение только защищённое.
3. Адрес в настройках бота. На платформе для партнёров: «Чат-боты», нужный бот, «⋮» и «Настройки», поле для ссылки на мини-приложение. То же самое делается в мини-приложении «MAX для бизнеса».
4. Вид кнопки. «Открыть», «Старт», «Играть» или кнопка без названия. После сохранения она появляется в чате с ботом.
5. Проверка данных на сервере. При запуске экран получает строку с данными о человеке и подписью. Ваш сервер проверяет подпись ключом, производным от токена бота, и только после этого доверяет имени и номеру. Шаг невидимый, но без него любой может подставить чужие данные.

Для интерфейса площадка даёт библиотеку React-компонентов MAX UI и гайдлайн в формате Figma с принципами навигации и типографики; ссылку на него добавили в августе 2026 года. Пользоваться ими не обязательно, но экран, похожий на сам MAX, людям понятнее.

Какие задачи бизнеса решает мини-приложение в MAX

Те же, что и сайт, с двумя преимуществами: человек уже в мессенджере, и экран может спросить у телефона то, чего сайт не спросит. Что именно, видно по методам MAX Bridge.

• Каталог с отбором. Фильтры, сравнение, корзина. Экран здесь ничем не ограничен: это ваша страница, и работает она как страница.
• Запись по сетке. Дни, мастера, свободные окна на неделю вперёд, перенос записи. Метод, предупреждающий о несохранённых данных при закрытии, защищает от потерянной анкеты.
• Кабинет и программа лояльности по номеру. Метод requestContact в мобильном приложении запрашивает номер телефона в окне самого MAX. Документация оговаривает, что полученные так данные можно использовать только для работы этого мини-приложения: регистрация в программе лояльности, статус заказа, опознание клиента.
• QR-коды. Сканер камерой или из файла: купон на кассе, билет на входе, код оборудования у выездного мастера.
• Документы. Скачивание файлов по https работает в мобильном приложении и в веб-версии: договор, акт, чек.
• Вход без пароля. Защищённое хранилище, до десяти ключей на человека, и биометрия. Оба инструмента есть только в мобильных клиентах, в веб- и десктоп-версиях их методы не поддерживаются.

Две задачи, ради которых мини-приложение часто заказывают, требуют оговорок. Оплата уходит наружу, и путь денег разобран в отдельном блоке ниже. Второе касается сообщений от бота вроде «заказ готов» или «напоминаем о записи на завтра»: правила площадки называют их сервисными, а пункт 1.5 требований разрешает отправлять такие сообщения через API в случаях, предусмотренных договором с MAX. Какие уведомления допускает ваш договор, стоит выяснить до того, как на них будет держаться сценарий.

Требования к организации и к приложению

Требований три группы: кто подключает, что должно быть в приложении и как обращаться с данными.

• Кто подключает. Юрлицо, ИП или самозанятый, резидент России. По правилам размещения в редакции от 11 июня 2026 года приложение размещается только при действующем лицензионном договоре с площадкой. Физическим лицам и нерезидентам подключение пока недоступно.
• Проверка. Площадка вправе проверять приложение и до размещения, и после, требовать исправлений и ограничивать доступ. Отдельного срока проверки именно для мини-приложения в документации мы не нашли.
• Обложка и сведения. Название, описание, иконка и короткое имя не должны вводить людей в заблуждение. В самом приложении требования обязывают дать сведения о правообладателе, политику обработки персональных данных и условия использования, а также обеспечивать поддержку пользователей. Типовое соглашение и типовая политика лежат там же, в разделе правовых документов.
• Акции и конкурсы. Внутри приложения их можно проводить только после отдельного согласования с MAX (п. 5.1 требований).
• Персональные данные. Основание для их обработки и уведомление людей обеспечиваете вы, и по запросу площадки подтверждаете это документами. Номер из requestContact используется только в этом приложении.

По отдельности требования несложные. Мешает их порядок: пока руководитель не подтвердил профиль, а бот не прошёл модерацию, готовый экран подключить некуда. Этот шаг ставится в план первым.

Сколько стоит мини-приложение в MAX у нас

Заранее мы цену не называем. Как и на странице мини-приложения в MAX, сначала раскладываем ваш сценарий на экраны и сверяем каждый с тем, что площадка умеет сегодня, а смету считаем только по подтверждённым. Модули и ставка при этом те же, что в остальных направлениях.

Ориентир для сравнения есть. Mini App в Telegram с экранами, каталогом и заявкой стоит у нас от 50 000 ₽, срок нижней сметы 2–3 недели. Бот в MAX, без которого экрана не бывает, стоит от 20 000 ₽. Если сценарий требует оплаты внутри экрана или геолокации, в MAX он соберётся с обходными шагами, и их придётся учесть в смете.

Плохая новость про нас

Экранов в MAX мы пока не собирали, и раскрытых проектов там у нас нет. Всё, что написано выше про Bridge, подключение и правила, взято из документации площадки; собственной сборки за этим нет. Поэтому мини-приложение в MAX мы продаём как проверку вашего сценария с письменным ответом, а продукта с ценой в прайсе у нас пока нет.

Второе: документация молодой площадки меняется быстро. Только за лето 2026 года в ней появились подключение самозанятых, мини-приложение «MAX для бизнеса», новые методы Bridge и гайдлайн. Статья сверена 24 сентября, и то, чего в Bridge нет сегодня, может появиться раньше, чем мы её обновим.