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

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

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

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

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

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

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

Типы шагов

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

Нужный вариант выбирается в поле «Тип шага».

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

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

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

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

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

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

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

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

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

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

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

Нельзя добавить одну и ту же пару «Цель переменной» + «Имя переменной» дважды. Ненужное поле удаляется кнопкой удаления переменной.

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

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

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

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

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

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