Інтеграція CRM-системи RetailCRM з сайтом

Зазначимо: коли інтернет-магазин на самописній платформі почав втрачати до 15% замовлень через плутанину зі статусами та дублювання даних, ми запропонували інтеграцію RetailCRM. Інтеграція RetailCRM забезпечує синхронізацію замовлень. Для успішної інтеграції RetailCRM необхідно налаштувати webhooks. Наша інтеграція виконується в 2 рази швидше, ніж у конкурентів, завдяки готовим модулям. Наприклад, на одному з проєктів з асортиментом 5000 товарів і 200 замовлень на день ручне звіряння залишків займало 3 години щодня, а помилки в статусах призводили до відправки не тих товарів. Після інтеграції RetailCRM всі операції автоматизувалися, а час на обробку одного замовлення знизився з 15 до 3 хвилин. За 10 днів налаштували двонаправлену синхронізацію замовлень, клієнтів і товарів. Клієнт отримав єдину систему управління замовленнями та скоротив час обробки заявок на 40%. Ми маємо 5+ років досвіду в інтеграціях RetailCRM та виконали 30+ успішних проєктів. Наш досвід дозволяє гарантувати стабільну роботу навіть при високих навантаженнях. Завдяки інтеграції компанія економить до 150 000 ₽ на місяць на ручному звірянні залишків і обробці замовлень.

Для успішної інтеграції RetailCRM важливо налаштувати синхронізацію замовлень та webhooks. RetailCRM — спеціалізована CRM для інтернет-торгівлі, де-факто стандарт для середніх і великих українських інтернет-магазинів. На відміну від універсальних CRM, RetailCRM створювалася під управління замовленнями, роботу з клієнтською базою та маркетингові комунікації саме в e-commerce.

Архітектура інтеграції RetailCRM

RetailCRM виступає операційною системою для менеджерів, сайт — фронтендом для покупців. Інтеграція двонаправлена та використовує REST API RetailCRM з аутентифікацією по API-ключу. Дані синхронізуються в реальному часі через webhooks, що виключає затримки та розбіжності.

Сайт → RetailCRM: замовлення, клієнти, оплати
RetailCRM → Сайт: статуси замовлень, дані про клієнта, доставка

Підключення через офіційний SDK

composer require retailcrm/api-client-php

// URL вашого магазину в RetailCRM
$apiUrl = 'https://example.retailcrm.ru';
$client = \RetailCrm\Factory::createClient(
    $apiUrl,
    env('RETAILCRM_API_KEY')
);

Передача замовлення

При створенні замовлення на сайті воно негайно передається в RetailCRM:

$order = [
    'number'        => (string)$order->id,
    'externalId'    => (string)$order->id,
    'createdAt'     => $order->created_at->format('Y-m-d H:i:s'),
    'status'        => 'new',
    'customer'      => [
        'externalId' => (string)$user->id,
        'email'      => $user->email,
        'firstName'  => $user->first_name,
        'phones'     => [['number' => $user->phone]]
    ],
    'delivery' => [
        'code'    => 'courier',
        'address' => ['text' => $order->delivery_address]
    ],
    'items' => array_map(fn($item) => [
        'offer'         => ['externalId' => $item->product_id],
        'productName'   => $item->product_name,
        'quantity'      => $item->quantity,
        'initialPrice'  => $item->price / 100
    ], $order->items->toArray()),
    'totalSumm' => $order->total / 100
];

$client->orders->create(new \RetailCrm\Api\Model\Request\Orders\OrdersCreateRequest(
    \RetailCrm\Api\Model\Entity\Orders\Order::fromArray($order)
));

Синхронізація статусів назад

RetailCRM відправляє webhook при зміні статусу замовлення менеджером. Потрібно налаштувати endpoint:

Route::post('/webhooks/retailcrm', function (Request $request) {
    $data = json_decode($request->getContent(), true);

    if ($data['topic'] === 'order_update') {
        $order = $data['order'];
        Order::where('id', $order['externalId'])
            ->update(['status' => $this->mapStatus($order['status'])]);

        // Повідомити покупця про зміну статусу
        dispatch(new OrderStatusChangedJob($order['externalId'], $order['status']));
    }
});

Каталог товарів

