Налаштування передачі лідів із сайту 1С-Бітрікс у CRM Бітрікс24

Налаштування передачі лідів з сайту 1С-Бітрікс до CRM Бітрікс24

Форму зворотного зв'язку на сайті заповнено — лід ніде не з'явився. Менеджер дізнається про заявку з листа на корпоративну пошту через півгодини, вручну вносить до CRM. За цей час клієнт уже зателефонував конкурентам. Правильне налаштування передає лід у Бітрікс24 негайно та автоматично.

Способи передачі

Варіант 1. Модуль «Бітрікс24.Коннектор» — встановлюється з маркетплейсу, зв'язує інфоблоки форм із CRM без коду. Підходить для стандартних веб-форм (bitrix:main.feedback, bitrix:form.result.new).

Варіант 2. REST API напряму — обробник у компоненті форми викликає crm.lead.add через \Bitrix\Main\Web\HttpClient. Підходить для нестандартних форм, кастомних компонентів, форм на React/Vue всередині Бітрікса.

Налаштування через REST API

Отримуємо вхідний вебхук у Бітрікс24: Додатки → Вебхуки → Вхідний вебхук. Вибираємо права crm (читання/запис). Копіюємо URL виду https://your-domain.bitrix24.ru/rest/1/токен/.

В обробнику форми на сайті:

use Bitrix\Main\Web\HttpClient;

$http = new HttpClient();
$http->setHeader('Content-Type', 'application/json');

$leadData = [
    'TITLE'      => 'Заявка з сайту: ' . $formFields['NAME'],
    'NAME'       => $formFields['NAME'],
    'PHONE'      => [['VALUE' => $formFields['PHONE'], 'VALUE_TYPE' => 'WORK']],
    'EMAIL'      => [['VALUE' => $formFields['EMAIL'], 'VALUE_TYPE' => 'WORK']],
    'COMMENTS'   => $formFields['MESSAGE'],
    'SOURCE_ID'  => 'WEB',
    'SOURCE_DESCRIPTION' => 'Форма: ' . $formName . ' | URL: ' . $pageUrl,
];

$response = $http->post(
    'https://your-domain.bitrix24.ru/rest/1/токен/crm.lead.add.json',
    json_encode(['fields' => $leadData, 'params' => ['REGISTER_SONET_EVENT' => 'Y']])
);

Обов'язкові поля ліда

• TITLE — назва ліда (відображається у списку CRM).
• SOURCE_ID — джерело: WEB, CALL, EMAIL та ін. з довідника crm.status.list з ENTITY_ID = SOURCE.
• PHONE / EMAIL — масиви з типом значення.

Поле SOURCE_DESCRIPTION корисне для аналітики — пишемо туди URL сторінки, назву форми, UTM-мітки з $_COOKIE або $_GET.

UTM-мітки та джерело трафіку

Передаємо UTM у лід для атрибуції:

$utmFields = [];
foreach (['utm_source','utm_medium','utm_campaign','utm_term','utm_content'] as $utm) {
    if (!empty($_COOKIE[$utm])) {
        $utmFields['UTM_' . strtoupper(substr($utm, 4))] = $_COOKIE[$utm];
    }
}
$leadData = array_merge($leadData, $utmFields);

UTM-поля (UTM_SOURCE, UTM_MEDIUM тощо) — стандартні поля ліда Бітрікс24.

Призначення відповідального

За замовчуванням лід потрапляє на користувача, який створив вебхук. Для розподілу між відповідальними використовуємо ASSIGNED_BY_ID — ID користувача Бітрікс24. Логіку вибору будуємо на основі даних форми: вибране місто, тип послуги, робочий час.

Контроль дублів

Перед створенням ліда перевіряємо наявні контакти за телефоном через crm.duplicate.findByComm:

$dupes = $http->post($webhookUrl . 'crm.duplicate.findByComm.json', json_encode([
    'type'   => 'PHONE',
    'values' => [$formFields['PHONE']],
]));

Якщо контакт знайдено — створюємо не лід, а угоду/активність на наявному контакті. Це запобігає засміченню CRM дублюючими лідами від постійних клієнтів.

Налаштування передачі лідів для стандартної форми — 4–6 годин. Кастомна логіка з UTM, дедублікацією та розподілом відповідальних — 1–2 робочих дні.