Интеграция веб-форм 1С-Битрикс с CRM Битрикс24
Мы часто видим одну и ту же боль: на сайте настроена удобная форма обратной связи, но менеджеры работают в Битрикс24, а заявки приходят на почту. Данные теряются, воронка продаж не строится, аналитика отсутствует. Например, сотрудник заполняет форму, а менеджер узнаёт о нём через час — лид устарел. Без автоматической передачи лидов каждый звонок или заявка — ручная работа, а конкуренты уже в CRM. Оценки показывают: потери заявок могут достигать 30%.
Стандартный модуль веб-форм 1С-Битрикс (bitrix:main.feedback, bitrix:form.result.new) хранит результаты в таблице b_form_result и отправляет уведомления на почту. Без интеграции с CRM данные остаются в базе сайта — менеджеры не видят их в Битрикс24, история коммуникаций не строится. Согласно официальной документации 1С-Битрикс, событие OnAfterResultAdd модуля form позволяет перехватить данные результата до отправки уведомления.
Почему нативные веб-формы лучше CRM-форм?
CRM-формы Битрикс24 проще в настройке, но их размещение на стороннем домене (b24-cdn.bitrix24.by) негативно влияет на SEO и скорость загрузки. Кроме того, вы не можете кастомизировать внешний вид под дизайн сайта без iframe-обёртки. Нативная веб-форма остаётся на вашем домене, передаёт все UTM-метки и cookie, а стили полностью контролируются шаблоном сайта. По нашему опыту, конверсия таких форм выше на 20–30%.
Как настроить интеграцию: 6 шагов
-
Аудит текущих форм и CRM — определяем, какие формы отправляют данные, и какие поля нужны в CRM.
-
Создание обработчика — подписываемся на событие
OnAfterResultAdd в init.php.
-
Маппинг полей — настраиваем соответствие полей формы и полей лида в конфигурационном массиве.
- Создание пользовательских полей — через REST API
crm.userfield.add для нестандартных данных.
- Дедупликация — проверяем существующих лидов по email/телефону перед созданием.
- Тестирование и деплой — проверяем передачу, файлы и бизнес-процессы.
Обработчик результата веб-формы
Битрикс предоставляет событие OnAfterResultAdd модуля form. Подписываемся в init.php:
AddEventHandler('form', 'OnAfterResultAdd', function($formId, $resultId, $fields) {
// Только для нужных форм
$targetForms = [3, 7, 12]; // ID форм: заявка, консультация, партнёрство
if (!in_array($formId, $targetForms)) return;
$answers = CFormResult::GetDataByID($resultId, [], $arrResult);
$mapped = mapFormAnswers($formId, $answers);
$b24 = new B24Sender(getenv('B24_WEBHOOK_URL'));
$b24->sendLead($mapped);
});
Маппинг полей формы в поля лида
Поля веб-формы хранятся в b_form_field, ответы — в b_form_result_answer. Связь через FIELD_ID. Маппинг настраивается в конфиге:
$formMapping = [
3 => [ // форма «Заявка на звонок»
'q_name' => 'NAME',
'q_phone' => 'PHONE',
'q_comment' => 'COMMENTS',
'utm_source'=> 'UTM_SOURCE',
],
7 => [ // форма «Партнёрство»
'q_company' => 'COMPANY_TITLE',
'q_contact' => 'NAME',
'q_email' => 'EMAIL',
'q_direction' => 'COMMENTS',
],
];
Кейс: многошаговая форма заявки
Из нашей практики — сайт IT-интегратора, форма заявки на проект: 4 шага (тип проекта, бюджет, сроки, контакты). Стандартный модуль веб-форм хранит все ответы в b_form_result_answer. Задача: создать квалифицированный лид в Битрикс24 с заполненными полями и правильной воронкой.
Решение: шаги 1–3 сохраняются в сессию, на шаге 4 отправляется полная форма. В обработчике OnAfterResultAdd собираем все поля, создаём лид с нестандартными полями CRM:
$leadFields = [
'TITLE' => 'Проект: ' . $answers['project_type'],
'OPPORTUNITY' => $answers['budget_from'], // бюджет — в сумму лида
'CURRENCY_ID' => 'RUB',
'UF_CRM_PROJECT_TYPE' => $answers['project_type'],
'UF_CRM_DEADLINE_WEEKS' => $answers['deadline'],
// UF_CRM_* — пользовательские поля лида в Б24
];
Пользовательские поля (UF_CRM_*) предварительно создаём в Битрикс24 через crm.userfield.add. После создания лида — автоматически запускаем бизнес-процесс в Б24 через bizproc.workflow.start. Это гарантирует, что ни одна заявка не потеряется.
Как передать файлы из формы в CRM?
Если форма содержит поле загрузки файла (техзадание, бриф), файл нужно передать в Битрикс24. REST API crm.lead.add не поддерживает бинарную загрузку напрямую — используем disk.folder.uploadfile для загрузки в «Диск» Битрикс24, затем прикрепляем к лиду через crm.activity.add с типом DOCUMENT. Файл появляется в карточке лида, менеджер сразу видит вложение.
Дедупликация лидов
Одна и та же компания нередко заполняет форму несколько раз. Проверяем по email и телефону перед созданием:
$existing = $b24->call('crm.duplicate.findByComm', [
'type' => 'EMAIL',
'values' => [$email],
'entity_type' => 'LEAD',
]);
if (!empty($existing['result']['LEAD'])) {
// Добавляем активность к существующему лиду, не создаём новый
$b24->call('crm.activity.add', [...]);
}
Что входит в работу
| Этап |
Длительность |
Результат |
| Аудит текущих веб-форм и CRM |
1–2 ч |
Схема полей, список форм, требования |
| Настройка обработчика и маппинг |
3–5 ч |
Рабочий обработчик для 1 формы |
| Создание пользовательских полей в CRM |
2–4 ч |
Поля для нестандартных данных |
| Дедупликация и логика повторных обращений |
4–6 ч |
Защита от дублирования лидов |
| Передача файлов из форм |
4–6 ч |
Файлы прикрепляются к лиду |
| Запуск бизнес-процессов по лиду |
3–5 ч |
Автоматическая обработка заявок |
| Документация и обучение |
1–2 ч |
Инструкция для администратора |
Пример настройки пользовательских полей
Допустим, нужно передать тип проекта и желаемые сроки. Через REST API создаём поля `UF_CRM_PROJECT_TYPE` (список) и `UF_CRM_DEADLINE_WEEKS` (число). В обработчике маппинг на эти поля.
Все работы выполняются с гарантией — мы отвечаем за стабильность интеграции и бесперебойную передачу данных. Окупаемость интеграции — от 2 до 4 месяцев в зависимости от нагрузки. Экономия времени менеджеров — до 2 часов ежедневно. Если у вас остались вопросы, свяжитесь с нами — оценим проект за 1 день и предложим оптимальное решение. Закажите интеграцию с гарантией качества.
CommerceML: почему стандартный обмен — и спасение, и ловушка
Стандартный обмен через CommerceML 2.0 на типовой «Управлении торговлей» или «Комплексной автоматизации» заводится за день-два. Товары, цены, остатки, заказы — всё через XML-файлы по расписанию. Для магазина на 3 000 позиций с парой обновлений в сутки этого хватает с запасом. Но как только каталог перерастает 30 000 SKU, начинаются проблемы: интеграция 1С с Битрикс на больших объёмах требует нестандартных решений.
Почему CommerceML тормозит на каталогах свыше 100 000 товаров?
bitrix_1c_exchange.php генерирует XML на стороне Битрикса, 1С забирает и парсит. На больших каталогах парсер активно пишет во временную таблицу b_xml_tree — MySQL может встать колом. Мы видели проект, где стандартный обмен 180 000 товаров занимал 6 часов и полностью блокировал сервер: ни админка, ни фронт не открывались. Решение — инкрементальный обмен. В настройках узла обмена на стороне 1С ставим «Выгружать только изменённые» и разбиваем выгрузку на пакеты по 500–1000 элементов. На стороне Битрикса — кастомный обработчик, который не пересоздаёт b_xml_tree каждый раз, а работает через CIBlockXMLFile::ReadXMLToDatabase() с контролем порций. Каталог в 200 000 SKU обновляется за 8–12 минут.
Ещё один подводный камень — EXTERNAL_ID. При повторном импорте Битрикс сопоставляет элементы инфоблоков по внешнему коду. Если в 1С товар удалён и создан заново с новым GUID, на сайте появляется дубль — со старыми отзывами на одной карточке и нулевыми на другой. Лечится жёсткой привязкой по артикулу через кастомный обработчик события OnBeforeIBlockElementAdd.
Как избежать дублей при повторном импорте?
Привязываем товары не по GUID, а по артикулу. Проверка на уникальность выполняется до записи в инфоблок — дубликаты исключаются даже после пересоздания номенклатуры в 1С. На одном проекте с 50 000 товаров такая схема предотвратила появление 300 дублей в месяц и сэкономила контент-менеджерам около 20 часов ручной чистки.
Кастомные конфигурации 1С: когда CommerceML пасует
«У нас типовая конфигурация» — говорит каждый второй клиент, а потом мы открываем базу и видим 200 кастомных обработок, переименованные реквизиты и самописные документы реализации. CommerceML работает с фиксированной структурой XML. Если в 1С изменили состав реквизитов номенклатуры или добавили нестандартный документ — обмен молча пропускает эти данные. Или падает с непонятной ошибкой в журнале регистрации 1С, а в Битрикс ничего не пишется.
В таких случаях делаем кастомную выгрузку. На стороне 1С пишем обработку, которая формирует JSON (парсить быстрее, отлаживать проще) и отправляет через REST API Битрикса. Полный контроль: какие поля берём, как трансформируем, что делаем при конфликте. Для тяжёлых случаев — D7 API с прямой работой через \Bitrix\Catalog\ProductTable и \Bitrix\Sale\Order.
| Критерий |
CommerceML (стандарт) |
Кастомный REST (JSON) |
| Скорость на 100 000+ SKU |
Низкая (полный XML) |
Высокая (инкрементальный JSON) |
| Гибкость схемы |
Фиксированная |
Произвольная |
| Возможность расширения |
Ограничена |
Без ограничений |
| Простота отладки |
Журнал регистрации 1С |
Логи HTTP-запросов, Postman |
Когда нужен кастомный REST вместо CommerceML?
Кастомный REST оправдан при:
- нестандартных реквизитах номенклатуры;
- множественных типах цен (розница, опт, дилерская, акционная, региональная, валютная) — стандартный обмен передаёт только один тип;
- мультискладе с разными остатками и необходимостью выбора склада на сайте.
Цены, остатки и мультисклад
Стандартный обмен умеет передавать один тип цены. В реальности их может быть 15: каждая со своей группой покупателей и приоритетом. Маппинг между ценовыми группами 1С и группами пользователей Битрикса — отдельная инженерная задача. Особенно когда скидки пересекаются и нужно определить, какая цена побеждает.
Мультисклад добавляет ещё один слой: товар есть на складе в Москве, нет в Питере, и «под заказ» в Новосибирске. На сайте нужно показать наличие по каждой точке, подключить выбор пункта самовывоза и рассчитать доставку от ближайшего склада, где товар физически есть. Стандартный модуль складского учёта Битрикс (catalog.store) справляется с отображением, но логику «откуда отгружать» пишем отдельно. Для одного производственного холдинга мы реализовали кастомный агрегатор остатков, который за 2 секунды рассчитывал баланс по 8 складам — это сократило количество ошибок отгрузки на 80%.
Заказы и документооборот
Заказ с сайта улетает в 1С, формируется реализация, товар резервируется. Статусы возвращаются обратно. Главный нюанс — частичная отгрузка: клиент заказал 5 позиций, 3 есть на складе, 2 придут через неделю. 1С формирует два документа реализации. Битрикс из коробки не умеет разбивать один заказ на несколько отгрузок — дорабатываем обработчик OnSaleOrderSaved, который создаёт дочерние заказы и синхронизирует статусы по каждому.
Документы в личном кабинете — счета, акты, накладные из 1С — отдаём через REST, PDF генерируется на стороне 1С и кэшируется на CDN. Покупатель скачивает не из 1С напрямую (это убило бы сервер), а из кэша.
Рекомендация CommerceML: пакетный импорт с контролем порций снижает нагрузку на MySQL и исключает блокировки (источник: Wikipedia).
Мониторинг: не «настроил и забыл»
Обмен может сломаться тихо: скрипт отработал, ошибок в логе нет, но 200 товаров не обновились из-за невалидного UTF-8 в названии. Или 1С поменяла формат даты в очередном обновлении — все цены пришли нулевыми.
Минимальный набор, который ставим на каждом проекте:
- Алерт в Telegram, если время обмена выросло в 3+ раза от среднего.
- Проверка расхождения остатков: скрипт сравнивает
b_catalog_product.QUANTITY с тем, что отдаёт 1С, и оповещает при дельте больше 5 %.
- Дашборд: последняя синхронизация, количество обработанных позиций, очередь, ошибки.
Для проектов с высокой нагрузкой добавляем асинхронные очереди на Redis или RabbitMQ. Обмен не блокирует веб-сервер, данные не теряются при кратковременном падении 1С. На одном интернет-магазине с оборотами 2 млн заказов в год мы внедрили такую схему — время восстановления после сбоев сократилось с 3 часов до 10 минут.
Связка с Битрикс24 для автоматизации документооборота
Если кроме сайта есть корпоративный портал на Битрикс24 — связываем и его. Контрагенты из CRM летят в 1С, счета из 1С появляются в карточке сделки. Менеджер видит дебиторку и взаиморасчёты, не переключаясь между окнами. Закрыли сделку — документы сформировались сами.
Оплата поступила в 1С → логист получает задачу на отгрузку в Битрикс24. Товар отгружен → менеджер видит уведомление. Автоматические задачи по событиям из 1С — через вебхуки Битрикс24 REST API. Такая связка сокращает ручной ввод на 70% и исключает забытые отгрузки.
Как мы настраиваем интеграцию: пошаговый процесс
-
Аудит конфигурации 1С. Смотрим структуру справочников, документов, реквизитов. Выявляем кастомные доработки. Оцениваем объём данных (количество SKU, заказов, складов).
-
Проектирование схемы обмена. Согласовываем набор данных: товары, цены, остатки, заказы, документы. Определяем интервал синхронизации и механизм — CommerceML или кастомный REST.
-
Настройка стандартного обмена. Настраиваем CommerceML, пакетный режим, привязку по артикулу. Проверяем корректность передачи данных на тестовом каталоге.
-
Расширенная интеграция. Для сложных конфигураций пишем кастомные обработчики на стороне 1С и Битрикса. Подключаем мультисклад, множественные цены, частичную отгрузку.
-
Мониторинг и гарантия. Устанавливаем алерты, дашборд, документацию. Обучаем операторов. После запуска — гарантийная поддержка.
Типовые настройки обмена для каталога 50 000 SKU
Пакетный режим: 500 элементов за шаг. Привязка по артикулу. Период синхронизации: каждые 15 минут. Используем агенты Битрикса с тегированным кэшированием. На стороне 1С — обработка формирования JSON вместо XML для ускорения.
Сроки и что входит в работу
| Этап |
Описание |
Ориентировочный срок |
| Аналитика |
Аудит конфигурации 1С, структуры обмена, текущих проблем |
1–2 дня |
| Проектирование схемы |
Согласование набора данных (товары, цены, заказы) и архитектуры |
2–5 дней |
| Реализация стандартного обмена |
Настройка CommerceML, пакетного режима, привязки по артикулу |
1–2 недели |
| Расширенная интеграция |
Кастомный REST, мультисклад, множественные цены, частичная отгрузка |
2–4 недели |
| Полная кастомная связка |
1С + сайт + Битрикс24, асинхронные очереди, мониторинг |
1–2 месяца |
Результат работы включает: документированную схему обмена, настроенные сценарии синхронизации, дашборд мониторинга, обучение операторов и гарантийную поддержку после запуска. Стоимость рассчитывается индивидуально — она зависит от сложности конфигурации 1С, объёма каталога и необходимой степени автоматизации. Оценим ваш проект за 1 день — пишите, обсудим. Закажите интеграцию — получите стабильный обмен за 1–2 недели.
Мы провели более 50 интеграций 1С для интернет-магазинов и производственных компаний. Средний опыт команды — 7 лет, у нас есть сертифицированные специалисты 1С-Битрикс. Наш опыт гарантирует, что обмен не сломается в первый же месяц и будет стабильно работать годами. Например, на проекте с каталогом 50 000 товаров автоматизация обмена сэкономила клиенту около 200 000 рублей в год на операционных затратах.
Свяжитесь с нами для бесплатного аудита вашей конфигурации 1С — найдём узкие места и предложим оптимальное решение.