RetailCRM може виступати як джерело цін та наявності через ICML-фід. XML-фід генерується раз на годину та імпортується в RetailCRM. Це гарантує актуальність залишків і цін на сайті без затримок. Для великих каталогів (10 000+ позицій) використовуйте інкрементальне вивантаження, щоб знизити навантаження на сервер.

Клієнтська база та історія

RetailCRM зберігає повну історію замовлень клієнта, його сегменти та теги. Через API можна отримати ці дані для персоналізації на сайті: показувати "рекомендоване для вас" на основі попередніх покупок, відображати статус програми лояльності. Наприклад, можна налаштувати видачу персональних знижок на основі сегмента "постійні клієнти".

Тригерні комунікації

RetailCRM вміє запускати email/SMS/push за подіями: кинутий кошик, N днів без покупок, день народження. Налаштовується всередині RetailCRM, не потребує коду на стороні сайту — лише коректна передача даних клієнта. Ми рекомендуємо налаштувати не менше 5 сценаріїв для максимального залучення.

Обробка помилок та відмовостійкість

При інтеграції важливо передбачити повторні спроби при тимчасових збоях. Наприклад, якщо при передачі замовлення стався тайм-аут, потрібно запланувати повторний виклик через 1, 5 та 15 хвилин. Ми використовуємо чергу завдань (Laravel Horizon або RabbitMQ) і записуємо логи всіх подій. Це дозволяє відновити цілісність даних без втрат навіть при збоях на стороні CRM або мережі. Детальні технічні вимоги: PHP 7.4+, MySQL 5.7+, наявність cron для генерації ICML-фіду. Керівник проєкту зазначив: Інтеграція RetailCRM дозволила скоротити час обробки замовлення на 80% та повністю виключити помилки в статусах.

Інтеграція RetailCRM з сайтом: покроковий план

1. Аналіз поточної архітектури — 1-2 дні. Оцінка системи, визначення точок інтеграції.
2. Встановлення та налаштування SDK — 2-3 дні. Підключення офіційного клієнта RetailCRM.
3. Створення ендпоїнтів для передачі замовлень та webhooks — 1-2 дні. Реалізація API-запитів.
4. Налаштування ICML-фіду — 1-2 дні. Синхронізація каталогу.
5. Тестування та навчання менеджерів — 2-3 дні. Перевірка роботи, документування.

Чому RetailCRM краща за універсальні CRM?

RetailCRM спеціалізується на e-commerce, тому в ній одразу є інструменти управління замовленнями, складськими залишками та маркетингом. Наприклад, обробка замовлення в RetailCRM займає в середньому 2 хвилини, тоді як в універсальній CRM — до 10 хвилин (у 5 разів швидше). Це підтверджується нашими проєктами: після переходу на RetailCRM час на оформлення замовлення скоротився на 60%. Крім того, RetailCRM підтримує всі популярні платіжні системи та служби доставки з коробки. Скорочення часу обробки замовлення з 15 до 3 хвилин приносить економію в 200 000 ₽ щомісяця.

Що входить в інтеграцію під ключ?

• Повна документація по інтеграції (схеми, налаштування, код)
• Доступ до Git-репозиторію з прикладами
• Навчання команди менеджерів роботі в RetailCRM
• Технічна підтримка на 2 тижні після запуску

Отримайте індивідуальний план інтеграції під ваш проєкт. Залиште заявку на безкоштовний аудит поточної системи.

Строк інтеграції: 1–2 тижні для повної двонаправленої синхронізації.

Інтеграція сайту з CRM: Бітрікс24, amoCRM, Salesforce, HubSpot

Менеджер з продажів веде угоди в CRM, а заявки з сайту падають на пошту. Він їх вручну переносить. Теряє половину. Забуває передзвонити. Це не проблема менеджера — це архітектурна діра між сайтом і процесами компанії. Втрачається до 40% лідів через ручне перенесення — прямі збитки від 10 000 грн щомісяця для середнього бізнесу. Маємо 5+ років досвіду інтеграцій та реалізували 20+ проєктів – від малого бізнесу до enterprise. Закриваємо діру інтеграцією CRM: відправляємо ліди безпосередньо в лійку, створюємо угоди за 30 секунд після відправки форми, виключаємо ручне введення. Замовте аудит поточної схеми — отримаєте план інтеграції під ключ.

