Omnia

Omnia / MAX Studio / Docs

От идеи до запуска в MAX — без пропущенных шагов

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

Как читать руководство

  • ① Идите по главам 00–10 для первого запуска.
  • ② Цифры на снимках показывают точные места клика.
  • ③ Блок «Результат» — критерий завершения шага.
  • ④ Не передавайте токены и пароли в чат или код проекта.

Обновлено 31 июля 2026

00

Перед началом

Что подготовить до первого клика

MAX Studio выполняет сборку, backend, безопасное превью, публикацию и webhook. Внешние кабинеты остаются под вашим контролем: почта, платёжный магазин и MAX для партнёров.

1

Аккаунт

Email подтверждён

2

Проект

Сборка проверена

3

MAX-бот

Токен валиден

4

Production

HTTPS и webhook

5

Запуск

2 реальных юзера

Рабочий email

На него придёт одноразовая ссылка подтверждения и уведомления безопасности.

Реквизиты владельца

ФИО/название, ИНН и ОГРН/ОГРНИП должны совпадать с профилем MAX.

Профиль MAX для партнёров

Верифицированный профиль и промодерированный чат-бот. Токен появится после модерации.

Платёжные реквизиты

Для платного запуска: активный магазин ЮKassa и утверждённая схема чеков.

01

Вход в Studio

Регистрация, email и проверка владельца

Аккаунт MAX Studio привязывается к реальному владельцу бизнеса. Пока email и реквизиты не подтверждены, создание и оплата production-проекта ограничены.

  1. 01

    Откройте регистрацию

    Перейдите на /max/register. Укажите рабочий email, придумайте пароль не короче 10 символов, примите условия и нажмите «Создать аккаунт».

    Результат: Аккаунт создан, на экране показан адрес для подтверждения.

  2. 02

    Подтвердите email

    Откройте письмо «Подтвердите email для MAX Studio» и нажмите ссылку. Ссылка одноразовая и имеет срок действия. Если письмо не пришло, проверьте «Спам» и нажмите «Отправить ещё раз» только один раз.

    Результат: В MAX Studio появился экран выбора владельца бизнеса.

  3. 03

    Выберите тип владельца

    На /max/onboarding выберите Самозанятый, ИП или Организация. Тип должен совпадать с владельцем будущего MAX-бота.

    Результат: Форма показывает правильный набор реквизитов.

  4. 04

    Введите реквизиты без сокращений

    Укажите юридическое имя и ИНН. Для ИП добавьте ОГРНИП, для организации — ОГРН. Нажмите «Проверить реквизиты». Не используйте псевдоним бренда вместо юридического имени.

    Результат: Статус профиля — «Проверен» или «Ожидает проверки».

  5. 05

    Войдите в рабочее пространство

    После подтверждения откройте /max. Если вас вернуло на вход, авторизуйтесь тем же email и паролем.

    Результат: Открыта страница «Мои приложения».

02

Первый проект

Создание MAX Mini App из короткого описания

На этом шаге вы задаёте продуктовую рамку. Чем точнее главное действие и аудитория, тем меньше уточнений потребуется агенту во время первой сборки.

Снимок 01

Мои приложения → Новый проект

MAX Studio

Рабочее пространство

Мои приложения

Кофе рядом

Новый MAX-проект

Что создаём?

Тип приложения

Лояльность
Каталог и заказы
1Нажмите «Новый проект» в правом верхнем углу или на пустой карточке.
2Заполните название, главное действие и выберите ближайший тип приложения.
3Проверьте данные и нажмите «Создать проект». Первая генерация стартует после открытия редактора.

Хорошее описание

  • Одна понятная аудитория: «постоянные гости кофейни».
  • Одно главное действие: «оформить заказ к выдаче».
  • 3–7 функций первого релиза, без списка на год вперёд.
  • Конкретные брендовые цвета или разрешение подобрать стиль.
  • Что должно храниться: заказы, баллы, записи, профиль.

Чего избегать

  • «Сделай приложение как у всех» без сценария.
  • Несколько несвязанных бизнесов в одном Mini App.
  • Требование Telegram/VK внутри проекта MAX.
  • Секретные ключи, пароли и паспортные данные в описании.
  • Сразу 30 экранов и интеграции, которых нет в MVP.

