Как изменить ответственного в Bitrix24 через вебхук

В Bitrix24 можно изменить пользователя во входящем вебхуке или установить другого ответственного при загрузке лида через вебхук, используя параметр ASSIGNED_BY_ID в теле запроса при создании лида или метод crm.lead.update для изменения ответственного после создания. Также можно настроить автоматическое назначение ответственного через бизнес-процессы CRM.

Содержание

• Основы работы с вебхуками в Bitrix24
• Изменение ответственного при создании лида через вебхук
• Назначение ответственного для существующих лидов
• Бизнес-процессы для автоматического назначения ответственного
• Ограничения и безопасность при работе с вебхуками
• Практические примеры кода для вебхуков

Основы работы с вебхуками в Bitrix24

Вебхуки в Bitrix24 представляют собой механизм для вызова методов REST API из внешних систем, позволяя автоматически создавать лиды, задачи и другие объекты без необходимости использования стандартного интерфейса системы. Настройка вебхуков выполняется в разделе “Приложения” → “Вебхуки”, где можно создать как входящие, так и исходящие вебхуки для различных целей интеграции.

Входящие вебхуки особенно полезны для автоматизации процессов загрузки данных из внешних источников, таких как формы на сайтах, мобильные приложения или другие CRM-системы. При создании вебхука указывается URL-адрес обработчика, который будет принимать запросы, и определяются права доступа для этого вебхука — какие именно операции он может выполнять в системе.

Для работы с лидами через вебхук важно понимать структуру данных, которая передается в теле запроса. Каждый объект в Bitrix24 имеет свои обязательные и необязательные поля, включая поля для указания ответственного пользователя, название лида, контактную информацию и другие параметры. Правильное формирование этих полей — ключ к успешной интеграции.

Изменение ответственного при создании лида через вебхук

При создании лида через вебхук в Bitrix24 можно сразу указать ответственного пользователя, передав соответствующий параметр в теле запроса. Для этого используется поле ASSIGNED_BY_ID, в котором указывается ID пользователя, которого нужно назначить ответственным за этот лид.

Пример структуры запроса на PHP для создания лида с назначенным ответственным:

$data = [
 'fields' => [
 'TITLE' => 'Новый лид из вебхука',
 'NAME' => 'Иван',
 'LAST_NAME' => 'Иванов',
 'PHONE' => ['VALUE' => '+79001234567', 'VALUE_TYPE' => 'MOBILE'],
 'EMAIL' => ['VALUE' => 'ivanov@example.com', 'VALUE_TYPE' => 'WORK'],
 'ASSIGNED_BY_ID' => 19 // ID ответственного пользователя
 ]
];

$curl = curl_init();
curl_setopt_array($curl, [
 CURLOPT_SSL_VERIFYPEER => 0,
 CURLOPT_POST => 1,
 CURLOPT_HEADER => 0,
 CURLOPT_RETURNTRANSFER => 1,
 CURLOPT_URL => 'https://yourdomain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add',
 CURLOPT_POSTFIELDS => http_build_query($data)
]);

$response = curl_exec($curl);
curl_close($curl);

$result = json_decode($response, true);

В этом примере параметр ‘ASSIGNED_BY_ID’ => 19 указывает, что ответственным за созданный лид будет пользователь с ID 19. ID пользователей можно получить из профиля сотрудника в Bitrix24 или через API метод users.get.

Если вебхук не позволяет напрямую передать поле ответственного, можно сначала создать лид без назначения ответственного, а затем сразу обновить его с помощью метода crm.lead.update, передав в нем ID нужного пользователя в поле ASSIGNED_BY_ID. Этот подход особенно полезен, когда внешняя система предоставляет только ограниченный набор данных.

Назначение ответственного для существующих лидов

Для изменения ответственного у уже существующих лидов в Bitrix24 можно использовать несколько методов в зависимости от того, нужно ли изменить ответственного для одного лида или для группы лидов.

Изменение ответственного для конкретного лида выполняется через интерфейс системы: откройте карточку лида и в поле “Ответственный” нажмите “Сменить”, после чего выберите нужного сотрудника из списка. Этот метод подходит для ручного изменения ответственных, когда нужно переназначить один или несколько лидов.

Для массового изменения ответственных у группы лидов выполните следующие действия:

