Налаштування передачі замовлень з сайту в CRM Бітрікс24
Замовлення оформлено на сайті, а в CRM порожньо. Менеджер вручну копіює дані — 30 хвилин на кожне замовлення. При 20 замовленнях на день це 10 годин втрат. Клієнт передзвонює, а історії немає. Зв'язати сайт і Бітрікс24 через подію OnSaleOrderSaved та REST API — завдання на кілька годин, яке економить десятки людино-годин щомісяця. Ми, сертифіковані спеціалісти з Бітрікс24 з досвідом понад 6 років, впровадили більше 50 таких інтеграцій. Гарантуємо стабільну роботу без втрати даних та з мінімальними доробками. Оцінимо ваш проект за один день — замовте консультацію.
Передача замовлень в CRM: чому це важливо?
Без автоматичної передачі угод менеджери працюють наосліп. Контакт створюється вручну, статуси не синхронізуються, аналітика відсутня. У підсумку — втрачені ліди та зниження LTV. Інтеграція через REST API вирішує ці проблеми: всі дані клієнта, сума та склад замовлення одразу потрапляють у воронку. Скорочення часу обробки замовлення досягає 80% — це не просто зручність, а прямий ріст конверсії. Ручне введення займає 30 хвилин, автоматизація — 3 хвилини, у 10 разів швидше. Автоматизація зменшує кількість помилок у 20 разів порівняно з ручним введенням. Економія на операційних витратах може становити до 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
| Поле замовлення (властивість) | Поле контакту (CRM) | Коментар |
|---|---|---|
| NAME | NAME + LAST_NAME | Розділення по пробілу (опціонально) |
| PHONE | PHONE[0].VALUE | Номер з кодом країни |
| EMAIL[0].VALUE | Основний email | |
| Примітка | UF_CRM_ORDER_COMMENT | Користувацьке поле, якщо потрібно |
Для угоди аналогічно: сума замовлення → OPPORTUNITY, статус → STAGE_ID.
Налаштування мапінгу статусів
| Статус замовлення | Код статусу | Стадія угоди Б24 |
|---|---|---|
| Новий | N | NEW |
| Підтверджений | P | PREPARATION |
| Оплачений | A | EXECUTING |
| Відвантажений | D | FINAL_INVOICE |
| Завершений | F | WON |
| Скасований | C | LOSE |
При зміні статусу замовлення на сайті — викликаємо 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 секунди.
Типові помилки та їх вирішення
- Відсутність перевірки дублів контактів — призводить до засмічення CRM. Рішення: завжди викликати
crm.duplicate.findByComm. - Неправильний мапінг статусів: наприклад, якщо у воронці кілька стадій і код статусу не відповідає. Рішення: узгодити мапінг до запуску.
- Перевищення лімітів запитів до REST API. Рішення: використовувати чергу агентів і не більше 2 запитів на секунду.
- Ігнорування користувацьких полів: якщо в замовленні є кастомні властивості, їх треба явно мапити в UF_CRM_*.
Наш підхід та процес
Ми використовуємо стек: 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 запитів на секунду. За 6+ років на ринку ми реалізували понад 50 інтеграцій, обслуговуємо понад 20 постійних клієнтів. Маємо сертифікацію Бітрікс24.
Етапи роботи
- Аналітика — вивчаємо структуру замовлень, воронку продажів, виявляємо нестандартні поля.
- Проектування — складаємо схему мапінгу полів і статусів, узгоджуємо з вами.
- Реалізація — пишемо обробник, налаштовуємо вебхук, тестуємо на тестовому замовленні.
- Тестування — перевіряємо створення/оновлення угод, дублі, обробку помилок.
- Деплой — викочуємо на бой, моніторимо логи перший день, даємо гарантію на роботу.
Терміни орієнтовно
Базове налаштування передачі нових замовлень — 6–8 годин. Повна двостороння синхронізація статусів — 2–3 робочих дні. Вартість базової інтеграції від 15 000 грн. Вартість розраховується індивідуально після аудиту вашого сайту. Оцінимо проект безкоштовно — замовте консультацію.
Що входить у роботу?
- Документація з інтеграції (схема мапінгу, опис обробників)
- Налаштування вебхука та прав доступу
- Розробка та тестування обробника подій
- Навчання менеджерів роботі з інтеграцією
- Підтримка протягом 30 днів після запуску
Ми надаємо письмову гарантію на безперебійну роботу.
Типові проблеми виникають через відсутність перевірки дублів або невірного мапінгу статусів. Наш досвід показує: 80% помилок вирішуються додаванням перевірок та асинхронною обробкою. Ми гарантуємо стабільну інтеграцію та підтримку після запуску. Зв'яжіться з нами для детального аудиту вашої системи.