Мини-приложения в MAX: как сделать

Как сделать мини приложение в Максе: оформить доступ на платформе MAX для партнеров, создать бота и пройти его модерацию, собрать веб-интерфейс, подключить MAX Bridge (библиотеку платформы для связи с мессенджером) и настроить проверку данных пользователя на сервере. По устройству это близко к Telegram Mini Apps: то же веб-приложение, которое открывается внутри чата. Отличаются правила доступа, инструменты разработчика и аудитория.

MAX - мессенджер от VK, который запустили в 2025 году. Платформа молодая, документация и возможности для разработчиков меняются часто, поэтому перед стартом каждого проекта мы сверяемся с актуальной версией документации. Ниже только то, что меняется редко: общая схема, решения, которые принимают до разработки, и ошибки, на которых теряют время.

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

Мини-приложение в MAX - веб-приложение, которое открывается внутри мессенджера из чата с ботом, по ссылке или по кнопке. Его делают на HTML, CSS и JavaScript, чаще на React или Vue, размещают на своем сервере и отдают по HTTPS. Мессенджер передает приложению данные о пользователе и параметры запуска, поэтому человеку не нужно регистрироваться и вводить пароль.

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

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

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

Кому стоит выходить в MAX сейчас

MAX продвигают как национальный мессенджер, в нем развивают сервисы, связанные с госуслугами и цифровыми документами. Для компаний это новый канал, где борьба за внимание пока слабее, чем на давно освоенных площадках. Выход в MAX имеет смысл, если:

• ваша аудитория в России и уже пользуется MAX или получает туда сообщения от госсервисов, банков, работодателей;
• у вас есть мини-приложение в другом мессенджере и нужен второй канал без переписывания продукта;
• вы работаете с госсектором, образованием или медициной, где заказчики просят присутствие в отечественных сервисах;
• нужен корпоративный инструмент для сотрудников на российской платформе.

Если аудитория пока сидит в других мессенджерах, MAX разумно добавить вторым каналом, а не строить продукт только под него. Проверить спрос можно на простом сценарии, например записи или каталоге, и расширять приложение по данным аналитики.

Как сделать мини-приложение в Максе: шаги

1. Сценарий. Описываем, что пользователь делает в приложении, какие экраны войдут в первую версию, нужна ли оплата, какие системы бизнеса подключаем.
2. Доступ к платформе. Заказчик регистрирует профиль на платформе MAX для партнеров и проходит верификацию. По документации MAX для разработчиков подключиться могут юрлица, ИП и самозанятые, которые резиденты РФ. Организация или ИП подтверждает профиль через Госуслуги или через T-Business ID и Alfa ID, самозанятый через Госуслуги. Этот шаг запускаем раньше всех остальных, параллельно с дизайном.
3. Бот. Создают бота, он проходит модерацию (по документации до 48 часов по рабочим дням), после нее становится доступен токен для API. Владельцем остается компания, разработчику выдают доступ.
4. Дизайн. Рисуем экраны под узкое окно мессенджера, в светлой и темной теме.
5. Фронтенд. Верстаем интерфейс, подключаем MAX Bridge для связи с клиентом мессенджера.
6. Бэкенд. Делаем API, базу данных, проверку данных пользователя, интеграции с CRM, 1С, платежами.
7. Тестирование на iOS, Android и десктопе.
8. Публикация. Привязываем приложение к боту, который прошел модерацию, сверяем его с актуальными требованиями платформы и открываем для пользователей.

Разработка и оформление доступа идут параллельно. Если ждать с регистрацией до готового кода, запуск сдвигается на срок верификации профиля и модерации бота.

Регистрация на платформе

