Рабочий email
На него придёт одноразовая ссылка подтверждения и уведомления безопасности.
Omnia / MAX Studio / Docs
Полное руководство для владельца бизнеса: что нажимать, какие данные подготовить, как проверить сборку, подключить бота, опубликовать приложение и принять его двумя реальными пользователями.
Как читать руководство
Обновлено 31 июля 2026
00
Перед началом
MAX Studio выполняет сборку, backend, безопасное превью, публикацию и webhook. Внешние кабинеты остаются под вашим контролем: почта, платёжный магазин и MAX для партнёров.
Аккаунт
Email подтверждён
Проект
Сборка проверена
MAX-бот
Токен валиден
Production
HTTPS и webhook
Запуск
2 реальных юзера
На него придёт одноразовая ссылка подтверждения и уведомления безопасности.
ФИО/название, ИНН и ОГРН/ОГРНИП должны совпадать с профилем MAX.
Верифицированный профиль и промодерированный чат-бот. Токен появится после модерации.
Для платного запуска: активный магазин ЮKassa и утверждённая схема чеков.
01
Вход в Studio
Аккаунт MAX Studio привязывается к реальному владельцу бизнеса. Пока email и реквизиты не подтверждены, создание и оплата production-проекта ограничены.
Результат: Аккаунт создан, на экране показан адрес для подтверждения.
Результат: В MAX Studio появился экран выбора владельца бизнеса.
Результат: Форма показывает правильный набор реквизитов.
Результат: Статус профиля — «Проверен» или «Ожидает проверки».
Результат: Открыта страница «Мои приложения».
02
Первый проект
На этом шаге вы задаёте продуктовую рамку. Чем точнее главное действие и аудитория, тем меньше уточнений потребуется агенту во время первой сборки.
Снимок 01
Мои приложения → Новый проект
MAX Studio
Рабочее пространство
Новый MAX-проект
Тип приложения
03
Работа с агентом
Редактор состоит из трёх зон: диалог с агентом, живое мобильное превью и мастер готовности к запуску. Все изменения сохраняются на сервере и попадают в историю проекта.
Снимок 02
Редактор → чат, превью и панель запуска
MAX Studio
Кофе рядом
● Сохранено на сервере
Первая версия готова
Добавил главный экран, программу лояльности, профиль и историю наград. Проверьте интерфейс справа.
Например: добавь экран наград и кнопку обмена баллов…
Mobile WebView · Живое превью
Кофе рядом
1 250 баллов
Так проще проверить результат и при необходимости откатить только одну правку.
Нажимайте кнопки, создавайте тестовые данные, обновляйте страницу и повторяйте сценарий.
При зависшем статусе сначала обновите страницу: серверная задача продолжает работать в фоне.
Новая функция
Добавь запись на услугу: выбор даты, свободного времени, подтверждение и экран «Мои записи». Не допускай двойного бронирования.
Исправление
На экране заказа кнопка перекрывается клавиатурой. Сохрани текущий дизайн и исправь только mobile layout и safe area.
Проверка данных
Проверь, что пользователь MAX видит только свои заказы. Добавь пустое состояние и понятную ошибку при недоступном сервере.
Контент
Замени тексты каталога на приложенный список. Не меняй backend, навигацию и визуальный стиль.
04
Управляемая конфигурация
Часть информации меняется без новой генерации и без расхода баланса. Это название, описание, контент, поддержка, данные оператора, юридические признаки и подтверждение URL в MAX.
Результат: Открыто окно «Готовое приложение без разработчика».
Результат: У приложения нет временных текстов и заглушек.
Результат: Все позиции имеют понятную цену и действие.
Результат: Пользователь может определить продавца и связаться с ним.
Результат: Readiness отмечает юридические данные как готовые.
Результат: Появилось уведомление «Настройки применены без генерации».
05
Внешние сервисы
Интеграции подключаются на уровне бизнеса или проекта. Секреты шифруются и подставляются сервером; агент и код Mini App их не видят.
Снимок 03
Интеграции → подключение сервиса и MAX-бота
MAX Studio
Подключения
Секреты хранятся зашифрованно и не попадают в код проекта.
MAX Bot API
Точка входа, сообщения и webhook
ЮKassa
Платежи, возвраты и статусы
Битрикс24
Лиды и сделки
Яндекс Метрика
События и конверсии
Подключить MAX-бота
Вставьте токен из MAX для партнёров. Токен будет проверен через API.
Результат: Статус подключения — «Активно».
Результат: Ключ проверен у провайдера и зашифрован.
Результат: Карточка проекта показывает выбранное соединение.
Результат: Интеграция подтверждена не только кнопкой, но и фактическим событием.
06
Точка входа
Бот является владельцем кнопки запуска Mini App и источником событий Bot API. Создать его может только верифицированный профиль организации, ИП или самозанятого в MAX для партнёров.
Результат: Статус бота — «на модерации».
Результат: Бот находится поиском в настоящем клиенте MAX.
Результат: Токен доступен в буфере обмена, но не сохранён в заметках или чате.
Результат: Studio показывает правильное имя и username бота.
Результат: Интеграция снова имеет статус «активно».
07
Production
Публикация собирает неизменяемую версию, разворачивает контейнер, проверяет health endpoint и только затем переключает production. Неудачная версия не должна заменять работающую.
Снимок 04
Публикация → мастер готовности
MAX Studio
Release
Production
Постоянный HTTPS-адрес и проверка контейнера
Версия
v.12
Health
готов
Webhook
ожидает URL
Результат: Видны прогресс и текущий незавершённый шаг.
Результат: Следующий шаг мастера — «Опубликуйте приложение».
Результат: Фаза публикации — done, отображается production URL.
Результат: HTTPS открывается без предупреждений, приложение отвечает после reload.
/api/max/webhook, подписывает бота через MAX API и проверяет подписку.Результат: Интеграция MAX показывает «Webhook активен».
| Статус | Что означает | Что делать |
|---|---|---|
| building | Собирается production-образ. | Ждать. Не запускайте второй deploy. |
| pushing | Образ передаётся в production runtime. | Не закрывать публикацию принудительно. |
| swapping | Новая версия проходит health-check и готовится принять трафик. | Проверить детали, если фаза длится необычно долго. |
| done | Production успешно переключён. | Открыть URL, затем перейти к MAX Partner. |
| failed | Сборка или health-check не прошли. | Открыть детали, исправить первопричину в редакторе и повторить. |
08
Ручной внешний шаг
MAX пока требует сохранить ссылку мини-приложения в кабинете владельца бота. Studio копирует точный URL и ведёт к нужному кабинету; вводить адрес вручную по памяти не нужно.
Снимок 05
MAX для партнёров → Расширенные настройки
Профиль
Чат-боты
Мини-приложения
Чат-боты / Кофе рядом
Токен бота
Используется сервером для Bot API.
Кнопка запуска
Результат: В буфере адрес вида https://… без /preview и временного токена.
/api/max/webhook, параметры preview или ссылку на редактор.Результат: Поле содержит корень production Mini App.
Результат: В настоящем чате бота появилась кнопка запуска.
Результат: Readiness равен 100%, приложение готово к приёмке.
09
Настоящий клиент MAX
Браузерное превью проверяет интерфейс, но не доказывает интеграцию с MAX. Финальная приёмка проводится в мобильном клиенте через кнопку настоящего промодерированного бота.
Протокол приёмки
2 разных MAX ID
Сервер получил две независимые личности из валидированного initData.
Изоляция данных
Каждый select/update/delete ограничен владельцем объекта.
Webhook 200
События MAX приняты, секрет проверен, повторы не создают дубликаты.
Результат: Два пользователя завершили путь, изоляция и webhook подтверждены.
10
Эксплуатация
После запуска проект остаётся управляемым: видны runtime, health, бот, webhook и история публикаций. Новое изменение проходит тот же цикл — правка, превью, новая версия, deploy и проверка.
Снимок 06
После запуска → здоровье production
MAX Studio
Production
Контейнер
Работает
Health-check
Отвечает
MAX-бот
Кофе рядом
Webhook
Активен
Versions
История публикаций
Эксплуатация
Без разработчика
Health-check после релиза
Всегда активный контейнер
Версии и откат
11
Тариф и баланс
Подписка определяет лимиты проектов и ежемесячный кредит на генерации. Платёж проходит у провайдера, а ledger фиксирует каждое зачисление отдельной неизменяемой операцией.
Результат: Платёж имеет статус succeeded.
subscription_credit. Повторное открытие callback или webhook не должно создавать вторую.Результат: Баланс увеличен ровно на кредит тарифа.
pending_paymentПлатёж создан, пользователь ещё не завершил форму.
activeПериод оплачен, лимиты и кредит применены.
cancel_at_period_endПродление выключено, доступ действует до даты окончания.
past_dueПродление не прошло, действует льготный период.
canceledПодписка прекращена и больше не продлевается.
refundedВозврат подтверждён провайдером и отражён в учёте.
12
Диагностика
Сначала зафиксируйте экран, время и действие. Затем определите слой: аккаунт, сборка, безопасное превью, production, интеграция или внешний кабинет MAX.
Проверьте адрес и спам → повторите один раз → если канал недоступен, не создавайте второй аккаунт.
Сверьте тип владельца и цифры → дождитесь проверки → при отказе исправьте ровно указанное поле.
Обновите страницу → проверьте, восстановился ли серверный статус → не отправляйте тот же запрос повторно.
Нажмите «Повторить» → обновите Studio → не открывайте внутренний preview URL отдельно без сессии.
Убедитесь, что бот промодерирован → скопируйте токен заново → проверьте, не был ли он отозван.
Откройте детали фазы → исправьте первую ошибку сборки/health → опубликуйте новую версию.
Проверьте done и HTTPS → переподключите текущий токен → повторите активацию без ручной подписки.
Сверьте бота и production URL → удалите preview-параметры → сохраните URL и кнопку «Открыть».
Не платите повторно → откройте транзакции → дождитесь reconcile/webhook → передайте ID платежа поддержке.
Немедленно остановите приёмку → не продолжайте production → зафиксируйте сценарий и версию для исправления изоляции.
Email аккаунта без пароля
Название и ID проекта
Точное время с часовым поясом
Какую кнопку нажали
Полный текст ошибки
Скриншот без токенов и ПДн
Production URL, если ошибка после deploy
Ожидаемый и фактический результат
13
Контроль качества
Первый список проверяет, что техническая и внешняя части готовы. Второй фиксирует чистый golden path без ручного редактирования базы, подмены статусов и повторных зачислений.
Следующий шаг
Если проект уже создан, начинайте с главы, которую показывает мастер готовности. Он всегда ведёт к первой незавершённой причине.