После создания мини-приложения «Программа лояльности» (см. Создайте программу лояльности в мини-приложении) все его параметры настраиваются на одной странице карточки — без перехода в отдельные вкладки. Ниже подробно разобрана каждая группа настроек.
Как открыть карточку настроек
Откройте раздел Маркетинг → Мини-приложения в левом меню Fasttrack и нажмите на нужное приложение в списке — откроется карточка с формой настроек.
В правом верхнем углу карточки — три кнопки:
| Кнопка | Действие |
|---|---|
| Отменить | сбрасывает несохранённые изменения |
| Скопировать ссылку | копирует прямую ссылку на мини-приложение, которую будем далее использовать в боте |
| Сохранить | становится активной после любого изменения и применяет настройки |
Основные параметры
- Название — понятное системное имя мини-приложения; отображается в списке «Мини-приложения» и в хлебных крошках карточки.
- Приложение активно — переключатель, включает и выключает показ мини-приложения клиентам. Если выключить — ссылка на приложение перестанет открываться.
- Тестовый режим — позволяет проверять настройки на реальных данных, не публикуя изменения для всех пользователей.
- Интеграция (обязательное поле) — сервис, который хранит данные о клиенте и его бонусах (например, Mindbox). От выбранной интеграции зависят некоторые поля ниже — в частности блок «Баланс бонусов Mindbox».
Сценарии чат-бота
Выпадающие списки с выбором сценария для следующий кейсов:
| Поле | Когда срабатывает |
|---|---|
| Сценарий чата с оператором | клиент просит оператора |
| Сценарий, не участник программы лояльности | пользователь ещё не зарегистрирован в программе (например, ведёт в сценарий «Зарегистрироваться») |
| Сценарий, нет номера телефона | у клиента не определён номер телефона (например, ведёт в сценарий «Запрос номера телефона») |
Необязательные поля
Если поле оставить пустым, соответствующая ситуация не будет обрабатываться отдельным сценарием.
Название валюты — текстовое поле, определяющее, как бонусные баллы будут называться в интерфейсе клиента (например, «Балл» или «Бонус»). Значение подставляется во все тексты и экраны мини-приложения, где упоминаются баллы.
Внешний вид
Блоки — поле множественного выбора: щёлкните по нему, чтобы открыть список доступных экранов, и отметьте нужные — выбранные варианты отображаются тегами, которые можно убрать крестиком.
| Код блока | Что показывает |
|---|---|
AVAILABLE_BALANCE | экран с доступным балансом бонусов |
QR_CODE | экран с QR-кодом карты лояльности |
BONUS_HISTORY | история начисления и списания баллов |
EXPIRATION_BALANCE | информация о сроке сгорания баллов |
QR_CODE_INSTRUCTION | инструкция для клиента по использованию QR-кода |
CHAT_DEEPLINK | кнопка-диплинк, возвращающая клиента обратно в чат с ботом |
RULES | текст с правилами участия в программе лояльности (то же значение, что задано в поле «Правила участия») |
URLS | блок с произвольными ссылками, добавленными через «+ Добавить ссылку» |
- Цвет приложения и Цвет текста — задаются в формате HEX (например,
#FFFFFFдля фона и#000000для текста); рядом с полем отображается цветной кружок — превью выбранного цвета. Значения можно ввести вручную или взять из брендбука компании. - Логотип — над кнопками отображается превью текущего изображения. Кнопка «Загрузить логотип» открывает окно выбора файла с компьютера (рекомендуется квадратное изображение), а «Сбросить» возвращает логотип по умолчанию.
- + Добавить ссылку — разворачивающийся блок: после нажатия появляются поля для названия ссылки и URL. Так можно добавить, например, ссылку на сайт магазина или на страницу с условиями акции — она появится дополнительным пунктом в мини-приложении.
Статусы заказов
Список пар «код статуса → название для клиента»: в левом поле указывается технический код статуса заказа, который приходит из внешней системы, а в правом — понятное название, которое увидит клиент в истории заказов мини-приложения.
Например, это может выглядеть так:
| Код (внешний) | Название для клиента |
|---|---|
Sent | Отправлен |
done | Выполнен |
order | Оформлен |
Assembly | Собран |
Canceled | Отменён |
AwaitingPayment | Ожидает оплаты |
- Чтобы удалить пару статусов, нажмите на значок корзины справа от неё.
- Чтобы добавить новую пару, нажмите «+ Внешние статусы (ID)» под списком — появится новая строка с пустыми полями для кода и названия.
Правила участия и идентификация клиента
- Правила участия — поле, в котором указывается название текста с условиями программы лояльности; этот текст клиент сможет открыть внутри мини-приложения.
- Тип QR кода — выпадающий список с двумя вариантами: «Статичный» (у клиента всегда один и тот же код, например номер карты) и «Динамический» (код формируется заново по заданному правилу при каждом показе, что повышает защиту от подделки). От выбора здесь зависит, какие поля появятся в разделе «Настройка QR- и штрих-кода» ниже.
- ID заказа — название параметра, по которому система сопоставляет заказ во внешнем сервисе с заказом клиента в мини-приложении.
- Набор правил идентификации клиента — поле множественного выбора: отметьте, по каким данным система будет запрашивать и проверять личность клиента, например «Имя», «Дата рождения», «Email». Выбранные пункты отображаются тегами, которые можно убрать крестиком. Соотвественно, в случае, если в Mindbox одно из выбранных полей не заполнено, то пользователь отправится в сценарий, который был указан в пункте «Сценарий, не участник программы лоальности»
Интеграция с Mindbox (кастомные операции)
Когда появляется
Блок «+ Баланс бонусов Mindbox» — сворачиваемый раздел, который появляется, только если в «Основных параметрах» выбрана интеграция Mindbox.
Блок «+ Баланс бонусов Mindbox» позволяет выбрать дополнительный бонусный счёт, с которого нужно выводить бонусы в мини-приложении. По умолчанию баланс и история показываются с основного бонусного счёта клиента — этот блок нужен только тогда, когда бонусы для мини-приложения нужно брать с какого-то другого счёта.
Разверните блок нажатием на «+», чтобы увидеть подраздел «Кастомные операции»:
| Поле | Назначение |
|---|---|
| Баланс | метод API Mindbox, возвращающий баланс клиента |
| История бонусов | метод, возвращающий историю бонусов клиента |
| Заказы | метод для получения списка заказов клиента |
| Персональные предложения | метод для получения персональных рекомендаций |
| QR/BAR код | метод для генерации кода карты лояльности |
Поля можно оставить пустыми
Значения, которые видны в полях (ft.GetCustomer, ft.GetCustomerOrders, ft.GetCustomerRecommendations, ft.GenerateLoyaltyCode) — это не готовые значения, а операции по умолчанию, показанные как подсказка. Если оставить поле пустым, будет использована именно эта операция. Заполнять поле нужно, только если хотите использовать другую, отличную от стандартной операцию — тогда в личном кабинете Mindbox должна быть настроена операция именно с тем названием, которое вы укажете здесь.
Отображать описание к истории бонусных баллов — переключатель: если он включён, в историей начислений в мини-приложении дополнительно показывается пояснительный текст для клиента.
Настройка QR- и штрих-кода
- Тип кода — выпадающий список: «QR код» или «Штрих-код» — определяет, какое изображение будет показано клиенту на экране карты.
- Значение статичного qr-кода — поле доступно, если в «Типе QR кода» выбран «Статичный»; выпадающий список определяет, какие данные зашифрованы в коде, например «Номер карты».
- Идентификатор карты программы лояльности для QR-кода — текстовое поле, максимальная длина значения — 128 символов; заполняется, если формат кода требует отдельного идентификатора карты.
- Разделитель от пользователя для сигнатуры qr-кода и Правило составления сигнатуры динамического qr-кода — актуальны, если в «Типе QR кода» выбран «Динамический»: разделитель частей данных и готовый алгоритм формирования подписи (сигнатуры) кода соответственно.
- Описание, QR Code — текстовое поле с подсказкой для клиента о том, как использовать код (например, «Покажите этот код кассиру при оплате»); текст показывается на экране
QR_CODE_INSTRUCTION.
Внутреннее описание
Поле «Описание» не показывается клиенту и используется только командой для внутренних заметок о приложении — например, для указания цели создания мини-приложения или ответственного за его настройку.
Сохранение изменений
Кнопки управления находятся в правом верхнем углу карточки:
- Сохранить — становится активной, как только изменено хотя бы одно поле, и применяет все внесённые настройки.
- Отменить — отменяет несохранённые изменения и возвращает форму к последнему сохранённому состоянию.
- Скопировать ссылку — копирует прямую ссылку на мини-приложение, которую будем далее использовать в боте
Как вызвать мини-приложение из бота
Чтобы клиент мог открыть мини-приложение прямо из чата, добавьте в нужном месте сценария бота инлайн-кнопку со следующими настройками:
| Поле | Значение |
|---|---|
| Название | например, Моя карта |
| Тип действия | Ссылка |
| Адрес | ссылка на мини-приложение, скопированная кнопкой «Скопировать ссылку» |
| Открывать в WebApp | ✅ включено |
Зачем нужен переключатель «Открывать в WebApp»
Если эту опцию не включить, ссылка откроется во внешнем браузере, а не внутри мессенджера — мини-приложение при этом не будет выглядеть частью чат-бота.
Результат
Подробнее про создание самого мини-приложения — в статье Создайте программу лояльности в мини-приложении.