Розробка кастомних дій бізнес-процесів Бітрікс24 під ключ

Розробка кастомних дій бізнес-процесів Бітрікс24 під ключ

Стандартні дії Бізнес-процесів Бітрікс24 — відправити лист, змінити поле, створити задачу. Для інтеграційних завдань цього недостатньо. Наприклад, коли в процесі узгодження потрібно запросити дані з 1С, створити документ у SharePoint або відправити повідомлення в Telegram. Наші інженери з 10+ років досвіду розробляють кастомні дії бізнес-процесів під ключ. За 5 років роботи ми виконали понад 500 проєктів автоматизації. Кастомна дія — це PHP-клас, що успадковує \Bitrix\Bizproc\Activity\BaseActivity або CBPActivity. Вона реєструється як обробник події OnBizProcActivityList. На відміну від роботів CRM, кастомна дія доступна у всьому редакторі бізнес-процесів — для списків, диска, CRM. Ми розробляємо як прості синхронні дії, так і асинхронні з retry-логікою. Отримайте консультацію — ми оцінимо ваше завдання та запропонуємо оптимальне рішення.

Навіщо потрібні кастомні дії?

Кастомна дія — це PHP-клас, що успадковує \Bitrix\Bizproc\Activity\BaseActivity (сучасний API) або CBPActivity. Вона реєструється як обробник події OnBizProcActivityList. На відміну від роботів CRM, кастомна дія доступна у всьому редакторі бізнес-процесів — для списків, диска, CRM. Ми розробляємо як прості синхронні дії, так і асинхронні з retry-логікою.

Як обрати: REST API чи PHP-модуль?

Для швидкої інтеграції краще REST API, для складної логіки всередині коробки — PHP-модуль. Оцінимо ваш сценарій безкоштовно.

Як розробити кастомну дію через REST API?

Реєструється методом bizproc.activity.add згідно з офіційною документацією Бітрікс24. Приклад:

$client->call('bizproc.activity.add', [ 'CODE' => 'GET_1C_PRICE', 'HANDLER' => 'https://my-server.com/bp-activity-handler', 'AUTH_USER_ID' => 1, 'NAME' => [ 'ru' => 'Получить цену из 1С', 'en' => 'Get price from 1C', ], 'USE_SUBSCRIPTION' => 'Y', 'PROPERTIES' => [ 'article' => [ 'Name' => ['ru' => 'Артикул товара'], 'Type' => 'string', 'Required' => 'Y', ], ], 'RETURN_PROPERTIES' => [ 'price' => [ 'Name' => ['ru' => 'Цена из 1С'], 'Type' => 'double', ], 'available' => [ 'Name' => ['ru' => 'В наличии'], 'Type' => 'bool', ], ], ]); 

USE_SUBSCRIPTION: Y — обов'язково, якщо дія виконується довше 5 секунд. Бітрікс24 одразу повертає 200, а обробник асинхронно надсилає результат через bizproc.event.send. Без цього токена воркфлоу зависне.

Кроки розробки:

1. Визначте код та параметри — задайте унікальний CODE та опишіть PROPERTIES, RETURN_PROPERTIES.
2. Викличте метод bizproc.activity.add — передайте HANDLER URL, встановіть USE_SUBSCRIPTION в Y для асинхронних дій.
3. Реалізуйте обробник — скрипт на вашому сервері приймає POST-запит від Бітрікс24, виконує бізнес-логіку та надсилає результат через bizproc.event.send з правильним event_token.
4. Протестуйте — запустіть процес з різними сценаріями, перевірте обробку помилок та таймаутів.

Розробка PHP-дії для коробкового Бітрікс24

Клас реєструється у файловій системі. Структура:

class My1CPriceActivity extends \Bitrix\Bizproc\Activity\BaseActivity { protected function execute(array &$arProperties) { $article = $this->getFieldValue('article'); $result = \My1CConnector::getPrice($article); if ($result->isSuccess()) { $this->setResultValue('price', $result->getPrice()); $this->setResultValue('available', $result->getAvailable()); } else { $this->writeToTrackingService( 'Помилка запиту до 1С: ' . $result->getErrorMessage() ); } return \CBPActivityExecutionStatus::Closed; } public static function getPropertiesDialog($params) { // Рендер форми налаштування } } 

Метод writeToTrackingService пише в журнал БП — важливо для налагодження.

Які помилки допускають при розробці?

• Таймаут без USE_SUBSCRIPTION — синхронний обробник довше 5 секунд, процес зависає.
• Не передано event_token — результат не доходить до БП, воркфлоу чекає нескінченно.
• Необроблений виняток у PHP-дії — валить весь воркфлоу. Завжди try-catch.

Що входить в роботу?

• Аналіз — розбір бізнес-процесу та вимог до інтеграції.
• Проектування — вибір архітектури (REST/PHP), узгодження протоколу.
• Реалізація — написання коду, реєстрація дії, налаштування форми параметрів.
• Тестування — на тестовому процесі з граничними сценаріями.
• Документація — інструкція з встановлення та використання.
• Підтримка — 30 днів гарантійного супроводу.

Строки розробки

Розробка кастомної дії під ключ займає 1–2 тижні в залежності від складності. Економія від впровадження — до $900–1.3kів на місяць. Оцінка проєкту — безкоштовно. Зв'яжіться з нами, щоб обговорити ваше завдання — отримайте консультацію та комерційну пропозицію.