Основы работы с конструктором сценариев
Данная инструкция поможет вам разобраться в процессе создания схемы сценария с помощью конструктора сценариев в VK CXhub.
1. Сценарии состоят из шагов
Сценарий — это логическая схема всех взаимодействий с пользователями: чат-боты, Email- и SMS-рассылки, рассылки в мессенджеры, передача данных между внешними системами и VK CXhub.
Шаг сценария — это элемент схемы конструктора сценариев, это могут быть действия клиентов, запросы к внешним системам, триггеры из внешних систем, фильтры, перевод на другой шаг и так далее. Подробное описание всех шагов конструктора сценариев описано в статье «Элементы конструктора сценариев», в ней мы подробно описали все доступные группы шагов и действия для внешних систем, как они используются и как их найти в конструкторе.
2. Прохождение сценария линейно
- В рамках одного сценария клиент может находиться только на одном шаге в конкретный момент времени.
- Шаги проходятся клиентом последовательно согласно заложенной в сценарии логике.
- Если в сценарии используются шаги с несколькими кнопками, то при нажатии на одну из кнопок клиент пойдет по ветке, соответствующей данной кнопке. Как и в случае, если в сценарии используется группа шагов «Одно из событий», одновременного срабатывания нескольких путей не произойдет. Клиент попадет на ту ветку, какое-то из событий произойдет раньше.
- Добавить стартовый шаг — шаг, с которого начинается сценарий. Это может быть сообщение клиента, условие запуска по расписанию, вебхук, запрос из внешней системы.
Если вы создаете пустой сценарий с нуля, нажмите плюсик на самом стартовом шаге:
- Добавить шаг
Наведите на шаг, после которого нужно добавить новый. Нажмите на синий плюсик и выберите шаг из меню.
- Добавить шаг с условием в группу фильтров
Если у вас уже есть один фильтр, и вам необходимо добавить дополнительный шаг с фильтром в эту же группу, наведите на шаг с фильтром и нажмите на плюсик сверху или снизу фильтра в зависимости от того, куда вы хотите добавить дополнительное условие в схеме сценария.
Также вы можете менять порядок шагов с фильтрами в рамках группы. Для этого нажатием правой кнопки мыши вызовите контекстное меню и выберите пункт «Понизить приоритет фильтра» или «Повысить приоритет фильтра»:
Если вам необходимо переместить фильтр, вызовите контекстное меню и выберите пункт «Переместить ветку». Далее укажите шаг, после которого необходимо поставить перемещаемый шаг с фильтром.
Пример перемещения шага 4.1 после шага 2:
- Заменить стартовый шаг
Если вы используете готовый шаблон сценария, где уже выбран стартовый шаг, или вы уже ранее в своем сценарии указывали стартовый шаг, и теперь хотите его заменить, сначала удалите существующий стартовый шаг, затем добавьте как описано в пункте «Добавить стартовый шаг»
- Удалить шаг
Кликните правой кнопкой для вызова контекстного меню и выберите «Удалить шаг»
Обратите внимание, если вы хотите удалить шаг с условием в группе фильтров, после которого настроена ветка, то система покажет предупреждение о том, что удалить данный шаг возможно только после удаления последующих шагов
- Копировать/вставить шаг
Используйте правую кнопку мыши для вызова контекстного меню и выберите «Копировать» или «Вставить».
- Редактирование/настройка шага
Нажмите на шаг для открытия окна настроек. Все обязательные поля должны быть заполнены. При наличии незаполненных обязательных полей шаг подсвечивается восклицательным знаком, в этом случае при попытке запуска сценария будет открыто окно редактирования шага, в котором не завершены настройки.
Если вы хотите сохранять данные шага как события, включите «Сохранять данные шага как событие клиента» во вкладке «Дополнительные настройки» в окне редактирования шага. Подробнее о событиях в инструкции.
- Изменение названия шага
Вы можете изменить названия шага в схеме сценария на любое удобное для вас. Для изменения названия необходимо нажать на шаг, вызвав окно редактирования шага, и изменить название шага в верхней части окна
Обратите внимание, для шага «Сообщение чат-бота» название автоматически меняется на текст сообщения бота, который вы укажете в поле «Сообщение бота», но вы можете всегда изменить название шага на необходимое вам, скорректировав его в верхней части окна редактирования.
- Поиск шага
Нажмите на значок лупы в верхней панели страницы с конструктором сценариев, и в появившейся строке поиска введите номер шага или его название.
Дополнительные рекомендации:
- Постарайтесь не оставлять тупиковых веток, если это не предусмотрено логикой вашего сценария.
Если клиент попадает в тупиковую ветку, он остается в ней до очистки сессии клиента, и не может больше проходить сценарий. Например, если вы хотите, чтобы клиент после прохождения сценария мог пройти его еще раз, или чтобы клиент не «застрял» в ветке «Условие не сработало» добавьте перевод на другой шаг сценария согласно вашей логике.
- Настройте ветку после шага «Ошибка сценария». Вы можете перенести клиента на стартовый шаг сценария, либо на шаг, с которого клиент попал в ошибку, чтобы он прошел данный шаг еще раз.
Все запущенные версии сценариев сохраняются. Вы можете восстановить при необходимости любую предыдущую версию.
Историю версий вы можете найти в верхней панели на странице конструктора сценариев, нажав три точки и выбрав пункт «История версий»
Для нового сценария, пока ни одна версия не была запущена, отобразится редактирование текущей версии 1:
Если у вас были ранее запущенные версии, вы увидите список версий с указанием времени запуска:
Для открытия предыдущей версии выберите необходимую из списка и нажмите на нее.
После того, как откроется выбранная версия, появится кнопка «Восстановить версию». Если вы перезагрузите страницу до того, как нажали восстановить, то загрузится последняя редактируемая версия