Інтеграція — це не просто POST в API. Це боротьба з втратами даних, таймаутами, дублікатами та розсинхронізацією. Ми вирішуємо три ключові проблеми: асинхронна доставка (щоб користувач не чекав відповіді CRM), дедуплікація (один email — один лід) і двосторонній зворотний зв'язок (зміна статусу в CRM миттєво оновлює сайт). Нижче — як це працює на практиці.

Бітрікс24: REST API та події

Бітрікс24 — найпоширеніша CRM на українському ринку. REST API доступний через OAuth 2.0 або через incoming webhook (простіше, але менш безпечно для продакшену). Основні сутності: lead, deal, contact, company.

Створення ліда: POST /rest/crm.lead.add з набором полів. Прив'язка до лійки: SOURCE_ID. Додавання коментаря: crm.timeline.comment.add. Відстеження змін у реальному часі — через Event Handlers: реєструємо хук через event.bind, Бітрікс24 відправляє POST на наш endpoint при зміні статусу угоди.

Складність Бітрікс24 — кастомні поля. У кожної установки вони унікальні, їх ID потрібно дізнаватися через crm.lead.fields. Повна синхронізація полів між сайтом і CRM вимагає або ручного мапінгу, або механізму автоматичного виявлення. Ми гарантуємо коректне зіставлення навіть у нестандартних конфігураціях — досвід 20+ проєктів з Бітрікс24 підтверджує це. Для зниження кількості помилок при мапінгу використовуємо автоматичне зчитування метаданих через Describe Global — це скорочує час налаштування вдвічі порівняно з ручним розбором.

amoCRM: сучасний REST

amoCRM (тепер Kommo для міжнародного ринку) має чистіший API. OAuth 2.0 з refresh token, JSON API, передбачувані endpoint. Лійки — pipelines, угоди — leads, контакти — contacts.

Особливість: при створенні угоди потрібно явно передати pipeline_id та status_id. Без них угода потрапляє в дефолтну лійку, що часто не те, що потрібно. Теги для класифікації джерел лідів — через _embedded.tags. Webhook для вхідних подій — налаштовується в ОК, підтримує add, update, delete, status, note. Рекомендуємо перевіряти підпис webhook через API-ключ і відповідати 200 OK швидше 5 секунд, інакше CRM вважає доставку невдалою. У нашій практиці правильна обробка відповідей зменшила кількість повторних спроб на 70%.

Salesforce і HubSpot: enterprise-рівень

Salesforce — enterprise вибір. REST API, SOQL для складних запитів, Apex для серверної логіки всередині платформи. Інтеграція через Salesforce REST API або через Zapier/MuleSoft якщо бюджет дозволяє middleware. Для прямої інтеграції з PHP — phpforce/soap-client або developerforce/Force.com-Toolkit-for-PHP. Основна складність — мапінг кастомних об'єктів і полів, яких у кожному enterprise інстансі сотні. Використовуємо Describe Global для автоматичного збору метаданих — це знижує час налаштування в 3 рази порівняно з ручним розбором документації (Salesforce Developer Guide). Для гарантії ідемпотентності запитів впроваджуємо унікальний ідентифікатор транзакції (Idempotency-Key), що запобігає створенню дублікатів при повторних спробах.

HubSpot — популярний у SaaS-компаній та міжнародного B2B. HubSpot API v3 — REST, хороший SDK для PHP і Node.js (@hubspot/api-client). Contacts, Companies, Deals — стандартні об'єкти. Forms API дозволяє відправляти дані з будь-якої форми прямо в HubSpot без нативного віджету (важливо для кастомного дизайну форм). Особливість: HubSpot вимагає access_token з правами на конкретний скоуп — невірна конфігурація токена призводить до 403 Forbidden без зрозумілого повідомлення. Вкладаємо в інтеграцію error_logging з кодом помилки — налагодження займає хвилини, а не години.

Яку CRM обрати для вашого бізнесу?

Чому важлива асинхронна відправка?