03

Работа с агентом

Как получить рабочую сборку и не потерять контекст

Редактор состоит из трёх зон: диалог с агентом, живое мобильное превью и мастер готовности к запуску. Все изменения сохраняются на сервере и попадают в историю проекта.

Снимок 02

Редактор → чат, превью и панель запуска

Кофе рядом

● Сохранено на сервере

Первая версия готова

Добавил главный экран, программу лояльности, профиль и историю наград. Проверьте интерфейс справа.

build · typecheck clean · preview 200

Например: добавь экран наград и кнопку обмена баллов…

Отправить

Mobile WebView · Живое превью

Кофе рядом

1 250 баллов

Заказать кофе
Мои награды
История
1Введите одно изменение в нижнее поле и отправьте. Для новой функции опишите ожидаемый результат и граничные случаи.
2Проверьте живое превью: навигацию, пустые состояния, ошибки формы, повторное открытие и мобильную клавиатуру.
3К публикации переходите только после чистой проверки. Кнопка откроет мастер готовности и production deploy.

Одна задача за сообщение

Так проще проверить результат и при необходимости откатить только одну правку.

Проверяйте как пользователь

Нажимайте кнопки, создавайте тестовые данные, обновляйте страницу и повторяйте сценарий.

Не перезапускайте генерацию

При зависшем статусе сначала обновите страницу: серверная задача продолжает работать в фоне.

Шаблоны сообщений агенту

Новая функция

Добавь запись на услугу: выбор даты, свободного времени, подтверждение и экран «Мои записи». Не допускай двойного бронирования.

Исправление

На экране заказа кнопка перекрывается клавиатурой. Сохрани текущий дизайн и исправь только mobile layout и safe area.

Проверка данных

Проверь, что пользователь MAX видит только свои заказы. Добавь пустое состояние и понятную ошибку при недоступном сервере.

Контент

Замени тексты каталога на приложенный список. Не меняй backend, навигацию и визуальный стиль.

04

Управляемая конфигурация

Данные приложения, каталог и юридические экраны

Часть информации меняется без новой генерации и без расхода баланса. Это название, описание, контент, поддержка, данные оператора, юридические признаки и подтверждение URL в MAX.

  1. 01

    Откройте настройки приложения

    В редакторе справа откройте панель «Публикация» и нажмите «Приложение». На отдельных страницах используйте меню «MAX и приложение».

    Результат: Открыто окно «Готовое приложение без разработчика».

  2. 02

    Заполните продукт

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

    Результат: У приложения нет временных текстов и заглушек.

  3. 03

    Добавьте каталог или услуги

    В блоке «Каталог и контент» нажмите «Добавить». Для каждого элемента задайте название, описание, цену, подпись кнопки и активность.

    Результат: Все позиции имеют понятную цену и действие.

  4. 04

    Заполните оператора и поддержку

    Юридическое имя, ИНН, ОГРН/ОГРНИП и адрес должны совпадать с офертой и платёжным кабинетом. Добавьте рабочий email и телефон поддержки.

    Результат: Пользователь может определить продавца и связаться с ним.

  5. 05

    Отметьте юридические признаки

    Укажите наличие продаж, пользовательского контента и маркетинговых уведомлений. Примите условия только после проверки сгенерированных документов.

    Результат: Readiness отмечает юридические данные как готовые.

  6. 06

    Сохраните

    Нажмите «Сохранить». Studio создаст новую управляемую версию без вызова модели.

    Результат: Появилось уведомление «Настройки применены без генерации».

05

Внешние сервисы

Подключение интеграций без передачи секретов агенту

Интеграции подключаются на уровне бизнеса или проекта. Секреты шифруются и подставляются сервером; агент и код Mini App их не видят.

Снимок 03

Интеграции → подключение сервиса и MAX-бота

Подключения

Интеграции приложения

Секреты хранятся зашифрованно и не попадают в код проекта.

Не подключено

MAX Bot API

Точка входа, сообщения и webhook

Не подключено

ЮKassa

Платежи, возвраты и статусы

Не подключено

Битрикс24

Лиды и сделки

Не подключено

