Перейти к основному контенту

Маршруты

От маршрутов зависит по какой из цепочки сценариев пойдет бот при общении с пользователем.

Маршруты - это начальная точка взаимодействия бота и пользователя при получении очередного сообщения пользователя ботом. Маршруты позволяют настроить условия запуска созданных скриптов. ​

Бот взаимодействует с пользователем, анализирует полученное сообщение, находит с списке подходящий маршрут и затем стартует скрипт, а дальше бот выполняет сценарий уже по скрипту.

Если не найден ни один маршрут, то выполняется резервный скрипт с типом Fallback.

Маршруты необходимо создавать в разделе главного меню Настройки бота подраздел Маршруты.

На экранной форме следует нажать кнопку Создать маршрут.

image.png

При создании  нового маршрута необходимо заполнить следующие параметры:

  • Название — логически понятное название маршрута , например, "Основной маршрут";
  • Скрипт — из списка скриптов выбрать скрипт, который будет запущен при старте данного маршрута;
  • Регулярное выражение — параметр маршрута, слова по которым бот должен будет запуститься. Например: 
    •  .* — это выражение означает, что старт бота произойдет при любом введенном слове или символе со стороны пользователя;
    • бот|меню — синтаксис написания выражения. Данное выражение позволит настроить запуск бота после остановки или при намерении пользователя вернуться в главное Меню.

Как составить свое произвольное регулярное выражение можно узнать на странице Регулярные выражения.

  • Статус лида — значение выбирается из списка , означает при каком статусе лида будет выполняться данный маршрут;
  • Контекст лида — параметр маршрута, который задается командой  в скрипте бота и означает выполнение маршрута удовлетворяющего данному условию.

image.png

В разделе Маршруты располагается список маршрутов данного бота с доступными операциями:

  • Перейти в редактор скрипта — будет произведен переход в скрипт для редактирования, который указан в свойствах маршрута;
  • Редактировать свойства маршрута;
  • Удалить маршрут.

image.png

Маршруты разделены на 2 группы:

  • Обычные маршруты;
  • Маршруты с диплинками.

Каждая группа маршрутов обладает своей сортировкой. Сортировка влияет на порядок поиска (и запуска) маршрута.
Запускается только первый маршрут подходящий под все условия отбора.
Если маршрут найден, то очищается беседа и запускается скрипт указанный в маршруте.

Для всех маршрутов с диплинками считается, что у них включена опция Действует в диалоге. Даже если эта опция отключена, при обработке маршрута с диплинком считается, что она включена.

Даже если случайно сбросим эту опция в базе данных, то на логику это не повлияет.

Более подробно как опция на логику: если включена опция Обработка Deep Link, то после сохранения маршрута (редактирование/создание), на бэке будет автоматически установлена опция Действует в диалоге.