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

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

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

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

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

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

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

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

Шаги

Откройте Управление -> CMS -> Конструктор приложений.
На первом шаге введите Название приложения.
Оставьте тип Mini-app.
Нажмите Далее.
На втором шаге заполните Приветственное сообщение.
При наличии загрузите Логотип приложения.
Перейдите к шагу Telegram-настройки.
Заполните:
- TG-bot user-name
- TG-bot token
Дождитесь, пока система примет введенные данные.
На шаге дополнительных сервисов при необходимости заполните:
- ID счетчика Яндекс.Метрики
- API ключ Яндекс.Карт
- API ключ подсказок Dadata
- Секретный ключ подсказок Dadata
Если эти сервисы пока не нужны, оставьте шаг пустым и перейдите дальше.
Выберите цветовую схему.
Выберите набор шрифтов.
Выберите размерный набор.
Выберите набор скруглений.
На итоговом шаге еще раз проверьте все параметры.
Нажмите Создать.
Дождитесь завершения генерации.

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

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

Результат

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

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

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

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

Шаги

Откройте Конструктор приложений.
Заполните название и создайте приложение на первом шаге.
Укажите приветственное сообщение.
При необходимости загрузите логотип.
Укажите Telegram-бота:
- имя бота
- токен
На шаге дополнительных сервисов ничего не заполняйте.
Перейдите дальше.
Выберите базовый визуальный стиль.
Проверьте итоговую сводку.
Нажмите Создать.

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

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

Результат

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

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

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

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

Шаги

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

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

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

Результат

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

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

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

Шаги

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

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

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

Результат

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

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

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

Шаги

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

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

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

Результат

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

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

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

Шаги

На экране успешного создания внимательно посмотрите финальные шаги.
Откройте BotFather.
Перейдите в раздел Mini Apps.
Найдите настройки Menu Button.
Вставьте ссылку запуска приложения.
Затем настройте Main App.
Вставьте ту же ссылку запуска.
Убедитесь, что оба режима включены.
Найдите бота через поиск Telegram.
Откройте диалог с ботом.
Проверьте запуск приложения из диалога.
Проверьте запуск кнопкой быстрого доступа, если она используется.

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

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

Результат

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