Яндекс Метрика

События и конверсии

Подключить MAX-бота

Вставьте токен из MAX для партнёров. Токен будет проверен через API.

Введите токен бота
1Выберите MAX Bot API или другой сервис и нажмите «Подключить».
2Для MAX вставьте токен в защищённое поле, затем нажмите «Проверить и сохранить».
  1. 01

    Выберите сервис

    Откройте /max/ID/integrations. Карточка показывает возможности, способ авторизации и текущий статус.
  2. 02

    Используйте OAuth, если доступен

    Нажмите «Авторизовать» и подтвердите доступ в кабинете провайдера. Не копируйте пароль от самого кабинета.

    Результат: Статус подключения — «Активно».

  3. 03

    Для ключей используйте только защищённую форму

    Вставляйте API-ключ или токен в поле интеграции. Никогда не отправляйте секрет в чат агенту и не добавляйте его в файлы проекта.

    Результат: Ключ проверен у провайдера и зашифрован.

  4. 04

    Привяжите интеграцию к проекту

    Если сервис подключён на уровне бизнеса, выберите нужное соединение в проекте. Один бизнес-доступ можно безопасно использовать в нескольких Mini Apps.

    Результат: Карточка проекта показывает выбранное соединение.

  5. 05

    Проверьте реальное действие

    Создайте тестовую запись, лид, заказ или платёж в Mini App и убедитесь, что объект появился у провайдера.

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

06

Точка входа

Создание, модерация и подключение MAX-бота

Бот является владельцем кнопки запуска Mini App и источником событий Bot API. Создать его может только верифицированный профиль организации, ИП или самозанятого в MAX для партнёров.

В MAX для партнёров

  • Профиль организации/ИП/самозанятого верифицирован.
  • Создан чат-бот с понятным именем, описанием и аватаром.
  • Бот прошёл модерацию и имеет статус «создан».
  • В расширенных настройках появился токен.
  • Владелец профиля совпадает с владельцем MAX Studio.

В Omnia

  • Проект создан как MAX Mini App.
  • Открыта интеграция MAX Bot API.
  • Токен вставлен только в защищённое поле.
  • Проверка вернула имя и username нужного бота.
  • После публикации webhook имеет статус «активен».
  1. 01

    Создайте бота

    Откройте MAX для партнёров, выберите профиль, затем «Чат-боты» → «Создать». Заполните карточку и отправьте на модерацию.

    Результат: Статус бота — «на модерации».

  2. 02

    Дождитесь статуса «создан»

    Пока бот модерируется, его настройки и токен могут быть недоступны. При статусе «требует исправлений» откройте причину, исправьте карточку и отправьте повторно.

    Результат: Бот находится поиском в настоящем клиенте MAX.

  3. 03

    Скопируйте токен

    «Чат-боты» → «Перейти» → «Расширенные настройки» → «Настроить». Нажмите копирование рядом с токеном.

    Результат: Токен доступен в буфере обмена, но не сохранён в заметках или чате.

  4. 04

    Подключите в Studio

    В проекте откройте «Интеграции» → «MAX Bot API» → «Подключить». Вставьте токен и нажмите «Проверить и сохранить».

    Результат: Studio показывает правильное имя и username бота.

  5. 05

    Не меняйте токен без причины

    Обновление токена в MAX немедленно делает старый недействительным. Если ротация нужна, сначала выпустите новый токен, затем сразу обновите интеграцию в Studio и проверьте webhook.

    Результат: Интеграция снова имеет статус «активно».

07

Production

Публикация на постоянный HTTPS-адрес

Публикация собирает неизменяемую версию, разворачивает контейнер, проверяет health endpoint и только затем переключает production. Неудачная версия не должна заменять работающую.

Снимок 04

Публикация → мастер готовности

Release

Публикация в MAX

Production

Постоянный HTTPS-адрес и проверка контейнера

Версия

v.12

Health

готов

Webhook

ожидает URL

