FAQ по разделу Приложения
Для кого и когда нужен этот документ
Вопросы сгруппированы по задачам основных пользователей:
- владельца компании
- менеджера
- контент-менеджера
- маркетолога
- сотрудника, который отвечает за запуск Telegram Mini App или Max App
Связанные документы по разделу:
Этот документ можно использовать как быстрый справочник, когда не нужно перечитывать всю большую инструкцию по разделу, а нужно быстро понять конкретное правило, поле или действие.
Открывайте этот документ, если нужно:
- быстро понять смысл поля в карточке приложения
- объяснить сотруднику разницу между приложением, страницей и компонентом
- быстро разобраться, что меняет Telegram-настройка, тема, платежный аккаунт или удаление приложения
Если нужен полный обзор раздела, вернитесь к:
Если нужен пошаговый рабочий маршрут, открывайте:
Если нужно разобрать проблему, ошибку или блокировку, открывайте:
1. Общие вопросы по разделу
Что такое приложение в CMS Omniz?
Приложение - это верхний контейнер всей клиентской витрины. Именно оно объединяет:
- страницы
- слоты
- компоненты
- торговые сценарии каталога, корзины и оформления заказа
- theme-настройки
- Telegram-интеграцию
- платежную привязку
Если говорить просто, приложение - это основа готового клиентского продукта, который потом видит покупатель.
Чем приложение отличается от страницы?
Приложение - это вся витрина целиком.
Страница - это один конкретный экран внутри этой витрины, например:
- главная
- каталог
- карточка товара
- корзина
- личный кабинет
Чем приложение отличается от компонента?
Приложение задает общую среду работы витрины.
Компонент - это один отдельный UI-блок внутри страницы, например:
- баннер
- меню
- карусель товаров
- карта
- блок оформления заказа
Можно ли работать только в разделе Приложения и не заходить в Страницы и Компоненты?
Нет, если задача не ограничивается только базовой настройкой карточки приложения.
Раздел Приложения нужен для основы:
- Telegram
- платежи
- theme
- макет
- базовые настройки витрины
А уже Страницы и Компоненты отвечают за конкретное содержимое витрины.
Какой тип приложения использовать в обычной работе?
В текущем рабочем сценарии Omniz основной тип - 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-настройки синхронизируются автоматически.
Что означает светлая и темная тема в конфигурации?
Это тема конфигурации:
- светлая используется для светлого оформления
- темная используется для темного оформления
- переключатель Тема включена позволяет временно исключить одну из них из клиентского приложения
Выключить обе темы одновременно нельзя. Если активна только одна тема, приложение принудительно использует ее и не показывает пользователю переключатель темы.
Что означает Использовать по умолчанию?
Это пометка основного рабочего набора конфигурации.
Если включить эту пометку в одной теме, в другой она выключится автоматически. Когда активной остается только одна тема, она автоматически становится основной.
Что такое Макет приложения?
Это общий макет клиентского приложения.
Для обычной рабочей витрины Omniz следует ориентироваться на стандартный default, потому что именно он дает базовую рабочую структуру приложения.
Можно ли выбрать другой Макет?
Сейчас нет: выбранный radio-вариант default недоступен для изменения, потому что других макетов пока нет.
Где проверять каталог, карточку товара, корзину, оформление заказа и личный кабинет?
В обычной работе ориентируйтесь на реальные CMS-страницы, компоненты и предпросмотр:
- страницы должны быть созданы в подразделе Страницы раздела CMS
- нужные торговые блоки должны быть добавлены в подразделе Компоненты раздела CMS
- фактические переходы лучше проверять в Редакторе приложений
Если сценарий ведет не туда или выглядит неполным, сначала проверьте страницы и компоненты приложения.
Что такое цветовая палитра приложения?
Это набор цветовых настроек, которые определяют внешний вид клиентской витрины.
Что такое rootFontSize?
Это базовый масштаб интерфейса. Он влияет на общий размер текста и ряда связанных величин.
Зачем нужны правила для разных дисплеев?
Они позволяют задавать разные theme-значения под разные диапазоны экранов:
- телефон
- планшет
- широкий экран
Это особенно важно для аккуратной адаптации приложения под разные устройства.
Зачем нужны кастомные свойства?
Они нужны для пользовательских переменных, которые команда хочет переиспользовать внутри приложения и в отдельных компонентах.
7. Связь с клиентским приложением
Как понять, что настройки из карточки приложения реально попадают в клиентское приложение?
Именно эти настройки используются клиентским приложением для:
- выбора макета
- применения цветов
- применения шрифтов
- применения размеров и скруглений
- настройки карт
- работы аналитики
- ряда навигационных и визуальных сценариев
Поэтому карточка приложения - это не “описание для менеджера”, а реально рабочий источник клиентских настроек.
Что в клиентском приложении появляется сразу после правильной настройки приложения?
Базово покупатель может получить:
- структуру витрины
- навигацию
- каталог
- карточку товара
- корзину
- оформление заказа
- личный кабинет
- контентные страницы
Но итоговый состав экранов зависит от страниц и компонентов, связанных с этим приложением.
8. Удаление приложения
Чем обычное удаление отличается от глубокого?
Обычное удаление удаляет саму запись приложения и ее базовую связку.
Глубокое удаление запускает намного более жесткий сценарий и может удалить:
- страницы приложения
- слоты
- компоненты, привязанные к слотам
- корзины приложения
- списки избранного приложения
Клиенты приложения не удаляются: система отвязывает их от приложения и добавляет в карточку клиента заметку с названием, кодом и ID удаленного приложения.
Почему глубокое удаление опасно?
Потому что компоненты могут использоваться не только в одном приложении. Если удалить их глубоко вместе с одним приложением, это может затронуть и другие витрины компании.
Когда использовать глубокое удаление?
Только когда вы точно уверены, что приложение нужно полностью снять с эксплуатации вместе со всем связанным следом.
Можно ли считать глубокое удаление обычным способом “почистить старую карточку”?
Нет. Это не бытовое удаление, а тяжелая архитектурная операция.