Перевод клиентов на любой шаг сценария
Перевод клиента на конкретный шаг сценария, минуя или пропуская другие, означает перенос его в другую ветку или возвращение на более ранние шаги сценария.
Перенаправление на любой шаг по вебхуку — это специальный URL, который вызывается при наступлении заданного события и активирует нужное вам действие, в данном случае перевод клиента на другой шаг.
Отличие перевода на шаг по вебхуку от стандартного шага сценария «Перевести на шаг»
заключатся в том, что «Перевести на шаг» применяется в рамках одного сценария, а перевод на шаг по вебхуку может быть использован для перенаправления клиента на нужный шаг другого сценария.
Рассмотрим на примерах, как это работает.
Пример 1: Перемещение клиента на шаг «Перевод на оператора» из любого шага сценария.
Есть сценарий чат-бота с возможностью перевода на оператора нажатием соответствующей кнопки в сообщении бота (кнопка «Помощь» на шаге 4 сценария):
Вы хотите добавить возможность перевода на оператора для тех клиентов, которые в любой момент в процессе прохождения сценария пишут в чат-бот «позвать оператора». Например, вместо номера телефона на шаге 12 клиент отправляет сообщение «Позвать оператора» или нажимает на кнопку «Помощь» в ранее полученном сообщении бота. В данном случае необходимо перенаправить клиента на шаг «Перевести оператора», на каком бы шаге сценария он не находился.
Для этого необходимо создать дополнительный сценарий, который будет отслеживать необходимое действие клиента, и затем перенаправлять на нужный шаг основного сценария. Сценарий должен быть подключен к тому же сообществу ВКонтакте или чат-боту в Telegram, что и основной.
Дополнительный сценарий проверяет каждое входящее сообщение клиента на наличие заданных ключевых слов, по которым вы хотите переводить клиента на оператора, и далее не шаге 4 вызывается нужный шаг основного сценария:
Обратите внимание: по умолчанию в проекте нет запроса «Вызвать сценарий VK CXhub». Он создается по необходимости в каждом проекте самостоятельно. Подробная инструкция о том, как его создать, здесь.
Пример 2: Перевод группы клиентов на выбранный шаг
В сценарии из примера выше вам необходимо перевести на оператора сразу группу клиентов.
Для этого в дополнительном сценарии в качестве стартового шага выберите «Наступление даты» и укажите в настройках шага время запуска, периодичность и выбрать с помощью фильтров клиентов, для которых сработает перенаправление на нужный шаг :
Аналогичным образом вы можете настроить любое условие для перевода клиентов на нужный шаг.
Вызвать необходимый шаг любого сценария с помощью исходящего запроса. Для этого выполните следующие шаги для его создания и настройки:
1. Перейдите в раздел «Интеграции» → «Исходящие запросы» → «Создать исходящий запрос».
2. Заполните поля блока «Настройка запроса» и нажмите «Сгенерировать настройки параметров»
Название запроса: Вызвать сценарий VK CXhub
Тип интеграции: Default
Метод: GET
URL: #Вебхук до client_id_value=##Значение идентификатора#
Безопасное кодирование параметров URL: Отключено
Тип тела запроса: Raw
Тело запроса: #body#
3. Заполните блок «Настройка параметров» как показано на изображении и нажмите «Создать запрос».
4. Перейдите в дополнительный сценарий и добавьте шаг «Вызвать сценарий VK CXhub» («Действия» → «Выполнить исходящий запрос» → «Default» → «Вызвать сценарий VK CXhub») туда, где вы планируете его использовать согласно вашей логике.
5. Заполните поля в окне настройки шага:
- Вебхук, который вызывает нужный шаг основного сценария
Для получения вебхука перейдите в основной сценарий и нажмите на шаг, на который необходимо перенаправлять клиента.
В открывшемся окне настроек шага выберите вкладку «Дополнительные настройки», укажите идентификатор клиента и скопируйте ссылку, которая появится в поле «Ссылка для перехода»:
Вставьте данную ссылку в поле «Вебхук» шага «Вызвать сценарий VK CXhub» и удалите в конце ссылки «VALUE»
- Значение идентификатора: это переменная с идентификатором клиента
- Тело запроса: нужно оставить пустым
После заполнения полей нажмите «Сохранить»:
6. Готово. Запустите и протестируйте сценарии.