1Нажмите «Опубликовать», когда сборка и данные приложения проверены.
2Следуйте текущему шагу мастера. Он показывает первую незавершённую причину, а не общий список ошибок.
  1. 01

    Откройте мастер

    В редакторе нажмите «Опубликовать» или перейдите на /max/ID/publish.

    Результат: Видны прогресс и текущий незавершённый шаг.

  2. 02

    Закройте readiness

    Последовательно заполните приложение, юридические данные и подключите MAX-бота. Не обходите пункты вручную — каждый статус проверяется сервером.

    Результат: Следующий шаг мастера — «Опубликуйте приложение».

  3. 03

    Запустите deploy один раз

    Нажмите «Опубликовать». Во время фаз building, pushing и swapping не нажимайте кнопку повторно и не закрывайте проект принудительно.

    Результат: Фаза публикации — done, отображается production URL.

  4. 04

    Проверьте production

    Откройте полученный URL отдельно. Проверьте первый экран, основные API-действия и обновление страницы.

    Результат: HTTPS открывается без предупреждений, приложение отвечает после reload.

  5. 05

    Активируйте webhook

    После успешного deploy Studio формирует /api/max/webhook, подписывает бота через MAX API и проверяет подписку.

    Результат: Интеграция MAX показывает «Webhook активен».

СтатусЧто означаетЧто делать
buildingСобирается production-образ.Ждать. Не запускайте второй deploy.
pushingОбраз передаётся в production runtime.Не закрывать публикацию принудительно.
swappingНовая версия проходит health-check и готовится принять трафик.Проверить детали, если фаза длится необычно долго.
doneProduction успешно переключён.Открыть URL, затем перейти к MAX Partner.
failedСборка или health-check не прошли.Открыть детали, исправить первопричину в редакторе и повторить.

08

Ручной внешний шаг

Как вставить production URL в MAX Partner

MAX пока требует сохранить ссылку мини-приложения в кабинете владельца бота. Studio копирует точный URL и ведёт к нужному кабинету; вводить адрес вручную по памяти не нужно.

Снимок 05

MAX для партнёров → Расширенные настройки

Чат-боты / Кофе рядом

Расширенные настройки

Бот создан

Токен бота

Используется сервером для Bot API.

••••••••••••••••••••••••
https://app-42.lead-generator.ru

Кнопка запуска

1Скопируйте токен только при первичном подключении бота. После этого он остаётся в Studio зашифрованным.
2Вставьте именно production URL из Studio в поле «Ссылка на мини-приложение» и выберите кнопку «Открыть».
3Нажмите «Сохранить», дождитесь подтверждения и только потом отметьте URL в мастере Studio.
  1. 01

    Скопируйте URL в Studio

    В панели запуска, когда webhook активен, нажмите ссылку production или «Открыть кабинет MAX». Studio предварительно копирует адрес в буфер.

    Результат: В буфере адрес вида https://… без /preview и временного токена.

  2. 02

    Откройте настройки бота

    В MAX Partner выберите правильную организацию и бота: «Чат-боты» → «Перейти» → «Расширенные настройки» → «Настроить».
  3. 03

    Вставьте ссылку

    В поле мини-приложения вставьте URL. Не добавляйте /api/max/webhook, параметры preview или ссылку на редактор.

    Результат: Поле содержит корень production Mini App.

  4. 04

    Выберите кнопку

    Выберите подпись «Открыть». Это самая понятная точка входа для универсального бизнес-приложения.
  5. 05

    Сохраните и дождитесь статуса

    Нажмите «Сохранить». Если MAX отправил изменения на повторную модерацию, дождитесь возвращения рабочего статуса.

    Результат: В настоящем чате бота появилась кнопка запуска.

  6. 06

    Подтвердите в Studio

    Вернитесь в настройки приложения и включите «URL добавлен в MAX».

    Результат: Readiness равен 100%, приложение готово к приёмке.

09

Настоящий клиент MAX

Приёмка двумя разными пользователями

Браузерное превью проверяет интерфейс, но не доказывает интеграцию с MAX. Финальная приёмка проводится в мобильном клиенте через кнопку настоящего промодерированного бота.

Пользователь A — новый

  • Открывает бота по ссылке или через поиск MAX.
  • Нажимает «Открыть» и видит Mini App внутри MAX.
  • Создаёт тестовую запись/заказ/действие.
  • Закрывает шторку и открывает повторно.
  • Видит только собственные данные и сохранённый результат.

