Запуск мини-приложения в MAX состоит из двух параллельных направлений: бизнес проектирует клиентский процесс, а техническая команда создаёт бота, Mini App, backend и интеграции. Если заниматься только интерфейсом, после релиза выясняется, что данные неактуальны, заявки некуда передавать, а сотрудники не готовы к новому каналу.
Ниже — последовательный план от идеи до рабочего пилота.
Шаг 1. Определите задачу и метрику
Начните с одного действия: записаться, оформить заказ, оставить заявку, подобрать вариант или создать обращение. Зафиксируйте, что считается успехом.
Примеры метрик:
- квалифицированная заявка создана в CRM;
- запись подтверждена в системе расписания;
- заказ записан в 1С;
- обращение получило номер и ответственного;
- клиент самостоятельно проверил статус.
Открытие Mini App — промежуточное событие, а не бизнес-результат.
Шаг 2. Создайте профиль на платформе MAX
Платформа MAX для партнёров доступна организациям, ИП и самозанятым — резидентам России. Нужно зарегистрировать профиль и пройти верификацию. Для организаций и ИП доступны Госуслуги и поддерживаемые банковские сервисы, для самозанятых — Госуслуги.
Используйте рабочий номер, который остаётся под контролем компании. Подробная последовательность приведена в официальной инструкции.
Шаг 3. Спроектируйте пользовательский путь
Опишите:
- Откуда пользователь приходит.
- Что видит бот.
- Какой экран открывается первым.
- Какие данные человек выбирает или вводит.
- Что проверяется на сервере.
- Куда передаётся результат.
- Как пользователь получает подтверждение.
Для каждого шага предусмотрите ошибку, отмену и возврат. Прототип стоит проверить на нескольких людях, которые не участвовали в проекте.
Шаг 4. Определите архитектуру
Базовая production-схема включает:
- чат-бота;
- frontend Mini App;
- backend;
- базу данных при необходимости;
- интеграцию с CRM, 1С или другой системой;
- аналитику и логирование.
Фронтенд не должен хранить токен бота и секреты. Backend валидирует стартовые данные, применяет бизнес-логику и взаимодействует с внешними API.
Шаг 5. Создайте и отправьте бота на модерацию
После верификации профиля создайте карточку бота: название, описание, логотип и сайт при наличии. Ник генерируется платформой автоматически. Каждый бот проходит модерацию.
После успешной проверки становятся доступны токен, расширенные настройки и подключение Mini App. Организация или ИП может создать до пяти ботов, самозанятый — до двух: создание чат-бота MAX.
Не откладывайте этот шаг на конец разработки: модерация и корректировка карточки могут занять дополнительное время.
Шаг 6. Разработайте backend и интеграции
Backend должен:
- принимать и валидировать запросы Mini App;
- безопасно хранить токены;
- работать с API MAX;
- передавать данные в рабочие системы;
- обрабатывать ошибки и повторы;
- вести логи;
- ограничивать доступ к персональным данным.
Для production-событий бот использует Webhook по HTTPS. API вызывается через актуальный домен platform-api2.max.ru, токен передаётся в заголовке Authorization: обзор API MAX.
Шаг 7. Разработайте интерфейс
Mini App создаётся на стандартных веб-технологиях и размещается по HTTPS. Для взаимодействия с клиентом MAX подключается MAX Bridge, а интерфейс можно собирать на компонентах MAX UI.
Обязательно реализуйте:
- загрузку;
- успешный результат;
- ошибки валидации;
- отсутствие данных;
- повторную отправку;
- восстановление после возврата;
- мобильные размеры;
- доступный контраст и зоны нажатия.
Шаг 8. Подключите Mini App к боту
В расширенных настройках прошедшего модерацию бота укажите HTTPS-URL приложения и вид кнопки запуска. После сохранения кнопка появится в чате.
Для разных источников используйте диплинки с параметром startapp. Они позволяют открывать конкретный сценарий и передавать метку кампании. Параметр проверяется и обрабатывается приложением, а не используется как доверенная команда без валидации.
Шаг 9. Настройте аналитику
Собирайте события по всей воронке:
- источник;
- запуск бота;
- открытие Mini App;
- начало действия;
- ключевые выборы;
- успешная запись результата;
- ошибка;
- ответ сотрудника;
- повторное использование.
Источник нужно передавать до CRM, чтобы оценивать не только клики, но и качество лидов и сделки.
Шаг 10. Проведите сквозное тестирование
Проверьте не только happy path. Нужны сценарии:
- новый и повторный пользователь;
- неверный контакт;
- отсутствие вариантов;
- одновременный заказ одного ресурса;
- повторный callback;
- временная недоступность CRM;
- истёкшая сессия;
- закрытие приложения на середине;
- повторный переход по диплинку;
- действия сотрудника после заявки.
Тест должен завершаться в реальной рабочей системе и обратном сообщении пользователю.
Шаг 11. Запустите закрытый пилот
Начните с сотрудников, лояльных клиентов или одного филиала. Ограниченный запуск позволяет проверить операционный процесс без риска потерять большой поток.
Для пилота задайте:
- срок;
- размер аудитории;
- основной источник трафика;
- целевую метрику;
- допустимое количество ошибок;
- владельца обратной связи;
- решение по итогам: расширить, доработать или остановить.
Шаг 12. Откройте трафик и развивайте продукт
После пилота устраните критичные разрывы и подключайте дополнительные источники: канал, сайт, QR-коды, рекламу и клиентские коммуникации.
Новые функции добавляйте на основе данных. Если пользователи бросают основной сценарий, запуск личного кабинета не решит проблему. Сначала улучшите путь, который связан с результатом.
Реалистичные сроки
При готовых вводных ориентиры могут выглядеть так:
| Формат | Ориентировочный срок |
|---|---|
| Простой бот | 2–4 недели |
| Mini App без сложной интеграции | 5–8 недель |
| Mini App с одной корпоративной системой | 7–12 недель |
| Сложный клиентский сервис | от 12 недель |
Сроки увеличивают доступы, качество данных, юридические согласования, изменения внешних API и скорость принятия решений со стороны компании.
Что должно быть после запуска
- владелец продукта;
- контакт поддержки;
- мониторинг backend;
- журнал ошибок;
- резервное копирование;
- контроль токенов и доступов;
- регламент обновлений;
- аналитический отчёт;
- backlog улучшений;
- план действий при недоступности внешней системы.
Частые вопросы
Можно ли запустить Mini App без backend?
Только для статического демонстрационного сценария. Заявки, авторизация, интеграции и персональные данные требуют серверной обработки.
Когда создавать бота?
В начале проекта, после верификации профиля. Это позволяет заранее пройти модерацию и получить токен для интеграционной разработки.
Обязательно ли сразу подключать CRM?
Нет, если пилот обрабатывает один ответственный и заявки фиксируются контролируемо. Но архитектуру передачи результата нужно определить заранее.
Какой объём первой версии оптимален?
Один законченный сценарий с измеримым результатом. Обычно 4–8 основных экранов и минимальное количество интеграций.
Что делать, если правила или API MAX изменились?
Проверить историю изменений, обновить интеграцию на тестовом контуре и провести регрессионное тестирование. Поэтому проекту нужна поддержка после публикации.