Інтеграція з KeyCRM для ImageCMS

Модуль інтеграції з KeyCRM для ImageCMS об’єднує ваш інтернет-магазин із системою KeyCRM в єдиний робочий процес: замовлення, статуси, залишки та каталог тримаються синхронізованими автоматично. Менеджери ведуть продажі й обробку замовлень у звичному інтерфейсі CRM, а магазин завжди відображає актуальні дані. Модуль реалізовано на легкому curl-клієнті без зовнішніх залежностей, тож він стабільно працює навіть на тарифах без Composer.

Навіщо потрібна інтеграція з KeyCRM

Коли магазин і CRM живуть окремо, менеджери дублюють замовлення вручну, статуси розходяться, а залишки на сайті не збігаються зі складом. Це призводить до помилок, скасувань і втрати часу. Двостороння інтеграція прибирає ручну роботу: кожне нове замовлення одразу потрапляє в KeyCRM, зміна статусу в CRM повертається на сайт, а складські залишки оновлюються в обраному напрямку. Ви отримуєте єдине джерело правди для відділу продажів і складу.

Що вміє модуль

• Передача замовлень у KeyCRM — нове замовлення з усіма позиціями, сумами, контактами клієнта та коментарем автоматично створюється в CRM.
• Синхронізація статусів — налаштовуване зіставлення статусів (KeyCRM → магазин) у форматі JSON; працює в обидва боки.
• Синхронізація залишків — оберіть напрямок (зі складу KeyCRM у магазин, із магазину в CRM або в обидва боки) та склад, з якого братимуться залишки.
• Вивантаження каталогу (ICML) — одним натисканням магазин формує товари в KeyCRM за SKU у стандартному форматі ICML.
• Вебхуки CRM → магазин — захищений секретом вебхук приймає подію зміни статусу замовлення й оновлює його на сайті.

Ключові можливості за напрямами

Замовлення. Передаються позиції, кількість, ціни, варіанти товару, дані покупця та джерело замовлення. Джерело створюється автоматично за назвою або вказується вручну через Source ID.

Склад і каталог. Гнучкий вибір напрямку синхронізації залишків і ручний запуск «Синхронізувати залишки» та «Вивантажити каталог», які можна поставити й на cron.

Статуси та вебхуки. Кнопка «Показати статуси KeyCRM» виводить їх id просто в адмінці, щоб швидко скласти карту відповідності, а вхідний вебхук тримає статуси узгодженими в реальному часі.

Як це працює

У KeyCRM створіть API-ключ (Налаштування → API) і вставте його в полі «API token». За потреби задайте Source ID, склад для залишків і валюту. Для зворотного зв’язку встановіть секрет вебхука, скопіюйте готову Webhook URL і додайте її в KeyCRM (Автоматизація → Вебхук) для події order.change_order_status. Далі заповніть карту статусів, оберіть напрямок синхронізації залишків і за потреби вивантажте каталог. Усе налаштовується в одній адмін-панелі.

Переваги

• Менше ручної роботи й людських помилок при обробці замовлень.
• Актуальні залишки на сайті та узгоджені статуси з боку CRM.
• Швидкий старт: майстер налаштування з покроковою інструкцією в адмінці.
• Без зовнішніх залежностей — лише curl-клієнт, повна локалізація (українська й англійська).

Сумісність

Модуль працює з ImageCMS і підтримує PHP 5.6–8.5. Встановлення та оновлення виконуються прямо в адмінпанелі магазину, налаштування зосереджені в одному вікні компонента.

Питання та відповіді

Чи потрібні зовнішні бібліотеки або Composer?

Ні. Модуль використовує власний curl-клієнт без сторонніх залежностей, тому встановлюється навіть там, де Composer недоступний.

Синхронізація залишків працює в обидва боки?

Так. У налаштуваннях ви обираєте напрямок: зі складу KeyCRM у магазин, із магазину в KeyCRM або в обидва боки.

Як статуси повертаються з CRM на сайт?

Через вебхук: ви додаєте Webhook URL із секретом у KeyCRM на подію зміни статусу замовлення, а карта статусів (JSON) визначає відповідність id CRM та магазину.

Чи можна автоматизувати вивантаження?

Так. Синхронізацію залишків і вивантаження каталогу можна запускати вручну кнопками або налаштувати через cron.

Встановіть модуль інтеграції з KeyCRM для ImageCMS і керуйте замовленнями, складом та статусами в одній системі — без ручного перенесення даних і розбіжностей між магазином і CRM.