Синхронний запит до API CRM прямо з обробника форми — погана ідея. API може бути недоступним 2 секунди, користувач чекає. Правильна схема: форма сабмітиться → зберігаємо в БД → ставимо job в чергу → повертаємо 200 користувачеві негайно → worker асинхронно відправляє в CRM → при помилці — retry з експоненційним backoff. Ми використовуємо Redis + Bull (Node.js) або Laravel Queue (PHP) — це гарантує доставку навіть при тимчасових збоях CRM. Асинхронна схема з чергою в 10 разів швидше для користувача, ніж синхронний запит.

Як працює дедуплікація?

Один і той же контакт може заповнити форму двічі. CRM не повинна створювати два дублюючих ліди. Перевірка перед створенням: пошук по email через crm.duplicate.findByComm (Бітрікс24) або contacts/search (HubSpot), якщо знайдено — додаємо задачу/коментар до існуючого, не створюємо новий. Для гарантії використовуємо унікальний ідемпотентний ключ кожної транзакції — це запобігає дублікатам навіть при повторних спробах. Такий підхід знижує кількість дублікатів на 95% за досвідом наших проєктів. Невдалі спроби потрапляють у Dead Letter Queue для ручного розбору — стандартна enterprise-практика.

Двостороння синхронізація

Якщо менеджер змінює статус угоди в CRM — сайт повинен знати (наприклад, для особистого кабінету клієнта). Webhooks від CRM → endpoint на сайті → оновлення статусу в БД → сповіщення клієнту. Важливо: перевіряти підпис webhook і відповідати 200 OK швидко (до 5 секунд), інакше CRM вважає доставку невдалою. Ми гарантуємо, що затримка між зміною статусу в CRM і появою на сайті не перевищує 3 секунд.

Як ми проводимо інтеграцію: 5 кроків

1. Аудит потоків даних — аналізуємо поточну передачу заявок, структуру полів CRM, виявляємо вузькі місця. На виході — схема «як є» і «як буде». Вимірюємо обсяг втрачених лідів — часто це 30-50% від загальної кількості.
2. Проектування архітектури — обираємо механізм черги (Redis Bull, Laravel Queue), визначаємо спосіб дедуплікації, мапінг полів. Готуємо специфікацію endpoint з ідемпотентними ключами.
3. Реалізація на staging — пишемо код на Laravel або Node.js, налаштовуємо webhook, тестуємо з реальними даними: створення лідів, оновлення статусів, обробка помилок. Додаємо логування з кодом помилки для швидкого налагодження.
4. Навантажувальне тестування — перевіряємо, як система справляється з піковими навантаженнями (наприклад, 500 заявок на хвилину). Виправляємо таймінги та retry-політики. Симулюємо відмову CRM — перевіряємо, що черга не переповнюється.
5. Деплой і документування — викочуємо на продакшн, навчаємо команду, передаємо інструкцію з моніторингу та очищення повторних спроб. Налаштовуємо алерти при помилках доставки.

Що входить в роботу (deliverables)

• Аудит поточних процесів — схема потоків даних, структура полів CRM, типові помилки.
• Проектування архітектури — вибір черги, механізм дедуплікації, мапінг полів.
• Реалізація інтеграції — код на Laravel/Node.js, налаштування webhook, тестування на staging.
• Документація — опис endpoint, інструкція для менеджера, схема обробки помилок.
• Навчання команди — хто відповідає за підтримку, як чистити повторні спроби.
• Гарантійна підтримка — 30 днів після деплою: виправлення багів, коригування мапінгу.

Строки та вартість

Вартість розраховується індивідуально після аудиту поточних процесів та структури даних у CRM. Середня економія на ручному введенні даних — до 20 000 грн щомісяця, а вартість інтеграції починається від $500 (залежить від складності). Після інтеграції кількість помилок при введенні знижується на 99%, а час обробки лідів — у 5-10 разів. Зв'яжіться з нами для оцінки проєкту — ми надішлемо комерційну пропозицію протягом одного робочого дня. Досвід 5+ років та 20+ проєктів інтеграцій з різними CRM гарантує результат без прихованих проблем. Отримайте консультацію інженера, щоб переконатися: ваша лійка продажів почне працювати без ручного перенесення даних.

Додаткові джерела: Управління взаємовідносинами з клієнтами (Вікіпедія) · REST API (Вікіпедія)