Документация · 🧭 Сценарии (Journeys)

Как выполняется сценарий

Кто действует, что разрешено видеть ассистенту и что происходит, если шаг выполнить нельзя.

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

Что получает ассистент#

Ассистент получает о сценарии две вещи: его название и фразу-триггер. Шаги и элементы, на которые они указывают, ему не передаются никогда — ни до, ни во время, ни после.

Правило: Поэтому *«он никогда не выполняет шаг, который никто не записал»* — это факт, а не намерение. Название элемента, попавшее в модель, — это название, вариацию которого модель могла бы выдать. Оно в модель не попадает, поэтому и вариации взяться неоткуда.

Что видит посетитель#

  • Небольшую карточку в чате, где показано, какой шаг выполняется и сколько их всего.
  • На шаге Guide — просьбу сделать этот шаг самостоятельно, с указанием нужного элемента на странице.
  • На шаге Hold — кнопку Continue («Продолжить»): пока её не нажмут, ничего не происходит.
  • Возможность остановить всё на любом шаге, не выходя из чата.

Если шаг выполнить нельзя#

Перед каждым действием движок проверяет элемент, с которым собирается работать: есть ли он действительно на странице, виден ли, доступен ли для взаимодействия и указывает ли он на тот же элемент, о котором шла речь. Если что-то из этого не так, шаг пропускается, а не пробуется. Шаг, в котором движок не уверен, он не выполняет.

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

Как он завершается#

Ассистент узнаёт результат один раз за сценарий, а не по шагам, и только когда тот закончен — завершён или остановлен. Пока это сообщение не пришло, ассистент не утверждает, что что-то сделано, потому что действительно этого не знает.

Где он работает#

Панель чата находится в отдельном фрейме на нашем домене; движок работает на вашей странице. Через эту границу проходят только четыре вещи: план выполнения, *продолжить*, *остановить* и какой шаг где находится. Кто посетитель, его сессия и текст разговора остаются на нашей стороне и никогда не попадают на вашу страницу.

Совет: В проекте без сценариев движок даже не загружается — ни лишнего запроса, ничего добавленного на вашу страницу.

Сценарий не запускается.
Либо функция не активна для проекта — проверьте на странице Journeys, не перестало ли выполняться какое-то требование, — либо фраза-триггер не похожа на то, что написал посетитель. Триггеры сравниваются с настоящими фразами, а не с названиями пунктов меню.
Он останавливается на середине.
Шаг трижды не нашёл то, что должен был нажать. Обычно это значит, что страница изменилась: элемент переименовали, переместили или он теперь появляется только после чего-то другого. Откройте сценарий, исправьте этот шаг и опубликуйте снова.
Он ждёт, и ничего не происходит.
Он находится на шаге Hold или Guide — именно там ему и положено ждать посетителя. Такие шаги завершаются, когда посетитель действует или нажимает Continue, — сами по себе никогда.