1. Перейдите в раздел “Лиды” CRM Bitrix24
2. Выберите нужные лиды с помощью галочек слева от каждого лида
3. Внизу страницы в поле “Выберите действие” выберите “Назначить ответственного”
4. Выберите нужного сотрудника из появившегося списка
5. Нажмите “Применить”

Если нужно изменить ответственного у всех лидов на других страницах раздела “Лиды”, выберите параметр “Для всех”. Этот метод позволяет быстро перераспределить нагрузку между сотрудниками или назначить ответственного по определенному критерию, например, по территориальному признаку или специализации.

Для программного изменения ответственного у существующего лида используется метод REST API crm.lead.update. Пример кода на PHP:

$data = [
 'id' => 123, // ID лида
 'fields' => [
 'ASSIGNED_BY_ID' => 45 // Новый ID ответственного
 ]
];

$curl = curl_init();
curl_setopt_array($curl, [
 CURLOPT_SSL_VERIFYPEER => 0,
 CURLOPT_POST => 1,
 CURLOPT_HEADER => 0,
 CURLOPT_RETURNTRANSFER => 1,
 CURLOPT_URL => 'https://yourdomain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.update',
 CURLOPT_POSTFIELDS => http_build_query($data)
]);

$response = curl_exec($curl);
curl_close($curl);

$result = json_decode($response, true);

Бизнес-процессы для автоматического назначения ответственного

Бизнес-процессы в Bitrix24 позволяют автоматизировать назначение ответственного при создании лида без необходимости использования вебхуков или ручного вмешательства. Этот метод особенно эффективен для распределения лидов по определенным критериям, таким как отдел, регион или специализация сотрудника.

Для настройки автоматического назначения ответственного через бизнес-процессы выполните следующие шаги:

1. Откройте раздел “CRM → Настройки → Роботы и бизнес-процессы → Бизнес-процессы”
2. В разделе “Лид” нажмите “добавить шаблон”
3. Задайте название шаблона, например “Автоматическое назначение ответственного”
4. Включите автоматический запуск “При добавлении”
5. Перетащите блок “Выбор сотрудника” в начало процесса
6. В настройках блока выберите основной и резервный сотрудника
7. Добавьте блок “Изменение документа”
8. В блоке “Изменение документа” выберите поле “Ответственный”
9. В качестве значения укажите параметр “Выбранный сотрудник”
10. Сохраните шаблон

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

Бизнес-процессы также могут включать условные блоки, которые проверяют определенные поля лида перед назначением ответственного. Например, можно настроить процесс, который назначает ответственного из отдела продаж, если в лиде указан email, или из отдела поддержки, если в названии лида есть ключевое слово “поддержка”. Это обеспечивает гибкое и интеллектуальное распределение лидов между сотрудниками.

Ограничения и безопасность при работе с вебхуками

При работе с вебхуками в Bitrix24 необходимо учитывать несколько важных ограничений и соображений безопасности, которые обеспечивают стабильность и защиту системы. Во-первых, входящие вебхуки имеют строго заданные права доступа — они могут выполнять только те операции, которые явно разрешены при их настройке. Это ограничивает потенциальный ущерб в случае компрометации вебхука.

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

В-третьих, существуют лимиты на количество вызовов API в сутки, которые зависят от тарифного плана Bitrix24. Превышение этих лимитов может привести к временной блокировке вебхука или всей интеграции. Рекомендуется реализовывать обработку ошибок и повторные попытки с экспоненциальной задержкой в случае получения ошибки о превышении лимитов.

Вебхуки доступны только при активной коммерческой подписке Bitrix24. В бесплатных версиях функционал вебхуков может быть ограничен или отсутствовать полностью. При разработке интеграций с использованием вебхуков рекомендуется реализовать механизмы логирования и мониторинга для отслеживания успешных и неуспешных вызовов API.

Практические примеры кода для вебхуков

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

Пример 1: Создание лида с назначенным ответственным через вебхук

<?php
// Настройки вебхука
$webhookUrl = 'https://yourdomain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add';
$assignedUserId = 19; // ID ответственного пользователя

// Данные для создания лида
$leadData = [
 'fields' => [
 'TITLE' => 'Лид из формы сайта',
 'NAME' => 'Петр',
 'LAST_NAME' => 'Петров',
 'PHONE' => [['VALUE' => '+79123456789', 'VALUE_TYPE' => 'MOBILE']],
 'EMAIL' => [['VALUE' => 'petrov@example.com', 'VALUE_TYPE' => 'WORK']],
 'SOURCE_ID' => 'WEB', // Источник
 'ASSIGNED_BY_ID' => $assignedUserId // Назначаем ответственного
 ]
];

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $webhookUrl);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($leadData));

