Форма зворотного зв'язку на сайті надсилає листа адміністратору — і на цьому все закінчується. Немає задачі менеджеру, немає історії в 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), не хардкодимо в коді. Інтерфейс редагування — у розділі «Налаштування → Налаштування продукту → Налаштування модулів».
Що вибрати: лід, угоду чи активність?
Вибір сутності впливає на воронку та навантаження на менеджерів. Лід — повний цикл кваліфікації, потребує часу на конвертацію. Угода — одразу в роботу, але без етапу «розігріву». Активність — мінімальна дія, але не бере участі в звітах по воронці. Для нових клієнтів з високим потенціалом краще лід, для повторних звернень — угода або активність. Порівняння за критеріями: швидкість обробки (активність найшвидша), глибина аналітики (лід дає повну картину), ризик дублів (у активності нижче).
Типові етапи та терміни
| Етап | Тривалість | Зміст |
|---|---|---|
| Аналіз форм і вибір компонента | 1 год | Аудит поточних форм, узгодження полів |
| Створення вебхука та налаштування прав | 30 хв | Створення вхідного вебхука, права на методи |
| Розробка обробника (PHP) | 2-3 год | Код в init.php або модуль, перевірка дублів |
| Налаштування сповіщень і задач | 1 год | Push-сповіщення, постановка задач з дедлайном |
| Тестування та налагодження | 1-2 год | Перевірка всіх сценаріїв: успіх, помилка, дубль |
Базове налаштування займає від 4 до 6 годин. Складні сценарії (кастомні форми, декілька сайтів, нестандартні поля) — до 2 днів. Пропонуємо налаштування під ключ — оцінимо ваш проект безкоштовно, пишіть нам.
Покрокова інструкція налаштування
- Створіть вхідний вебхук у Бітрікс24 (Розробникам → REST API → Вебхуки).
- Налаштуйте права на методи: crm.lead.add, crm.deal.add, crm.duplicate.findByComm, tasks.task.add.
- Встановіть модуль або додайте обробник в init.php.
- Налаштуйте обробку дублів перед створенням ліда.
- Налаштуйте сповіщення відповідального та постановку задач.
- Протестуйте всі сценарії (успіх, помилка, дубль).
Що входить в роботу?
- Створення вебхука та налаштування прав.
- Розробка обробника з перевіркою дублів.
- Налаштування сповіщень та постановка задач.
- Документація та навчання менеджерів.
- Підтримка протягом 2 тижнів.
Приклад логування запитів до REST API
Для налагодження додайте в обробник запис до логу:
AddMessage2Log('Lead created: ' . print_r($leadData, true), 'b24_integration');
Лог можна переглянути в адміністративному розділі: Налаштування → Налаштування продукту → Журнал подій.
Наш досвід та гарантії
Ми працюємо з Бітрікс24 понад 7 років і виконали 50+ інтеграцій зворотного зв'язку для компаній різного масштабу — від інтернет-магазинів до виробничих підприємств. Гарантуємо коректну роботу всіх механізмів: створення лідів, обробку дублів, сповіщення. Після запуску надаємо супровід протягом 2 тижнів. Замовте налаштування зворотного зв'язку з CRM під ключ — перетворіть просту форму на керований канал продажів. Оцінимо ваш проект безкоштовно, пишіть нам.