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

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

Что даёт. Приложение добавляет в дизайнер бизнес-процессов два действия в разделе «Приложения».

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

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

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

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

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

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

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

Статистика вызовов за 7 и 30 дней по шаблонам бизнес-процессов, последние запросы с кодами ответов, задания без ответа и ошибки доставки, состояние обработчика. Доступна администраторам портала.

Начало работы

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

• Нужен тариф Битрикс24 с бизнес-процессами.
• Устанавливать приложение может только администратор портала; страница приложения доступна только администраторам.
• Адреса, данные и заголовки запросов задаёте вы в шаблонах бизнес-процессов. Приложение не выполняет запросы к адресам внутри частных сетей и к служебным адресам.
• Ограничения запроса: время ожидания ответа до 2 минут, тело ответа до 200 КБ (остаток отбрасывается, об этом пишется в журнал), до 5 редиректов. Пауза от 5 секунд до 60 минут.
• Вызовы REST самого портала выполняются в пределах прав приложения и от имени пользователя из настройки «Запускать от имени».
• Параметры запроса и ответ хранятся на сервере приложения только до завершения действия, история вызовов без них хранится 40 дней.
• Работает только в облачном Битрикс24.

1. Нажмите «Установить» и подтвердите доступ к разделам: бизнес-процессы, чат и уведомления (для отладочных уведомлений), пользователи (минимальный доступ), CRM и другие разделы, к которым вы будете обращаться через REST портала.
2. После установки откроется страница приложения, а в левом меню появится пункт «Действия БП».
3. Откройте шаблон бизнес-процесса в дизайнере: действия «Выполнить REST-запрос» и «Произвольная пауза» находятся в разделе «Приложения».
4. Для запроса укажите адрес (https://…) или имя метода REST портала (например, crm.item.get), метод, формат и данные. В поле JSONPath перечислите пути к нужным полям ответа, например $.result.TITLE: первый селектор попадёт в «JSONPath №1», второй в «JSONPath №2» и так далее.
5. Для проверки укажите «Пользователя для отладки»: после выполнения он получит уведомление с запросом и ответом.
6. Результаты действия вставляются в следующие действия через «Вставить значение» → «Дополнительные результаты».

Поддержка — по электронной почте info@datanika.ru.

• Время работы: по рабочим дням с 9:00 до 16:00 по московскому времени.
• Первый ответ — в течение одного рабочего дня.
• В письме укажите адрес портала и опишите, что происходит: какой шаблон, какое действие, что ожидали и что получилось. Если есть ошибка — приложите строку из журнала бизнес-процесса или скриншот.

Разработчик: Datanika (ИП Сурнина Айгуль Артуровна).