FAQ по разделу Приложения

Для кого и когда нужен этот документ

Этот документ собирает типовые вопросы, которые чаще всего возникают у:

  • владельца компании
  • менеджера
  • контент-менеджера
  • маркетолога
  • сотрудника, который отвечает за запуск Telegram Mini App или Max App

Связанные документы по разделу:

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

Открывайте этот документ, если нужно:

  • быстро понять смысл поля в карточке приложения
  • объяснить сотруднику разницу между приложением, страницей и компонентом
  • быстро разобраться, что меняет Telegram-настройка, тема, платежный аккаунт или удаление приложения

Если нужен полный обзор раздела, вернитесь к:

Если нужен пошаговый рабочий маршрут, открывайте:

Если нужно разобрать проблему, ошибку или блокировку, открывайте:

1. Общие вопросы по разделу

Что такое приложение в CMS Omnis?

Приложение - это верхний контейнер всей клиентской витрины. Именно оно объединяет:

  • страницы
  • слоты
  • компоненты
  • торговые сценарии каталога, корзины и оформления заказа
  • theme-настройки
  • Telegram-интеграцию
  • платежную привязку

Если говорить просто, приложение - это основа готового клиентского продукта, который потом видит покупатель.

Чем приложение отличается от страницы?

Приложение - это вся витрина целиком.

Страница - это один конкретный экран внутри этой витрины, например:

  • главная
  • каталог
  • карточка товара
  • корзина
  • личный кабинет

Чем приложение отличается от компонента?

Приложение задает общую среду работы витрины.

Компонент - это один отдельный UI-блок внутри страницы, например:

  • баннер
  • меню
  • карусель товаров
  • карта
  • блок оформления заказа

Можно ли работать только в разделе Приложения и не заходить в Страницы и Компоненты?

Нет, если задача не ограничивается только базовой настройкой карточки приложения.

Раздел Приложения нужен для основы:

  • Telegram
  • платежи
  • theme
  • макет
  • базовые настройки витрины

А уже Страницы и Компоненты отвечают за конкретное содержимое витрины.

Какой тип приложения использовать в обычной работе?

В текущем рабочем сценарии Omnis основной тип - Mini-app.

Пункты WEB и Mobile также предусмотрены и будут доступны шире по мере развития продукта.

2. Каталог приложений

Что показывает каталог приложений?

Каталог показывает все CMS-приложения компании в виде списка, где видно:

  • тип приложения
  • название
  • код
  • активность

По каким данным работает быстрый поиск в каталоге приложений?

Быстрый поиск ориентирован на:

  • Наименование
  • Код

Это основные рабочие опоры для поиска нужной витрины.

Что означает зеленый индикатор в строке приложения?

Это означает, что приложение активно.

Можно ли хранить в каталоге неактивные приложения?

Да. Неактивное приложение может оставаться в системе как черновая, тестовая или историческая запись, но не считается рабочим активным приложением компании.

Зачем компании несколько приложений?

Это может быть полезно, если нужны:

  • разные бренды
  • разные витрины
  • разные Telegram-боты
  • разные коммерческие сценарии
  • отдельные проекты внутри одной компании

3. Создание и базовые поля

Как лучше создавать новое приложение: из каталога или через мастер?

Для первого запуска почти всегда лучше использовать Конструктор приложений.

Причина простая:

  • мастер проводит по шагам
  • помогает заполнить Telegram-данные
  • помогает выбрать стартовую тему
  • автоматически создает стартовые страницы и часть демонстрационного наполнения

Создание напрямую из карточки приложения подходит скорее для ручной или технической работы, когда команда уже понимает структуру CMS.

Что такое Код приложения и зачем он нужен?

Это системный код приложения.

Он важен потому, что:

  • используется в ссылках
  • участвует в интеграциях
  • помогает однозначно идентифицировать приложение

После создания код обычно уже не редактируют вручную.

Что такое ID приложения и нужен ли он обычному пользователю?

ID - это внутренний идентификатор записи.

Обычному пользователю он нужен редко. В ежедневной работе важнее:

  • название
  • код
  • активность

Можно ли создать приложение без Telegram-бота?

Для полноценного сценария Mini App Telegram-данные являются одной из ключевых частей настройки. Именно поэтому мастер создания приложения отдельно проверяет:

  • TG-bot user-name
  • TG-bot token

Без них нельзя считать Telegram-сценарий нормально подготовленным к запуску.

Что делает переключатель Активировано?

Он определяет, считается ли приложение активным рабочим приложением компании.

При включении нового приложения система также проверяет лимит активных приложений компании.

4. Telegram и интеграции

Зачем нужны TG-bot token и TG-bot user-name?