Пользователь B — изоляция

  • Использует другой реальный MAX-аккаунт и устройство.
  • Первый экран не содержит данных пользователя A.
  • Создаёт свой отдельный объект.
  • После повторного запуска видит только свой объект.
  • Получает сервисное сообщение, если оно входит в сценарий.

Протокол приёмки

2 разных MAX ID

Сервер получил две независимые личности из валидированного initData.

Изоляция данных

Каждый select/update/delete ограничен владельцем объекта.

Webhook 200

События MAX приняты, секрет проверен, повторы не создают дубликаты.

  1. 01

    Назначьте окно проверки

    Оба пользователя должны быть доступны одновременно 15–20 минут. Используйте тестовые имена и данные, не реальные ПДн клиентов.
  2. 02

    Запишите начальное состояние

    Production имеет done, health зелёный, webhook активен, URL подтверждён. Не вносите изменения во время прогона.
  3. 03

    Пройдите один и тот же сценарий

    A проходит путь полностью, затем B повторяет его. Фиксируйте время каждого действия — так события легко найти в журнале.
  4. 04

    Проверьте повторный вход

    Оба закрывают и повторно открывают Mini App. Сессия восстанавливается через новый валидный initData, данные не смешиваются.
  5. 05

    Зафиксируйте результат

    Сохраните версию, production URL, username бота и итог каждого пункта. Не сохраняйте токен, initData или персональные идентификаторы в публичном отчёте.

    Результат: Два пользователя завершили путь, изоляция и webhook подтверждены.

10

Эксплуатация

Что делать после запуска и как выпускать изменения

После запуска проект остаётся управляемым: видны runtime, health, бот, webhook и история публикаций. Новое изменение проходит тот же цикл — правка, превью, новая версия, deploy и проверка.

Снимок 06

После запуска → здоровье production

Production

После запуска

Открыть приложение

Контейнер

Работает

Health-check

Отвечает

MAX-бот

Кофе рядом

Webhook

Активен

Versions

История публикаций

v.12 · Production buildсейчасdone
v.11 · Обновление каталога1 дн.done
v.10 · Первая публикация2 дн.done

Эксплуатация

Без разработчика

Health-check после релиза

Всегда активный контейнер

Версии и откат

1Кнопка «Открыть приложение» ведёт на текущий production и используется для быстрой проверки.
2История публикаций показывает версии и результат deploy. При проблеме сравните последнюю успешную и текущую.

Регулярная проверка

  • Контейнер — running.
  • Health-check — отвечает.
  • MAX-бот — подключён.
  • Webhook — активен.
  • Ключевые API-действия проходят.
  • Последняя успешная версия известна.

Безопасный релиз изменения

  • Одна ограниченная задача агенту.
  • Проверка в безопасном превью.
  • Тест существующих сценариев, не только новой функции.
  • Новая публикация и зелёный health.
  • Повторный запуск в настоящем MAX.
  • Запись версии и результата проверки.

11

Тариф и баланс

Подписка, зачисление кредита и автопродление

Подписка определяет лимиты проектов и ежемесячный кредит на генерации. Платёж проходит у провайдера, а ledger фиксирует каждое зачисление отдельной неизменяемой операцией.

  1. 01

    Откройте тарифы

    В аккаунте выберите «Биллинг» → «Тариф» или откройте /billing/plan.
  2. 02

    Выберите план

    Сравните число проектов, включённый кредит и функции. Для первого production-пути используйте минимальный план, который разрешает публикацию нужного проекта.
  3. 03

    Подтвердите условия

    Перед оплатой проверьте цену, период, автопродление, оферту и email для чека. Автопродление включается только с явным согласием.
  4. 04

    Завершите оплату у ЮKassa

    Studio перенаправит на защищённую форму. Не обновляйте страницу оплаты многократно. После подтверждения вернитесь в Studio.

    Результат: Платёж имеет статус succeeded.

  5. 05

    Проверьте ledger

    В «Биллинг» → «Транзакции» должна появиться одна операция subscription_credit. Повторное открытие callback или webhook не должно создавать вторую.

    Результат: Баланс увеличен ровно на кредит тарифа.

  6. 06

    Управляйте продлением

    Отключение автопродления не отнимает уже оплаченный период. Включить его обратно можно до конца периода, если сохранённый способ оплаты активен.
