KeyCRM Sync — CRM для WooCommerce

KeyCRM Sync для WooCommerce — плагін, який автоматично передає кожне замовлення WooCommerce у KeyCRM: з покупцем, товарами, доставкою і оплатою. Відправка спрацьовує одразу після оформлення (класичний checkout і Checkout Blocks) або при переході замовлення у вибраний вами статус. Менеджери працюють у CRM, а не перемикаються між адмінкою магазину і табличками — і жодного ручного перенесення замовлень.

Плагін опубліковано в офіційному каталозі WordPress.org — встановлюється прямо з адмінки: wordpress.org/plugins/catcode-order-sync-with-keycrm-for-woocommerce.

Плагін повністю безкоштовний. Код відкритий на GitHub: github.com/catcodestudio/wp-keycrm-sync. Без обмеження за кількістю замовлень, без щомісячних списань і без прив’язки до сторонніх сервісів — потрібен лише API-ключ з вашого кабінету KeyCRM.

Що отримує адмін

Як це працює — крок за кроком

1. Покупець оформлює замовлення у вашому магазині — через класичний checkout або Checkout Blocks.
2. Плагін збирає payload: покупець, товари, доставка, оплата. Телефон нормалізується у формат +380, нульові позиції пропускаються.
3. Відправка у KeyCRM через POST /order — одразу після оформлення або коли замовлення переходить у вибраний вами статус (наприклад «В обробці»).
4. KeyCRM повертає ID замовлення — він зберігається в меті _catcode_keycrm_order_id, тому дублікатів не буде навіть при повторних спрацюваннях.
5. Якщо CRM недоступна — плагін сам повторить спробу за 5 хв / 30 хв / 2 год через WP-Cron, без налаштування крона на хостингу.
6. Менеджер бачить результат у метабоксі замовлення і в журналі подій.

Скільки коштує

Безкоштовно, код відкритий. Скачати можна з GitHub або кнопкою на цій сторінці. Ніяких платних тарифів, тріалів чи лімітів на кількість замовлень.

Технічні вимоги

• WordPress 6.2+
• WooCommerce 6.0+
• PHP 7.4+
• API-ключ KeyCRM — кабінет KeyCRM → Налаштування → API

Що під капотом

• Дедуплікація на двох рівнях: плагін передає source_uuid = wc-{id} і зберігає KeyCRM ID у меті замовлення — дублікатів не створюється ні на боці плагіна, ні на боці CRM.
• API-ключ зашифрований у БД — libsodium з HMAC-фолбеком; у відкритому вигляді ключ не зберігається.
• Сумісність з HPOS (High-Performance Order Storage) — робота з замовленнями виключно через WC_Order CRUD.
• Передача статусу оплати: оплачене замовлення створюється в CRM одразу з платіжним записом «оплачено» (опційно).
• Хуки для розробників: фільтр catcode_keycrm_order_payload (модифікація даних перед відправкою) і екшен catcode_keycrm_order_sent (сторонні інтеграції).

Як встановити

1. У адмінці: Плагіни → Додати новий → знайдіть «CatCode Order Sync with KeyCRM» і натисніть «Встановити». Або завантажте catcode-order-sync-with-keycrm-for-woocommerce-0.1.6.zip вручну.
2. Активуйте плагін у списку плагінів.
3. Перейдіть у WooCommerce → KeyCRM Sync і вставте API-ключ з кабінету KeyCRM.
4. Натисніть «Перевірити підключення» — переконайтеся, що зв’язок з CRM працює.
5. Оберіть тригер відправки (одразу після оформлення або конкретні статуси) і збережіть налаштування.

Історія версій

0.1.6 — 13 серпня 2026

Полагоджено кнопку «Відправити повторно» в метабоксі замовлення — вона не працювала жодного дня: метабокс друкував власну форму всередині форми замовлення WooCommerce, а браузер вкладену форму викидає, тож клік сабмітив форму замовлення й до CRM нічого не йшло. Тепер це звичайне посилання з нонсом. Ручна відправка бере те саме блокування в БД, що й автоматична, — два менеджери, які натиснули кнопку одночасно, більше не створять у KeyCRM два замовлення. Переклади прибрані зі збірки на WordPress.org (вони йдуть із translate.wordpress.org), у zip на цій сторінці українська локалізація лишається.

0.1.5 — 12 серпня 2026

Оновлення з версій до 0.1.1 більше не «губить» магазин: при перейменуванні плагіна налаштування, API-ключ, журнал і мітки «замовлення вже в KeyCRM» лишались під старими іменами. Через це кожне старе замовлення виглядало невідправленим — наступна зміна статусу штовхала його в CRM ще раз, KeyCRM відповідала помилкою на повторний source_uuid, і замовлення позначалось як «Помилка відправки», хоч насправді давно було в CRM. Тепер усе це переноситься автоматично, а хибний статус помилки знімається. Захист від подвійної відправки став атомарним (блокування в БД замість транзієнта). Замовлення без способу оплати або зовсім без контактів покупця більше не відхиляються CRM з помилкою 422. Видалення плагіна прибирає і стару таблицю журналу. Мінімальна версія WooCommerce знижена до 6.0.

0.1.4 — 6 серпня 2026

Опис і ключові слова в каталозі WordPress.org — українською.

0.1.3 — 20 липня 2026

Вихідні рядки коду переведено на англійську (вимога каталогу WordPress.org), додано повний вбудований український переклад — україномовний інтерфейс лишився без змін.

0.1.2 — 20 липня 2026

Публікація в офіційному каталозі WordPress.org. Плагін перейменовано на «CatCode Order Sync with KeyCRM for WooCommerce», уніфіковано префікси, інлайн-стилі винесено в enqueue, у readme додано розділ про зовнішні сервіси.

0.1.0 — липень 2026

Перший публічний реліз: експорт замовлень у KeyCRM (checkout і статуси-тригери), дедуплікація через source_uuid, ретраї 5 хв / 30 хв / 2 год, метабокс у замовленні з повторною відправкою, журнал подій, перевірка підключення, шифрування API-ключа, сумісність з HPOS і Checkout Blocks.