Настройка передачи заказов с сайта в CRM Битрикс24

Настройка передачи заказов с сайта в CRM Битрикс24

Заказ оформлен на сайте, но в CRM пусто. Менеджер вручную копирует данные — 30 минут на каждый заказ. При 20 заказах в день это 10 часов потерь. Клиент перезванивает, а истории нет. Связать сайт и Битрикс24 через событие OnSaleOrderSaved и REST API — задача на несколько часов, которая экономит десятки человеко-часов ежемесячно. Мы, сертифицированные специалисты по Битрикс24 с опытом более 6 лет, внедрили более 50 таких интеграций. Гарантируем стабильную работу без потери данных и с минимальными доработками. Оценим ваш проект за один день — закажите консультацию.

Передача заказов в CRM: почему это важно?

Без автоматической передачи сделок менеджеры работают вслепую. Контакт создаётся вручную, статусы не синхронизируются, аналитика отсутствует. В итоге — потерянные лиды и снижение LTV. Интеграция через REST API решает эти проблемы: все данные клиента, сумма и состав заказа сразу попадают в воронку. Сокращение времени обработки заказа достигает 80% — это не просто удобство, а прямой рост конверсии. Ручной ввод занимает 30 минут, автоматизация — 3 минуты, в 10 раз быстрее. Экономия на операционных расходах может составлять до 150 000 рублей в месяц при 30 заказах ежедневно. При объёме 50 заказов в день экономия превышает 200 000 рублей в месяц.

Как реализовать интеграцию?

Что передаётся в CRM

При создании заказа мы формируем в Битрикс24:

• Контакт (crm.contact.add) — с именем, телефоном, email.
• Сделку (crm.deal.add) — с суммой, статусом и привязкой к контакту.
• Товарные позиции (crm.deal.productrows.set) — список товаров с количеством и ценой.

Для юридических лиц дополнительно создаётся Компания (crm.company.add) и привязывается через COMPANY_ID.

Обработчик события заказа

// В init.php или обработчике модуля
AddEventHandler('sale', 'OnSaleOrderSaved', 'onOrderSavedHandler');

function onOrderSavedHandler($order) {
    $isNew = $order->isNew();
    if (!$isNew) return; // обрабатываем только новые заказы

    $orderId    = $order->getId();
    $orderProps = $order->getPropertyCollection();
    $basket     = $order->getBasket();

    // Собираем данные покупателя из свойств заказа
    $name  = $orderProps->getItemByOrderPropertyCode('NAME')->getValue();
    $phone = $orderProps->getItemByOrderPropertyCode('PHONE')->getValue();
    $email = $orderProps->getItemByOrderPropertyCode('EMAIL')->getValue();

    // Передаём в Б24
    $b24 = new B24Integration();
    $contactId = $b24->findOrCreateContact($phone, $email, $name);
    $dealId    = $b24->createDeal($orderId, $order->getPrice(), $contactId);
    $b24->setDealProducts($dealId, $basket);
}

Маппинг полей заказа и CRM

Для сделки аналогично: сумма заказа → OPPORTUNITY, статус → STAGE_ID.

Настройка маппинга статусов

При смене статуса заказа на сайте — вызываем crm.deal.update с новой стадией. ID сделки Битрикс24 сохраняем в свойстве заказа B24_DEAL_ID или в b_sale_order_props_value. Экономия времени: вместо 5 минут ручного обновления — 0.5 секунды автоматически.

Хранение связки заказ–сделка

// Сохраняем ID сделки в свойствах заказа
$dealProp = $orderProps->getItemByOrderPropertyCode('B24_DEAL_ID');
if ($dealProp) {
    $dealProp->setValue($dealId);
    $order->save();
}

Товарные позиции

crm.deal.productrows.set заменяет весь список позиций сделки. Каждая позиция:

$products[] = [
    'PRODUCT_NAME' => $basketItem->getField('NAME'),
    'PRICE'        => $basketItem->getPrice(),
    'QUANTITY'     => $basketItem->getQuantity(),
    'CURRENCY_ID'  => 'RUB',
    'PRODUCT_ID'   => 0, // если нет каталога в Б24 — 0
];

Если в Битрикс24 есть каталог товаров и он синхронизирован с сайтом через CommerceML, передаём реальный PRODUCT_ID для корректной аналитики по товарам.

Как избежать дублей контактов?

При повторном заказе того же клиента проверяем наличие контакта через crm.duplicate.findByComm по телефону. Если контакт существует — используем его ID, не создаём дубль. Новая сделка привязывается к существующему контакту. Согласно документации Битрикс24 REST API, метод crm.duplicate.findByComm позволяет избежать дубликатов. Ручная проверка занимает 5 минут на заказ, автоматическая — 0.5 секунды.

Типичные ошибки и их решения

Наш подход и процесс

Мы используем стек: PHP 8.1+, инфоблоки v2.0, ORM Битрикс, REST API (cloud или on-premise). Обработчики обёрнуты в try-catch, ошибки пишутся в HL-блок. На вебхуке выставляются права: crm.contact.add, crm.deal.add, crm.deal.update, crm.duplicate.findByComm, crm.deal.productrows.set. Соблюдаем лимиты — не более 2 запросов в секунду.

Этапы работы

1. Аналитика — изучаем структуру заказов, воронку продаж, выявляем нестандартные поля.
2. Проектирование — составляем схему маппинга полей и статусов, согласовываем с вами.
3. Реализация — пишем обработчик, настраиваем вебхук, тестируем на тестовом заказе.
4. Тестирование — проверяем создание/обновление сделок, дубли, обработку ошибок.
5. Деплой — выкатываем на бой, мониторим логи первый день, даём гарантию на работу.

Сроки ориентировочно

Базовая настройка передачи новых заказов — 6–8 часов. Полная двусторонняя синхронизация статусов — 2–3 рабочих дня. Стоимость рассчитывается индивидуально после аудита вашего сайта. Оценим проект бесплатно — закажите консультацию.

Типичные проблемы возникают из-за отсутствия проверки дубликатов или неверного маппинга статусов. Наш опыт показывает: 80% ошибок решаются добавлением проверок и асинхронной обработкой. Мы гарантируем стабильную интеграцию и поддержку после запуска. Свяжитесь с нами для детального аудита вашей системы.