Перейти к основному содержимому
Версия: 1.21.3

Пример подключения бота

Например, вам нужно внедрить прямое уведомление через мессенджеры.

Вводные данные, которые у вас есть:

Тип данныхЗначение
Имя сотрудникаИван Иванов
ID мессенджера сотрудника#R11F0G2SD
ID сотрудника на экземпляре SimpleOne160707678680781750

Шаг первый: создание метода бота


Создайте метод уведомления в таблице Методы ботов (sys_bot_method) по инструкции в статье API Ботов. Заполните поле Тело следующим значением:

Метод бота
{
"channel": "<routing_parameter_0>",
"text": "<content>",
"as_user": "true",
"link_names": "true"
}

В данном примере связь "channel": "<routing_parameter_0>" указывает, что ключ channel заменит параметр routing_parameter_0, когда запрос отправится.

Шаг второй: создание правила маршрутизации


Создайте правило уведомлений в таблице Правила маршрутизации ботов (sys_bot_routing_rule) table.

В данном примере создание новой записи в таблице Задачи вызывает выполнение правила.

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

Параметры маршрутизации
{
"channel": "<routing_parameter_0>",
"thread": "<routing_parameter_1>",
"text": "<content>",
"as_user": "true",
"link_names": "true"
}

Чтобы указать более подробное содержимое метода, используйте поля вкладки Содержимое на записи Правила маршрутизации ботов.

внимание

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

Следующий пример скрипта содержит обычное выражение, включающее необходимые замены:

  • одиночные обратные слэши заменены обычными слэшами.
  • двойные кавычки экранированы обратным слэшем.
Regular Expression
return `Comment: ${current.additional_comments}`
.replace(/(?<!\\)(?:((\\\\)*)\\)(?![\\/])/g, '\/')
.replace(/"/g, '\\"')

Шаг третий: создание параметров маршрутизации


Создайте параметр маршрутизации в таблице Параметры маршрутизации (sys_routing_parameter). Заполните поля следующими значениями:

ПолеОписаниеValue
Метод ботаСсылка на метод, который содержит параметр для отправки сообщений сотруднику.send.message.to.employee
Значение колонкиЭто значение проверяется на соответствие правилу маршрутизации. В этом примере это ID сотрудника на экземпляре SimpleOne.160707678680781750
Значение параметраЭто значение параметра используется в теле метода, указанного в поле Метод бота. В этом примере это ID сотрудника в его мессенджере.#R11F0G2SD