Они нужны для реальной связи приложения с Telegram-ботом.

Практически это важно для:

  • запуска Mini App
  • некоторых клиентских сценариев, например ссылок через t.me/...

Что произойдет, если поменять TG-bot token у уже существующего приложения?

Система воспримет это как смену Telegram-привязки приложения и обновит связь с ботом.

Поэтому менять токен нужно осознанно.

Что такое Приветствие приложения?

Это базовый приветственный текст, связанный с работой Telegram-бота и стартовым контактом пользователя с приложением.

Зачем нужен ID счетчика Яндекс.Метрики?

Он нужен для аналитики поведения пользователей в клиентской витрине.

Зачем нужен API ключ карт?

Он нужен для картографических сценариев:

  • карта
  • выбор точки
  • адресные и географические действия

Зачем нужны ключ и секрет подсказок?

Они нужны для адресных подсказок и похожих сценариев, например при оформлении заказа.

Их важно заполнять парой:

  • API ключ
  • Secret

Если указать только одно поле, валидация не пройдет.

5. Коммерческие поля

Что делает поле Предпочтительный тип цен?

Оно задает базовую ценовую опору приложения.

Это особенно важно, если у компании есть:

  • несколько типов цен
  • отдельные розничные и специальные витрины
  • отдельные ценовые сценарии под разные клиентские каналы

Что делает поле Платежный провайдер?

Оно привязывает приложение к конкретному платежному аккаунту компании.

Это важно, если:

  • есть несколько платежных аккаунтов
  • разные витрины должны принимать оплату через разные реквизиты

Можно ли привязать к приложению любой платежный аккаунт?

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

6. Theme и конфигурация

Зачем у приложения несколько конфигураций?

Конфигурации нужны, чтобы хранить разные наборы настроек приложения, прежде всего для:

  • светлой темы
  • темной темы

Также они помогают аккуратно вести разные варианты theme-настроек внутри одного приложения.

Что означает Light и Dark в конфигурации?

Это тема конфигурации:

  • Light - светлая
  • Dark - темная

Клиентская часть умеет использовать эти варианты в зависимости от условий запуска и выбора пользователя.

Что означает Использовать по умолчанию?

Это пометка основного рабочего набора конфигурации.

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

Что такое Макет приложения?

Это общий макет клиентского приложения.

Для обычной рабочей витрины Omnis следует ориентироваться на стандартный default, потому что именно он дает базовую рабочую структуру приложения.

Можно ли вписать в поле Макет любое значение?

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

Где проверять каталог, карточку товара, корзину, оформление заказа и личный кабинет?

В обычной работе ориентируйтесь на реальные CMS-страницы, компоненты и предпросмотр:

  • страницы должны быть созданы в разделе CMS -> Страницы
  • нужные торговые блоки должны быть добавлены через CMS -> Компоненты
  • фактические переходы лучше проверять в Редакторе приложений

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

Что такое цветовая палитра приложения?

Это набор цветовых настроек, которые определяют внешний вид клиентской витрины.

Что такое rootFontSize?

Это базовый масштаб интерфейса. Он влияет на общий размер текста и ряда связанных величин.

Зачем нужны правила для разных дисплеев?

Они позволяют задавать разные theme-значения под разные диапазоны экранов:

  • телефон
  • планшет
  • широкий экран

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

Зачем нужны кастомные свойства?

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

7. Связь с клиентским приложением

Как понять, что настройки из карточки приложения реально попадают в клиентское приложение?

Именно эти настройки используются клиентским приложением для:

  • выбора макета
  • применения цветов
  • применения шрифтов
  • применения размеров и скруглений
  • настройки карт
  • работы аналитики
  • ряда навигационных и визуальных сценариев

Поэтому карточка приложения - это не “описание для менеджера”, а реально рабочий источник клиентских настроек.

Что в клиентском приложении появляется сразу после правильной настройки приложения?

Базово покупатель может получить:

  • структуру витрины
  • навигацию
  • каталог
  • карточку товара
  • корзину
  • оформление заказа
  • личный кабинет
  • контентные страницы

Но итоговый состав экранов зависит от страниц и компонентов, связанных с этим приложением.

8. Удаление приложения

Чем обычное удаление отличается от глубокого?

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

Глубокое удаление запускает намного более жесткий сценарий и может удалить:

  • страницы приложения
  • слоты
  • компоненты, привязанные к слотам
  • корзины приложения
  • списки избранного приложения

Почему глубокое удаление опасно?

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

Когда использовать глубокое удаление?

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

Можно ли считать глубокое удаление обычным способом “почистить старую карточку”?

Нет. Это не бытовое удаление, а тяжелая архитектурная операция.