Интеграция с Bitrix24

Создайте входящий вебхук в Bitrix24

В вашем Bitrix24 перейдите: Приложения → Вебхуки → Входящий вебхук → Добавить вебхук.

Выберите права доступа — достаточно tasks (задачи) или crm (дела/сделки) в зависимости от ваших целей.

После создания скопируйте URL вебхука — он выглядит так:

https://ваш-портал.bitrix24.ru/rest/1/ТОКЕН/

Вставьте URL в кабинет RUL Monitor

Перейдите в Кабинет → раздел CRM Webhook, вставьте URL вебхука из Bitrix24 и установите интервал обновления (рекомендуется 900 сек = 15 минут).

Настройте обработку в Bitrix24

Наш сервер отправляет POST-запрос с JSON на ваш вебхук. Bitrix24 сам вызывает указанный REST-метод.

Пример: URL вебхука https://portal.bitrix24.ru/rest/1/abc123/

Если дописать tasks.task.add.json — Bitrix24 создаст задачу.

Вариант A: Создание задачи при критическом ресурсе (через UTM)

Настройте в кабинете URL вебхука с методом создания задачи:

https://ваш-портал.bitrix24.ru/rest/1/ТОКЕН/tasks.task.add.json

Bitrix24 получит JSON с полями задачи. Наш payload приходит в теле POST, но Bitrix24 ожидает параметры в формате fields[TITLE], fields[DESCRIPTION]. Поэтому рекомендуем использовать обработчик на стороне Bitrix24.

Вариант B: Создание сделки при регистрации нового оборудования (через UTM)

В кабинете CRM Webhook → вставьте URL с методом crm.lead.add.json

https://ваш-портал.bitrix24.ru/rest/1/ТОКЕН/crm.lead.add.json

Вариант B: Расширенная обработка через PHP-обработчик

Разместите на своём хостинге скрипт, который принимает наш JSON и вызывает REST API Bitrix24. Это даёт полный контроль над форматом данных.

<?php
$data = json_decode(file_get_contents('php://input'), true);
$bx_url = 'https://ваш-портал.bitrix24.ru/rest/1/ТОКЕН/';

if ($data['event'] === 'rul_critical') {
    // Создать задачу
    $task = [
        'fields' => [
            'TITLE' => 'Критический остаточный ресурс: ' . $data['equipment_type'],
            'DESCRIPTION' => 'Оборудование: ' . $data['asset_id'] . PHP_EOL
                          . 'Остаточный ресурс: ' . $data['rul'] . ' ч' . PHP_EOL
                          . 'Риск: ' . $data['risk'],
            'CREATED_BY' => 1,
            'RESPONSIBLE_ID' => 1,
        ],
    ];
    $ch = curl_init($bx_url . 'tasks.task.add.json');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($task));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_exec($ch);
    curl_close($ch);
}

Проверьте интеграцию

После подключения дождитесь первого batch-запроса (до 15 минут) или отправьте тестовые данные через демо-страницу.

В Bitrix24 появятся задачи/сделки в соответствии с настроенным обработчиком.