Пошаговые сценарии по разделу Приложения

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

Этот документ нужен для практической работы. Здесь собраны типовые сценарии в формате:

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

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

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

  • быстро провести сотрудника по рабочему сценарию шаг за шагом
  • использовать готовый маршрут для запуска нового Mini App или Max App
  • стандартизировать работу менеджера или владельца при настройке приложений

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

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

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

1. Как создать первое приложение компании через Конструктор приложений

Используйте этот сценарий, если:

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

Шаги

  1. Откройте Управление -> CMS -> Конструктор приложений.
  2. На первом шаге укажите Название приложения.
  3. Оставьте тип Mini-app.
  4. Перейдите к шагу с приветствием и при необходимости задайте Приветственное сообщение.
  5. Если есть логотип, загрузите его.
  6. На Telegram-шаге заполните:
    • TG-bot user-name
    • TG-bot token
  7. Дождитесь, пока система проверит токен.
  8. На шаге интеграций при необходимости заполните:
    • ID счетчика Яндекс.Метрики
    • API ключ карт
    • API ключ подсказок
    • Secret подсказок
  9. Выберите стартовые наборы:
    • цветов
    • шрифтов
    • размеров
    • скруглений
  10. На итоговом шаге проверьте все параметры.
  11. Запустите создание приложения.
  12. Дождитесь завершения генерации.

Что проверить после создания

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

Результат

Компания получает стартовое приложение, с которым уже можно продолжать работу в Приложениях, Страницах, Компонентах и Редакторе приложений.

Создание приложения через конструктор
На скриншоте: мастер Конструктор приложений на одном из шагов создания нового Mini App.

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

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

Шаги

  1. Откройте Управление -> CMS -> Приложения.
  2. Найдите приложение по названию или коду.
  3. Откройте карточку приложения.
  4. Проверьте:
    • Наименование
    • Активировано
    • TG-bot user-name
    • TG-bot token
  5. Проверьте Предпочтительный тип цен.
  6. При необходимости выберите Платежный провайдер.
  7. Проверьте Приветствие.
  8. Проверьте ID счетчика Яндекс.Метрики.
  9. Проверьте ключ карт и ключи подсказок.
  10. Сохраните изменения.

На что обратить внимание

  • Telegram-данные должны относиться именно к нужному боту
  • платежный аккаунт должен принадлежать вашей компании
  • карточка должна быть активна только если вы действительно хотите считать это приложение рабочим

Результат

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

3. Как настроить светлую и темную тему приложения

Используйте этот сценарий, если:

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

Шаги

  1. Откройте карточку приложения.
  2. Перейдите в блок Конфигурация.
  3. Откройте вкладку нужной конфигурации.
  4. Проверьте, что у конфигурации задан правильный вариант:
    • Light
    • Dark
  5. При необходимости нажмите:
    • Цвета
    • Шрифты
    • Размеры
    • Скругления
  6. Примените нужные готовые наборы.
  7. Ручно скорректируйте:
    • палитру
    • отступы
    • размеры шрифта
    • семейства шрифтов
  8. Проверьте rootFontSize.
  9. При необходимости настройте правила для разных дисплеев.
  10. Сохраните приложение.

Что проверить после сохранения

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

Результат

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

4. Как связать приложение с платежным аккаунтом

Используйте этот сценарий, если:

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

Шаги

  1. Откройте карточку приложения.
  2. Найдите поле Платежный провайдер.
  3. Откройте выбор платежного аккаунта.
  4. Выберите нужный аккаунт компании.
  5. Сохраните карточку приложения.
  6. После сохранения дополнительно проверьте платежный сценарий в витрине.

На что обратить внимание

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

Результат

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

5. Как переключить приложение на другой Telegram-бот

Используйте этот сценарий, если:

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

Шаги

  1. Откройте карточку приложения.
  2. Замените TG-bot user-name.
  3. Замените TG-bot token.
  4. Сохраните карточку.
  5. Подождите, пока система обновит Telegram-связку приложения.
  6. Проверьте запуск приложения через нового бота.
  7. Убедитесь, что старая Telegram-привязка больше не используется в рабочих инструкциях команды.

Что проверить после смены

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

Важно

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

6. Как подготовить приложение к проверке в Редакторе приложений

Используйте этот сценарий, когда приложение уже создано, и теперь нужно перейти к живой визуальной проверке.

Шаги

  1. Откройте карточку приложения.
  2. Проверьте, что:
    • приложение сохранено
    • у него корректные theme-настройки
    • выбрана рабочая конфигурация
  3. Убедитесь, что есть связанные CMS-страницы.
  4. Перейдите в Управление -> CMS -> Редактор приложений.
  5. Выберите нужное приложение.
  6. Включите предпросмотр.
  7. Проверьте, как тема, макет и контент выглядят в живом предпросмотре.

Результат

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

7. Как безопасно подготовить приложение к запуску в Telegram

Используйте этот сценарий перед тем, как считать витрину готовой к работе с клиентами.

Шаги

  1. Откройте карточку приложения.
  2. Проверьте активность приложения.
  3. Проверьте Telegram-данные.
  4. Проверьте Предпочтительный тип цен.
  5. Проверьте Платежный провайдер.
  6. Проверьте Макет.
  7. Убедитесь, что есть как минимум нужные рабочие страницы:
    • главная
    • каталог
    • товар
    • корзина
    • оформление заказа
    • профиль
  8. Проверьте приложение в Редакторе приложений.
  9. Проверьте фактический запуск через Telegram-бота.
  10. Убедитесь, что команда использует правильную ссылку и правильного бота.

Что считать успешным результатом

  • приложение открывается
  • theme выглядит корректно
  • маршруты работают
  • каталог и карточка товара доступны
  • корзина и оформление заказа не ломаются
  • команда понимает, какое приложение теперь рабочее
Проверка готовности приложения к запуску
На скриншоте: редактор приложений на этапе финальной проверки перед запуском.

8. Как безопасно удалить ненужное приложение обычным удалением

Используйте этот сценарий, если:

  • приложение больше не нужно
  • полная зачистка зависимых CMS-сущностей не требуется
  • вы хотите удалить именно запись приложения, а не весь исторический след вокруг него

Шаги

  1. Откройте карточку приложения.
  2. Еще раз проверьте, что выбрано именно нужное приложение.
  3. Убедитесь, что это не рабочая боевая витрина.
  4. Нажмите Удалить.
  5. Подтвердите удаление.
  6. Проверьте, что запись исчезла из каталога приложений.

Что важно

Если есть сомнение, лучше сначала деактивировать приложение и только потом принимать решение об удалении.

9. Как подготовиться к глубокому удалению приложения

Используйте этот сценарий только если действительно нужно полностью убрать приложение и весь его связанный след.

Шаги

  1. Откройте карточку приложения.
  2. Убедитесь, что приложение точно больше не нужно бизнесу.
  3. Проверьте, не используются ли его компоненты в других приложениях компании.
  4. Проверьте, нет ли живых корзин и избранного, которые для вас еще важны.
  5. Убедитесь, что команда понимает последствия.
  6. Только после этого нажмите Глубокое удаление.
  7. Подтвердите действие.

Что важно

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

Результат

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