Расширение возможностей бизнес-процессов с помощью вебхуков: работа с задачами

Стандартные активити бизнес-процессов позволяют автоматизировать только часть функционала, который доступен на портале.

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

Часть таких простых функций можно реализовать самостоятельно без программирования и сторонних приложений, но при условии, что на портале работают REST API и вебхуки - с 1 января 2021 года они стали доступны только на коммерческих тарифах.

Как это работает

В дизайнере бизнес-процессов в категории Прочее есть стандартное действие WebHook. Это действие отправляет запрос из поля Хендлер и не возвращает никаких данных. 

Таким способом можно обратиться к какому-то внешнему сервису, а можно и к текущему порталу, на котором настраивается бизнес-процесс.

То есть по сути действие WebHook делает исходящий запрос, но в качестве параметра Хендлер мы укажем URL предварительно настроенного входящего вебхука.

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

Для начала нужно настроить входящий вебхук.

Входящий вебхук для работы с задачами

В разделе Разработчикам -> Другое -> Входящий вебхук нужно создать вебхук с правами доступа к задачам:

После этого можно переходить к примерам.

Завершить задачу из бизнес-процесса с помощью вебхука

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

Для того чтобы закрыть задачу используем метод tasks.task.complete. У метода 1 параметр: taskId - это идентификатор задачи.

В итоге получаем URL: https://адрес_портала/rest/1/код_вебхука/tasks.task.complete?taskId=taskId и указываем его в качестве параметра Хендлер действия Webhook:

В параметр taskId передаем идентификатор созданной задачи, который можно получить из дополнительных результатов.

Запускаем бизнес-процесс и проверяем, что получилось:

Задача поставлена и сразу же завершена. Всё работает правильно. 

На что нужно обратить внимание: задача будет завершена под тем пользователем, под которым был настроен вебхук.

По такому же принципу можно выполнить и другие простые действия, например:

• принять задачу tasks.task.approve
• отклонить задачу tasks.task.disapprove
• отложить задачу tasks.task.defer
• удалить задачу tasks.task.delete

Все эти действия принимают в качестве параметра только taskId - идентификатор задачи.

Делегировать задачу

Для того чтобы делегировать задачу используем метод tasks.task.delegate. У метода 2 параметра: taskId - идентификатор задачи и userId - идентификатор пользователя, на которого необходимо делегировать задачу.

URL будет выглядеть так: https://адрес_портала/rest/1/код_вебхука/tasks.task.delegate?taskId=taskId&userId=userId.

Бизнес-процесс будем использовать тот же, заменим только параметр Хендлер в действии Webhook:

В параметр userId в моем примере будет передан ID пользователя из константы user. Чтобы получить идентификатор использую преобразование типов данных.

По системному комментарию видно, что задача создана и сразу же делегирована.

Привязать задачу к произвольным сущностям CRM

Много раз сталкивалась с таким запросом: задачу нужно привязать не только к текущей сущности CRM (например, сделке), но и к связанным со сделкой контакту и компании.

Я для упрощения привяжу созданную задачу к контакту с ID=1 и компании с ID=1. Будем считать, что эти значения мы динамически получили в бизнес-процессе.

Для этого созданную задачу обновим методом tasks.task.update. У метода 2 параметра: taskId - идентификатор задачи и fields - обновляемые поля. За привязку к элементам CRM отвечает поле UF_CRM_TASK.

URL будет выглядеть так: https://адрес_портала/rest/1/код_вебхука/tasks.task.update?taskId=taskId&fields[UF_CRM_TASK][]=C_contact_id&fields[UF_CRM_TASK][]=CO_company_id.

На что нужно обратить внимание: для установки контакта с ID=1 используем синтаксис С_1, для компании с ID=1 - CO_1.

Как и в предыдущих примерах заменим параметр Хендлер в действии Webhook:

Запускаем процесс и получаем задачу с привязкой к произвольному контакту и компании:

Вообще, с помощью метода tasks.task.update поменять/доустановить можно любые доступные для записи поля задачи из списка в зависимости от того, какой функционал требуется реализовать в бизнес-процессе.