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

Маршруты

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

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

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

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

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

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

image.pngРаздел "Маршруты"

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

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

Знаком " | " в регулярном выражении разделяются слова-синонимы.

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

image.pngФорма свойств маршрута

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

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

image.pngОперации для списка Маршрутов

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

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

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

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

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

Более подробно как опция на логику:

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