Шаги установки готового решения

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

Не используйте этот блок для действий, которые нужны только при переходе уже установленного готового решения на новый выпуск. Для них существуют отдельные шаги обновления.

Перед началом

• шаги доступны для готового решения с созданным исходным проектом;
• создавать, менять и удалять шаги можно только в черновике версии;
• новый черновик уже содержит шаги установки последней опубликованной версии;
• нужны права на управление версиями готового решения;
• для шагов с агентом сначала выберите тип «Агент» в поле типа ресурса, откройте выбор ресурса, при необходимости используйте поиск, выберите нужного агента и нажмите «Добавить ресурс»;
• удаление агента из ресурсов версии делает его недоступным для новых шагов. Если агент уже используется шагом, сначала измените или удалите этот шаг.

Если версия уже опубликована, создайте новый черновик и вносите изменения в нём. Для автоматического обновления набор шагов должен полностью совпадать с предыдущей опубликованной версией: нельзя добавлять, менять, переставлять или удалять шаги. Если шаги должны измениться, выберите для версии режим «После подтверждения».

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

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

Типы шагов

• Заполнить переменные проекта. Просит пользователя указать значения переменных проекта, которые нужны готовому решению.
• Назначить агента по умолчанию. Создаёт или заменяет правило автоматического назначения для выбранного слота агента и области диалогов. Во время настройки можно задать отдельные правила для каналов.
• Назначить агента в диалогах. Просит выбрать диалог и назначает в него указанного агента как основного или фонового. Если этот слот уже занят, прежнее назначение в нём заменяется.
• Ссылки для подписки. Показывает готовые ссылки на прямую подписку или лендинг для ресурсов, установленных вместе с готовым решением. Если в проекте несколько подходящих каналов, пользователь выбирает нужный.
• Произвольная инструкция. Показывает текст, который пользователь должен прочитать и подтвердить. Такой шаг можно пропустить, поэтому переключатель «Обязательно» для него не показывается.

Общие поля шага

Сначала выберите нужный вариант в поле «Тип шага», затем заполните общие поля:

1. На вкладке «Русский» заполните заголовок и описание. Опишите результат действия, а не внутреннее устройство готового решения.
2. Перейдите на вкладку English и заполните английский заголовок и описание.
3. Для всех типов, кроме «Произвольной инструкции», включите «Обязательно», если без этого действия готовое решение не сможет работать правильно.

Шаги с агентом

Для «Назначить агента по умолчанию» и «Назначить агента в диалогах» обязательно укажите:

• слот агента: основной отвечает пользователю, фоновый выполняет вспомогательную работу;
• агента из текущей версии; его можно найти через поиск и выбрать в списке результатов.

Варианта «Без агента» у этих шагов нет. Если список пуст, вернитесь к версии и добавьте агента исходного проекта в ресурсы этой версии. Перед публикацией версии опубликуйте черновик изменённого агента.

Для «Назначить агента по умолчанию» дополнительно выберите область диалогов: все, личные или групповые. Область определяет, в каких диалогах действует правило автоматического назначения.

Шаг «Заполнить переменные»

Нажмите «Добавить переменную». Настройки откроются в отдельном окне. После добавления переменная появится в списке шага; кнопка с карандашом снова открывает её для изменения. В шаге должна быть хотя бы одна переменная.

Для каждой переменной настройте:

• «Имя переменной проекта»: переменная с таким именем уже должна существовать в исходном проекте этого готового решения;
• на вкладке «Русский» — название и подсказку для пользователя;
• на вкладке English — английское название и подсказку;
• пример значения, соответствующий типу и ограничениям переменной;
• обязательность поля при установке.

Нажмите «Добавить переменную» внизу окна, чтобы перенести её в список шага. Одну и ту же переменную проекта нельзя добавить в шаг дважды. Ненужное поле удаляется кнопкой удаления переменной в списке.

Шаг «Ссылки для подписки»

В блоке ссылок добавьте хотя бы одну ссылку через «Добавить ссылку». В одном окне настройки можно отметить одно или оба назначения и сразу подготовить несколько ссылок:

• отметьте «Прямую подписку», «Лендинг» или оба назначения;
• для каждого назначения выберите сегмент или лендинг текущей версии;
• отметьте один или несколько каналов: ВКонтакте, Telegram или MAX; для лендинга также доступна обычная ссылка на сайт;
• внутри каждого канала отметьте один или несколько способов открытия. Набор вариантов зависит от назначения и канала: например, Telegram-бот, Telegram Mini App, приложение ВКонтакте или обычный лендинг.

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

При установке Senler формирует адреса для ресурсов, созданных этим готовым решением. Если подходящих каналов несколько, пользователь выбирает конкретный канал. Недоступная ссылка показывает точную причину и, когда возможно, действие «Настроить». Завершить этот шаг можно после того, как доступна хотя бы одна ссылка.

Сохранение и удаление

После настройки нажмите «Сохранить шаг». В существующем черновом шаге доступна кнопка удаления шага.

Если шаг не сохраняется

• убедитесь, что редактируете черновик версии;
• если выбран автоматический режим, верните шаги к предыдущей опубликованной версии или переключите версию на «После подтверждения»;
• если требуется исходный проект, создайте его в настройках готового решения;
• для шага с агентом проверьте, что агент добавлен как ресурс именно в текущую версию;
• для «Заполнить переменные» добавьте хотя бы одно поле, уберите повторы и проверьте имена переменных исходного проекта;
• для «Ссылок для подписки» добавьте хотя бы одну уникальную ссылку, проверьте, что ресурс входит в текущую версию и соответствует выбранному назначению;
• если пример значения не принимается, введите значение того же типа и формата, что и у выбранной переменной;
• если нет кнопок сохранения или поля недоступны, проверьте своё право на управление версиями готового решения.

Доступ к диалогам при первой установке

Для готового решения переключатель доступа разработчика к связанным диалогам появляется автоматически и при установке включён по умолчанию. Владелец устанавливающего проекта может выключить его до установки или позже на странице установленного готового решения; автор готового решения не управляет этим выбором. Это не полный доступ к проекту: разработчик увидит только диалоги, в которых участвовали агенты этого готового решения.