Пример подключения бота
Например, вам нужно внедрить прямое уведомление через мессенджеры.
Вводные данные, которые у вас есть:
Тип данных | Значение |
---|---|
Имя сотрудника | Иван Иванов |
ID мессенджера сотрудника | #R11F0G2SD |
ID сотрудника на экземпляре SimpleOne | 160707678680781750 |
Шаг первый: создание метода бота
Создайте метод уведомления в таблице Методы ботов (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"
}
Чтобы указать более подробное содержимое метода, используйте поля вкладки Содержимое на записи Правила маршрутизации ботов.
Избегайте использования двойных кавычек (" ") в содержимом правила маршрутизации ботов. Следите за тем, чтобы количество последовательно поставленных обратных слэшей было четным. Если содержимое генерируется скриптом, заданным в поле Скрипт содержимого, экранируйте кавычки и замените обратные слэши, например, обычным слэшем перед возвращением значений.
Следующий пример скрипта содержит обычное выражение, включающее необходимые замены:
- одиночные обратные слэши заменены обычными слэшами.
- двойные кавычки экранированы обратным слэшем.
return `Comment: ${current.additional_comments}`
.replace(/(?<!\\)(?:((\\\\)*)\\)(?![\\/])/g, '\/')
.replace(/"/g, '\\"')
Шаг третий: создание параметров маршрутизации
Создайте параметр маршрутизации в таблице Параметры маршрутизации (sys_routing_parameter). Заполните поля следующими значениями:
Поле | Описание | Value |
---|---|---|
Метод бота | Ссылка на метод, который содержит параметр для отправки сообщений сотруднику. | send.message.to.employee |
Значение колонки | Это значение проверяется на соответствие правилу маршрутизации. В этом примере это ID сотрудника на экземпляре SimpleOne. | 160707678680781750 |
Значение параметра | Это значение параметра используется в теле метода, указанного в поле Метод бота. В этом примере это ID сотрудника в его мессенджере. | #R11F0G2SD |