$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);
if ($result['result']) {
 echo 'Лид успешно создан. ID: ' . $result['result'];
} else {
 echo 'Ошибка при создании лида: ' . $result['error_description'];
}
?>

Пример 2: Обновление ответственного у существующего лида

<?php
// Настройки вебхука
$webhookUrl = 'https://yourdomain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.update';
$leadId = 123; // ID лида
$newAssignedUserId = 45; // Новый ID ответственного

// Данные для обновления лида
$updateData = [
 'id' => $leadId,
 'fields' => [
 'ASSIGNED_BY_ID' => $newAssignedUserId
 ]
];

// Отправка запроса
$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $webhookUrl);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($updateData));

$response = curl_exec($ch);
curl_close($ch);

// Обработка ответа
$result = json_decode($response, true);
if ($result['result']) {
 echo 'Ответственный успешно изменен';
} else {
 echo 'Ошибка при изменении ответственного: ' . $result['error_description'];
}
?>

Пример 3: Обработка вебхука на PHP

<?php
// Получение данных из вебхука
$input = file_get_contents('php://input');
$data = json_decode($input, true);

// Проверка корректности данных
if (isset($data['TITLE']) && isset($data['PHONE'])) {
 // Настройки вебхука
 $webhookUrl = 'https://yourdomain.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add';
 
 // Подготовка данных для создания лида
 $leadData = [
 'fields' => [
 'TITLE' => $data['TITLE'],
 'PHONE' => [['VALUE' => $data['PHONE'], 'VALUE_TYPE' => 'MOBILE']],
 'ASSIGNED_BY_ID' => 19 // Назначаем ответственного
 ]
 ];
 
 // Отправка запроса в Bitrix24
 $ch = curl_init();
 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_HEADER, 0);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 curl_setopt($ch, CURLOPT_URL, $webhookUrl);
 curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($leadData));
 
 $response = curl_exec($ch);
 curl_close($ch);
 
 // Ответ внешней системе
 $result = json_decode($response, true);
 if ($result['result']) {
 echo '{"status": "success", "lead_id": ' . $result['result'] . '}';
 } else {
 echo '{"status": "error", "message": "' . $result['error_description'] . '"}';
 }
} else {
 echo '{"status": "error", "message": "Invalid data"}';
}
?>

Эти примеры демонстрируют основные сценарии работы с вебхуками Bitrix24 для создания и обновления лидов с назначением ответственных пользователей. При реализации интеграций рекомендуется добавить обработку ошибок, валидацию данных и механизмы повторных попыток в случае неудачных запросов к API.

Источники

1. БизнесПрофи — Инструкция по изменению ответственного за лиды в Bitrix24 через интерфейс: https://bizprofi.ru/blog/kak-izmenit-otvetstvennogo-za-lidy-v-bitriks24/

2. Клеверенс — Обзор настройки вебхуков в Bitrix24 для автоматизации и интеграций: https://www.cleverence.ru/articles/auto-busines/-nastroyka-vebhukov-v-bitriks24-avtomatizatsiya-i-integratsiya-bez-koda/

3. Merion Academy — Руководство по настройке бизнес-процессов для автоматического назначения ответственного: https://wiki.merionet.ru/articles/bitriks24-sluchajnyj-otvetstvennyj-za-lid

4. Tichiy.ru — Практическое руководство по работе с лидами в Bitrix24 через вебхук: https://tichiy.ru/en/wiki/rabota-s-lidom-v-bitriks24-cherez-webhook/

Заключение

Изменение пользователя во входящем вебхуке или установка другого ответственного при загрузке лида через вебхук в Bitrix24 — это стандартная задача, которая может быть решена несколькими способами. При создании лида через вебхук можно сразу указать ответственного пользователя с помощью параметра ASSIGNED_BY_ID. Для изменения ответственного у существующих лидов используется либо интерфейс системы для ручного переназначения, либо метод crm.lead.update через REST API.

Более сложные сценарии автоматического назначения ответственного реализуются через бизнес-процессы CRM, которые позволяют гибко настраивать правила распределения лидов по различным критериям. При работе с вебхуками важно учитывать ограничения безопасности и лимиты API, а также реализовывать надежную обработку ошибок и логирование для стабильной работы интеграций.

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