pending_payment

Платёж создан, пользователь ещё не завершил форму.

active

Период оплачен, лимиты и кредит применены.

cancel_at_period_end

Продление выключено, доступ действует до даты окончания.

past_due

Продление не прошло, действует льготный период.

canceled

Подписка прекращена и больше не продлевается.

refunded

Возврат подтверждён провайдером и отражён в учёте.

12

Диагностика

Что означает ошибка и куда идти

Сначала зафиксируйте экран, время и действие. Затем определите слой: аккаунт, сборка, безопасное превью, production, интеграция или внешний кабинет MAX.

Не приходит email

Проверьте адрес и спам → повторите один раз → если канал недоступен, не создавайте второй аккаунт.

Реквизиты ожидают проверку

Сверьте тип владельца и цифры → дождитесь проверки → при отказе исправьте ровно указанное поле.

Генерация долго идёт

Обновите страницу → проверьте, восстановился ли серверный статус → не отправляйте тот же запрос повторно.

Безопасное превью не открылось

Нажмите «Повторить» → обновите Studio → не открывайте внутренний preview URL отдельно без сессии.

Токен MAX отклонён

Убедитесь, что бот промодерирован → скопируйте токен заново → проверьте, не был ли он отозван.

Deploy failed

Откройте детали фазы → исправьте первую ошибку сборки/health → опубликуйте новую версию.

Webhook не активен

Проверьте done и HTTPS → переподключите текущий токен → повторите активацию без ручной подписки.

Кнопка в MAX открывает не то

Сверьте бота и production URL → удалите preview-параметры → сохраните URL и кнопку «Открыть».

Оплата есть, баланс не изменился

Не платите повторно → откройте транзакции → дождитесь reconcile/webhook → передайте ID платежа поддержке.

Пользователи видят чужие данные

Немедленно остановите приёмку → не продолжайте production → зафиксируйте сценарий и версию для исправления изоляции.

Что приложить к обращению в поддержку

Email аккаунта без пароля

Название и ID проекта

Точное время с часовым поясом

Какую кнопку нажали

Полный текст ошибки

Скриншот без токенов и ПДн

Production URL, если ошибка после deploy

Ожидаемый и фактический результат

13

Контроль качества

Два финальных списка перед отметкой «MVP готов»

Первый список проверяет, что техническая и внешняя части готовы. Второй фиксирует чистый golden path без ручного редактирования базы, подмены статусов и повторных зачислений.

Перед реальной приёмкой

  • SMTP доставляет подтверждение и восстановление пароля.
  • ЮKassa использует настоящий shopId и утверждённую схему чеков.
  • Оператор, ИНН, адрес и поддержка совпадают во всех документах.
  • MAX-профиль верифицирован, бот промодерирован.
  • Токен бота проверен и хранится только в защищённой интеграции.
  • Сборка работает в безопасном превью.
  • Production deploy имеет статус done и зелёный health.
  • Webhook активен, production URL сохранён в MAX Partner.
  • Кнопка «Открыть» видна в реальном клиенте MAX.
  • Назначены два разных MAX-пользователя.

Чистый golden path

  • Новый пользователь зарегистрировался через UI.
  • Email подтверждён по настоящему письму.
  • Бизнес-профиль проверен штатным процессом.
  • Реальный платёж завершён у провайдера.
  • В ledger ровно одно зачисление.
  • Проект создан и собран через Studio.
  • Безопасное превью открыто через подписанную сессию.
  • Публикация выполнена штатным deploy.
  • URL добавлен в правильного MAX-бота.
  • Два пользователя прошли сценарий и не увидели чужие данные.
  • Автопродление управляется из кабинета.
  • Во время пути не выполнялись ручные SQL/SSH-правки.

Следующий шаг

Откройте Studio и пройдите путь по главам 01–09

Если проект уже создан, начинайте с главы, которую показывает мастер готовности. Он всегда ведёт к первой незавершённой причине.

Перейти в MAX Studio
Полное руководство MAX Studio — Omnia · Omnia.AI