Быстрый запуск магазина
Пошагово: создать приложение из шаблона, вставить токен бота, включить самовывоз, оформить тестовый заказ.
Этот сценарий соответствует мастеру «Быстрый запуск» в кабинете (раздел «Общее → Обзор»). Демо-песочница с отключённым checkout — не путь к первому заказу; для продаж создавайте боевое приложение из шаблона (не sandbox).
1. Создайте приложение из шаблона
Откройте «Приложения» → «Добавить». По умолчанию предлагается галерея шаблонов (generic shop, fashion, food и др.) с готовым каталогом и меню (каталог + корзина).
Укажите название, выберите шаблон и нажмите «Создать из шаблона». Пустое приложение — запасной вариант, если шаблон не подходит.
После создания кабинет откроет обзор приложения и автоматически запустит мастер быстрого старта (для новых приложений).
2. Вставьте токен бота
В мастере на шаге «Токен бота» вставьте токен Telegram (рекомендуется) или MAX. Сервер проверяет токен через getMe и регистрирует webhook.
Без рабочего ключа канал не считается готовым. Ссылку публикации и QR смотрите в блоке готовности на обзоре или в «Настройки → Платформы».
3. Проверьте каталог и меню
Шаблон уже содержит демо-товары и пункты меню. На шагах «Каталог» и «Меню» мастер сверяется с чеклистом готовности: нужны позиции номенклатуры и пункты меню каталог + корзина (для услуг допустима запись).
При необходимости отредактируйте товары в «Номенклатура» или меню в «Настройки → Меню».
4. Включите самовывоз одним кликом
На шаге «Доставка» нажмите «Включить самовывоз». Создаётся способ «Самовывоз» с оплатой при получении — этого достаточно для soft-launch без подключения СДЭК.
Курьерские службы и тарифы можно настроить позже в модуле логистики.
5. Оплата для теста
Онлайн-эквайринг не обязателен для первого заказа: при самовывозе доступна оплата при получении. Полную настройку провайдеров откройте из мастера или раздела «Оплата», когда будете готовы принимать карты.
6. Тестовый заказ и celebration
Откройте витрину (ссылка из мастера или блока публикации). Оформите заказ на себя. Пока открыт шаг, кабинет периодически опрашивает число заказов; можно нажать «Я оформил тест».
После фиксации тестового заказа мастер покажет celebration: ссылка для клиентов, приглашение и CTA углубить оплату / доставку / AI.
Заказы владельца и сотрудников считаются тестовыми. North-star метрика — первый заказ реального покупателя — учитывается отдельно.
Готовность: soft-launch и «готов к продаже»
На обзоре два сигнала. Soft-launch (быстрый путь) — каталог, меню, канал, доставка и допустимая схема оплаты (в т.ч. COD). «Готов к продаже» (ready_to_sell) — прежний полный чеклист, включая реквизиты и онлайн-оплату; его семантика не менялась.
Блок «Следующий шаг» на обзоре всегда показывает один следующий action из API активации.
Полная настройка после запуска
Кнопка «Полная настройка» открывает расширенный мастер (домен, юрлицо, офисы, платформы, оплата, доставка). Используйте его, когда магазин уже принимает тестовые заказы и нужно довести продакшен-чеклист.
Частые вопросы
- Почему не открывается checkout в демо?Витрины с commerce_mode=demo специально блокируют заказ. Создайте боевое приложение из шаблона без sandbox.
- Токен сохранён, но канал «не готов»Нужны успешный getMe и синхронизация webhook. Подождите несколько секунд и обновите обзор; проверьте токен в @BotFather.
- Как отключить шаблонный create?Переменная окружения NEXT_PUBLIC_GUIDED_ACTIVATION=0 возвращает прежний диалог пустого создания (для отката).