Зазначимо: коли інтернет-магазин на самописній платформі почав втрачати до 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% та повністю виключити помилки в статусах.
| Метрика | До інтеграції | Після інтеграції |
|---|---|---|
| Час обробки замовлення | 15 хвилин | 3 хвилини |
| Кількість помилок у статусах | 5% | 0.1% |
| Щоденний час на звіряння залишків | 3 години | автоматично |
Інтеграція RetailCRM з сайтом: покроковий план
- Аналіз поточної архітектури — 1-2 дні. Оцінка системи, визначення точок інтеграції.
- Встановлення та налаштування SDK — 2-3 дні. Підключення офіційного клієнта RetailCRM.
- Створення ендпоїнтів для передачі замовлень та webhooks — 1-2 дні. Реалізація API-запитів.
- Налаштування ICML-фіду — 1-2 дні. Синхронізація каталогу.
- Тестування та навчання менеджерів — 2-3 дні. Перевірка роботи, документування.
| Етап | Тривалість | Результат |
|---|---|---|
| Аналіз | 1-2 дні | Схема інтеграції |
| SDK та API | 2-3 дні | Передача замовлень |
| Webhooks | 1-2 дні | Синхронізація статусів |
| ICML-фід | 1-2 дні | Актуальний каталог |
| Тестування | 2-3 дні | Працююча інтеграція |
Чому RetailCRM краща за універсальні CRM?
RetailCRM спеціалізується на e-commerce, тому в ній одразу є інструменти управління замовленнями, складськими залишками та маркетингом. Наприклад, обробка замовлення в RetailCRM займає в середньому 2 хвилини, тоді як в універсальній CRM — до 10 хвилин (у 5 разів швидше). Це підтверджується нашими проєктами: після переходу на RetailCRM час на оформлення замовлення скоротився на 60%. Крім того, RetailCRM підтримує всі популярні платіжні системи та служби доставки з коробки. Скорочення часу обробки замовлення з 15 до 3 хвилин приносить економію в 200 000 ₽ щомісяця.
Що входить в інтеграцію під ключ?
- Повна документація по інтеграції (схеми, налаштування, код)
- Доступ до Git-репозиторію з прикладами
- Навчання команди менеджерів роботі в RetailCRM
- Технічна підтримка на 2 тижні після запуску
Отримайте індивідуальний план інтеграції під ваш проєкт. Залиште заявку на безкоштовний аудит поточної системи.
Строк інтеграції: 1–2 тижні для повної двонаправленої синхронізації.