Як налаштувати вебхук Бітрікс24 для заявок з сайту: ліди та угоди

Форма зворотного зв'язку на сайті надсилає листа адміністратору — і на цьому все закінчується. Немає задачі менеджеру, немає історії в CRM, немає SLA на відповідь. Клієнти чекають на відповідь днями, заявки губляться, менеджери не бачать повної картини звернень. За статистикою, до 30% заявок втрачається при поштовій передачі, а середній час реакції перевищує 4 години. Налаштування прямої передачі в Бітрікс24 вирішує цю проблему за 4–6 годин: кожна заявка перетворюється на лід або угоду з відповідальним, дедлайном і повним контекстом. Ми реалізували понад 50 таких інтеграцій — середній час створення заявки в CRM після відправлення форми становить 1–2 секунди.

Ми налаштовуємо інтеграцію під ваш бізнес: від простої форми зворотного зв'язку до багатокрокових кастомних форм з нестандартними полями. У результаті менеджер бачить заявку в CRM через секунду після відправлення, а не через годину, коли загляне в пошту. Нижче розберемо технічні варіанти: які компоненти використовувати, як правильно створювати ліди та угоди, налаштовувати сповіщення та уникати дублів.

Документація 1С-Бітрікс: REST API

Варіанти компонентів зворотного зв'язку

У 1С-Бітрікс зворотний зв'язок реалізується через:

• bitrix:main.feedback — стандартний компонент, проста форма.
• bitrix:form.result.new — розширений модуль веб-форм з полями будь-якого типу.
• Кастомний компонент або Ajax-форма на React/Vue.

Для всіх варіантів підхід один: перехоплюємо момент успішного відправлення і викликаємо REST API Бітрікс24.

Чому лід, а не угода?

Головне питання при налаштуванні — яку сутність створювати. Лід підходить для нових або невідомих клієнтів: менеджер кваліфікує та конвертує в контакт/угоду. Угоду варто створювати, якщо клієнт вже є в базі — визначаємо за телефоном/email через crm.duplicate.findByComm. Якщо потрібно просто зафіксувати факт звернення до існуючого контакту, використовуємо активність (дзвінок/лист).

Для сайтів з великим потоком нових звернень правильніше створювати ліди — це дає менеджеру контекст і дозволяє коректно вести воронку. Для B2B з обмеженою базою клієнтів — одразу угоди або активності, щоб не плодити необроблені ліди. Автоматизація через REST API скорочує час створення сутності на 90% порівняно з ручним введенням.

Як уникнути дублів контактів?

Дублі — часта проблема при інтеграції. Ми реалізуємо перевірку через crm.duplicate.findByComm перед створенням ліда. Якщо знайдено існуючий контакт, прив'язуємо новий лід до нього або створюємо угоду. Додатково можна налаштувати бізнес-процес у Бітрікс24 для автоматичного об'єднання дублів за правилами. Це знижує відсоток дублів до 1-2% проти 15% при відсутності перевірки.

Налаштування через компонент main.feedback

Компонент bitrix:main.feedback використовує подію OnBeforeEventAdd (модуль main). Підписуємося в init.php:

AddEventHandler('main', 'OnBeforeEventAdd', function(&$eventName, &$lid, &$fields) { if ($eventName !== 'FEEDBACK') return; $b24WebhookUrl = COption::GetOptionString('my_module', 'b24_webhook'); $http = new \Bitrix\Main\Web\HttpClient(); $leadData = [ 'TITLE' => 'Обратная связь с сайта', 'NAME' => $fields['NAME'] ?? '', 'PHONE' => [['VALUE' => $fields['PHONE'] ?? '', 'VALUE_TYPE' => 'WORK']], 'EMAIL' => [['VALUE' => $fields['EMAIL'] ?? '', 'VALUE_TYPE' => 'WORK']], 'COMMENTS' => $fields['MESSAGE'] ?? '', 'SOURCE_ID'=> 'WEB', ]; $http->post($b24WebhookUrl . 'crm.lead.add.json', json_encode(['fields' => $leadData])); }); 

Цей обробник створює лід у CRM і повертає його ID. Час виконання — менше 1 секунди. При помилці (наприклад, невірний вебхук) подія не переривається — заявка все одно надсилається на пошту.

Сповіщення відповідального

Після створення ліда через REST автоматично запускається сповіщення відповідальному в Бітрікс24 (якщо на порталі налаштовані сповіщення CRM). Додатково можна поставити задачу з дедлайном 2 години:

$b24->call('tasks.task.add', ['fields' => [ 'TITLE' => 'Відповісти на звернення: ' . $leadData['NAME'], 'RESPONSIBLE_ID' => $assignedId, 'DEADLINE' => date('c', strtotime('+2 hours')), 'UF_CRM_TASK' => ['L_' . $leadId], // прив'язка до ліда ]]); 

Зберігання налаштувань вебхука

URL вебхука Бітрікс24 зберігаємо в налаштуваннях модуля через COption (таблиця b_option), не хардкодимо в коді. Інтерфейс редагування — у розділі «Налаштування → Налаштування продукту → Налаштування модулів».

Що вибрати: лід, угоду чи активність?

Вибір сутності впливає на воронку та навантаження на менеджерів. Лід — повний цикл кваліфікації, потребує часу на конвертацію. Угода — одразу в роботу, але без етапу «розігріву». Активність — мінімальна дія, але не бере участі в звітах по воронці. Для нових клієнтів з високим потенціалом краще лід, для повторних звернень — угода або активність. Порівняння за критеріями: швидкість обробки (активність найшвидша), глибина аналітики (лід дає повну картину), ризик дублів (у активності нижче).

Типові етапи та терміни

Базове налаштування займає від 4 до 6 годин. Складні сценарії (кастомні форми, декілька сайтів, нестандартні поля) — до 2 днів. Пропонуємо налаштування під ключ — оцінимо ваш проект безкоштовно, пишіть нам.

Покрокова інструкція налаштування

1. Створіть вхідний вебхук у Бітрікс24 (Розробникам → REST API → Вебхуки).
2. Налаштуйте права на методи: crm.lead.add, crm.deal.add, crm.duplicate.findByComm, tasks.task.add.
3. Встановіть модуль або додайте обробник в init.php.
4. Налаштуйте обробку дублів перед створенням ліда.
5. Налаштуйте сповіщення відповідального та постановку задач.
6. Протестуйте всі сценарії (успіх, помилка, дубль).

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

• Створення вебхука та налаштування прав.
• Розробка обробника з перевіркою дублів.
• Налаштування сповіщень та постановка задач.
• Документація та навчання менеджерів.
• Підтримка протягом 2 тижнів.

AddMessage2Log('Lead created: ' . print_r($leadData, true), 'b24_integration');