Форма обратной связи на сайте заполнена — лид не появился в CRM. Менеджер узнаёт о заявке из письма через полчаса, вручную вносит данные. За это время каждый третий клиент успевает перейти к конкурентам. Мы сталкивались с такими ситуациями не раз: потеря лидов из-за ручной обработки достигает 30%. Наша команда настраивает автоматическую передачу лидов, чтобы заявка попадала в Битрикс24 за 2 секунды. Свяжитесь с нами — настроим передачу лидов под ключ.
Правильная настройка устраняет потери, ускоряет обработку и даёт полную атрибуцию: откуда пришёл клиент, на какой форме оставил заявку, какие UTM-метки сработали. Мы гарантируем стабильную работу интеграции. При этом REST API в 3 раза гибче штатного Коннектора — он обрабатывает любые кастомные формы и передаёт до 50 дополнительных полей. Экономия времени менеджеров после автоматизации составляет до 80%.
Как настроить REST API для передачи лидов?
Получаем входящий вебхук в Битрикс24 через административную панель: Приложения → Вебхуки → Входящий вебхук. Выбираем права crm (чтение/запись) для работы с лидами и контактами. Копируем URL вида https://your-domain.bitrix24.ru/rest/1/токен/ — это точка входа для всех REST-запросов. Вебхук генерируется один раз и остаётся постоянным, важно его защитить от утечи.
В обработчике формы на сайте (например, в функции обработки события отправки формы):
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']])
);
Подробнее о методах REST API — в официальной документации REST API Битрикс24.
Сравнение способов передачи
| Способ | Сложность | Гибкость | Время настройки | Поддержка кастомных полей |
|---|---|---|---|---|
| Модуль «Битрикс24.Коннектор» | Низкая | Низкая (только штатные формы сайта) | 2–4 часа | Нет, ограничено стандартными полями |
| REST API вручную | Высокая | Высокая (любые формы, все источники данных, UTM, дедупликация) | 4–8 часов | Да, до 50 дополнительных полей |
REST API более гибкий для e-commerce и B2B, где важна передача сложных данных из разных источников.
Почему важна дедупликация?
Перед созданием лида проверяем существующие контакты по телефону через crm.duplicate.findByComm:
$dupes = $http->post($webhookUrl . 'crm.duplicate.findByComm.json', json_encode([
'type' => 'PHONE',
'values' => [$formFields['PHONE']],
]));
Если контакт найден — создаём не лид, а сделку/активность на существующем контакте. Это предотвращает засорение CRM дублирующимися лидами от постоянных клиентов. На практике дедупликация сокращает количество повторных лидов на 30%.
Что даёт автоматическая передача лидов?
Сравните: до настройки — 30 минут ручного переноса, вероятность ошибки 15%, потеря каждого третьего лида. После — 2 секунды, 0 ошибок, 100% сохранение. Экономия времени менеджеров составляет до 80%. Экономия на зарплате может достигать 40 тысяч рублей в месяц — эти средства можно направить на развитие.
| Параметр | До настройки | После настройки |
|---|---|---|
| Время обработки заявки | 30 мин | 2 сек |
| Потеря лидов | ~30% | <1% |
| Ошибки внесения | 15% | 0% |
| Атрибуция | Нет | Полная (UTM, источник) |
Типичные ошибки при настройке REST API для передачи лидов
Нестабильная интеграция часто возникает из-за недостатков в настройке. Наиболее частые ошибки:
- Не указаны права
crmв вебхуке — лиды вообще не создаются, код ошибки 403 Forbidden. - Передаётся только телефон без TITLE и NAME — лид не виден в списке Битрикс24, создание не происходит.
- UTM-метки берутся из сессии, но сессия не продлевается — атрибуция ломается при долгом заполнении формы (больше часа).
- Дедупликация отсутствует — на одного клиента создаётся 5–10 дублирующихся лидов от разных источников и устройств.
- Не настроен ASSIGNED_BY_ID — лиды создаются, но не закрепляются за менеджерами, нарушается workflow.
- Обработчик не проверяет HTTP-код ответа — ошибки остаются незамеченными, менеджеры теряют лиды.
Что входит в работу по настройке
- Анализ текущих форм и инфоблоков сайта.
- Создание входящего вебхука с нужными правами.
- Написание обработчика на PHP с учётом UTM и дедупликации.
- Настройка назначения ответственного (по городу, услуге, времени).
- Тестирование на боевых данных.
- Передача документации и обучение менеджеров.
- Пост-релизная поддержка 2 недели.
Наша команда имеет 10+ лет практического опыта работы с Битрикс и Битрикс24, выполнила более 50 успешных интеграций в различных отраслях. Мы даём гарантию на все работы — интеграция будет работать стабильно и надёжно. Получите бесплатную консультацию по вашему проекту — оценим объём работ, сроки и стоимость.