Team8

Пошаговые сценарии по разделу Конструктор приложений

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

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

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

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

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

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

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

Шаги

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

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

  • приложение появилось в подразделе Приложения раздела CMS
  • в подразделе Страницы раздела CMS появились стартовые экраны
  • в подразделе Компоненты раздела CMS появились стартовые блоки
  • мастер показал финальные шаги для запуска в подключённых мессенджерах

Результат

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

2. Как создать базовую версию приложения без дополнительных сервисов

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

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

Шаги

  1. Откройте Конструктор приложений.
  2. Заполните название и создайте приложение на первом шаге.
  3. Укажите приветственное сообщение.
  4. При необходимости загрузите логотип.
  5. Укажите Telegram-бота или MAX-бота:
    • имя бота
    • токен
  6. На шаге дополнительных сервисов ничего не заполняйте.
  7. Перейдите дальше.
  8. Выберите базовый визуальный стиль.
  9. Проверьте итоговую сводку.
  10. Нажмите Создать.

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

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

Результат

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

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

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

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

Шаги

  1. Пройдите первые три шага мастера.
  2. На шаге дополнительных сервисов заполните:
    • API ключ подсказок Dadata
    • Секретный ключ подсказок Dadata
  3. Убедитесь, что оба поля заполнены вместе.
  4. При необходимости также заполните API ключ Яндекс.Карт.
  5. Перейдите к шагам выбора внешнего вида.
  6. Проверьте итоговые данные и завершите создание.
  7. После генерации откройте приложение и отдельно проверьте оформление заказа.

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

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

Результат

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

4. Как проверить, что конструктор создал все нужные страницы

Используйте этот сценарий сразу после завершения мастера.

Шаги

  1. После завершения мастера в разделе Управление откройте CMS, затем Страницы.
  2. Найдите страницы по названию приложения или по коду.
  3. Проверьте, что появились основные экраны:
    • главная
    • каталог
    • карточка товара
    • корзина
    • оформление заказа
    • личный кабинет
  4. Проверьте, что появились информационные страницы:
    • доставка
    • самовывоз
    • оплата
    • возврат
    • о нас
    • акции
    • документы
    • прайс-лист
  5. Проверьте, что есть базовая страница с общими элементами.

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

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

Результат

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

5. Как заменить тестовый контент перед запуском

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

Шаги

  1. Откройте созданное приложение.
  2. Перейдите в Страницы и Компоненты.
  3. Проверьте главную страницу.
  4. Замените:
    • тестовые баннеры
    • демонстрационные тексты
    • временные документы
    • стартовый прайс-лист, если он не подходит
  5. Проверьте меню и ссылки.
  6. Откройте информационные страницы и перепишите их под реальную компанию.
  7. Если в каталоге появились реальные товары, проверьте товарные карусели.

Что особенно важно не забыть

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

Результат

Стартовая заготовка превращается в нормальную рабочую витрину компании.

6. Как завершить запуск приложения через Telegram после генерации

Используйте этот сценарий после успешного завершения мастера.

Шаги

  1. На экране успешного создания внимательно посмотрите финальные шаги.
  2. Откройте BotFather.
  3. Перейдите в раздел Mini Apps.
  4. Найдите настройки Menu Button.
  5. Вставьте ссылку запуска приложения.
  6. Затем настройте Main App.
  7. Вставьте ту же ссылку запуска.
  8. Убедитесь, что оба режима включены.
  9. Найдите бота через поиск Telegram.
  10. Откройте диалог с ботом.
  11. Проверьте запуск приложения из диалога.
  12. Проверьте запуск кнопкой быстрого доступа, если она используется.

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

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

Результат

Приложение подготовлено к запуску через Telegram.

Как завершить запуск в MAX

  1. Создайте и опубликуйте MAX-бота, перенесите токен и никнейм в шаг Мессенджеры.
  2. После генерации укажите общую HTTPS-ссылку витрины в настройках мини-приложения MAX-бота.
  3. Найдите бота по никнейму или откройте его ссылку из мастера.
  4. Нажмите Начать, затем Открыть и проверьте каталог и оформление заказа. Изображения инструкции можно открыть в полном размере.