Действия для бизнес-процессов

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

Что даёт. Приложение добавляет в дизайнер бизнес-процессов три действия в разделе «Действия приложений». Каждое можно включить или выключить на странице приложения.

«Выполнить REST-запрос»

• HTTP-запрос к любому адресу: GET, POST, PUT, PATCH, DELETE; тело в формате JSON, form-urlencoded, multipart или текст; свои заголовки и Basic-авторизация.
  
• Вызов метода REST этого же портала без вебхуков и токенов: достаточно написать имя метода, например crm.item.get или batch. Авторизация подставится сама, запрос выполнится от имени пользователя, указанного в «Запускать от имени».
  
• Разбор ответа по JSONPath: до 15 селекторов, каждый возвращает отдельное значение, которое можно подставить в следующие действия процесса.
  
• В процесс возвращаются код ответа, тело, заголовки, признак успеха и текст ошибки.
  
• Отладка: укажите пользователя, и он получит уведомление с полным запросом и ответом (JSON отформатирован, ключи доступа скрыты).
  

«Произвольная пауза»

• Пауза от 5 секунд до 60 минут с точностью до секунды (штатная пауза считает минутами).
  
• Случайная пауза в диапазоне «от … до»: разнесите массовые действия во времени, чтобы не упираться в лимиты внешних сервисов.
  
• В процесс возвращаются запланированная и фактическая длительность и время продолжения.
  

«Публикация в канал»

• Сообщение в канал портала прямо из бизнес-процесса: новости, итоги, оповещения о сделках и оплатах.
  
• Канал выбирается из списка или указывается по ID либо ссылке; поддерживается разметка чата (жирный, курсив, ссылки) и превью ссылок.
  
• В процесс возвращаются признак успеха, ID и ссылка на опубликованное сообщение.
  

Как это работает
Действие принимает вызов мгновенно и не держит процесс: работа выполняется на сервере приложения, результат возвращается в процесс, как только он готов, обычно за секунды. В журнал бизнес-процесса записывается строка с методом, адресом, кодом ответа и временем выполнения. Если внешний сервис ответил ошибкой, процесс получит success = N и текст ошибки и сможет обработать её своей веткой; если результат не удалось вернуть из-за временного сбоя, приложение повторит доставку. Ответы в один процесс доставляются по очереди, поэтому параллельные ветки с несколькими запросами не теряют результатов.

Страница приложения

• «Обзор»: статистика вызовов за выбранный период, какие шаблоны бизнес-процессов делают запросы, последние запросы с кодами ответов, задания без ответа, состояние обработчика; фильтр по периоду, действию, результату и шаблону.
  
• «Действия»: включение и выключение действий на портале.
  
• «Журнал приложения»: установки и изменения настроек.
  
• «Поддержка»: обращения к разработчику прямо из приложения, с перепиской, файлами и уведомлениями об ответах.
  

Страница доступна администраторам портала.

Начало работы
После установки откройте дизайнер бизнес-процессов: действия «Выполнить REST-запрос», «Произвольная пауза» и «Публикация в канал» появятся в разделе «Действия приложений». Добавьте действие в шаблон, заполните настройки и используйте результаты в следующих действиях через «Вставить значение» → «Дополнительные результаты».