Доступ к инструментам разработчика в MAX получают юрлица, ИП и самозанятые, которые резиденты РФ. Физлицам и нерезидентам верификация пока недоступна. Заказчик регистрирует профиль и подтверждает данные. По документации MAX для разработчиков организация или ИП может создать до 5 ботов на профиль, самозанятый до 2, а никнейм бота ИП или юрлица платформа формирует по ИНН в виде idИНН_bot. Поэтому бот, зарегистрированный на подрядчика, будет носить его ИНН. Мы просим, чтобы владельцем кабинета и бота оставался сотрудник компании, а разработчик получал доступ отдельно. Если подрядчик сменится, ключи и настройки останутся у бизнеса.

Веб-интерфейс

Интерфейс делают как обычное одностраничное веб-приложение. Мы собираем его на React и TypeScript, но выбор фреймворка на работу с платформой не влияет. Особенности похожи на другие мессенджеры: узкий экран, окно внутри чата, интерфейс должен читаться и в светлой, и в темной теме.

Для связи с мессенджером платформа дает JavaScript-библиотеку MAX Bridge. Какие методы в ней есть и в каком формате приходят данные, смотрим в текущей документации MAX. Копировать код из инструкций к Telegram без проверки не стоит: схема похожа, детали отличаются.

Авторизация и данные пользователя

При запуске мессенджер передает приложению данные пользователя. Фронтенд отправляет их на сервер, сервер проверяет их подлинность по алгоритму из документации MAX и только потом создает сессию. Схема знакома по Telegram, но код проверки мы пишем по документации MAX, а не переносим из старого проекта. Проверку нельзя пропускать даже в прототипе: без нее любой, кто знает адрес вашего API, представится другим пользователем.

Номер телефона и другие чувствительные данные приложение запрашивает отдельно, с согласия человека. Храним их по требованиям закона о персональных данных: серверы в России, понятная политика обработки, минимум полей.

Проверка и публикация

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

• приложение открывается на iOS, Android и десктопе;
• интерфейс не ломается в темной теме и на маленьком экране;
• описание и картинки совпадают с тем, что внутри;
• каждый запрос данных объяснен пользователю;
• правила акций и условия оплаты опубликованы.

Отличия от Telegram Mini Apps

Главное практическое отличие - порядок работ. В Telegram можно начать с кода и зарегистрировать бота в последний день. В MAX первым шагом идет оформление доступа организации, и от него зависит дата запуска.

Как перенести мини-приложение из Telegram в MAX

Если приложение в Telegram уже работает, переписывать его целиком не придется. Интерфейс, серверная логика, база данных и интеграции переносятся почти без изменений. Меняются три слоя:

• связь с клиентом мессенджера: вызовы библиотеки Telegram заменяем на вызовы MAX Bridge;
• проверка данных пользователя на сервере: пишем ее заново по документации MAX;
• бот: команды и уведомления переписываем под API MAX, для JavaScript и Go у платформы есть официальные библиотеки.

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

Стек для мини-приложения в MAX

• Фронтенд: React или Vue с TypeScript, сборщик Vite.
• Бэкенд: Node.js или Python, REST API, проверка данных пользователя, логика ролей.
• База данных: PostgreSQL, Redis для очередей и кеша.
• Хостинг: российские облака, если приложение работает с персональными данными.
• Интеграции: 1С, CRM, платежные сервисы, службы доставки.

Бота и API удобно держать в одном сервисе: так уведомления о заказе уходят сразу после записи в базу, без лишних очередей между системами.

От чего зависят срок и бюджет

Бюджет мини-приложения для MAX считают так же, как для любого веб-продукта. Смету двигают число экранов и ролей, оплата, интеграции, админ-панель и требования к нагрузке. Отдельный пункт для MAX - время на верификацию профиля и модерацию бота. Денег они не стоят, но сдвигают дату запуска.

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

Ошибки при запуске в MAX

• Разработку начали, не оформив доступ организации. Приложение готово, а публиковать его не от кого.
• Код скопировали из инструкций к Telegram. Похожая схема не значит одинаковые методы.
• Пропустили проверку данных пользователя на сервере.
• Персональные данные хранят на зарубежных серверах.
• Бот зарегистрирован на подрядчика, а не на компанию.
• Дату рекламы назначили до одобрения платформой.

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