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 замовлення — він зберігається в меті _cc_keycrm_order_id, тому дублікатів не буде навіть при повторних спрацюваннях.
5. Якщо CRM недоступна — плагін сам повторить спробу за 5 хв / 30 хв / 2 год через WP-Cron, без налаштування крона на хостингу.
6. Менеджер бачить результат у метабоксі замовлення і в журналі подій.

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

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

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

• WordPress 6.2+
• WooCommerce 7.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 одразу з платіжним записом «оплачено» (опційно).
• Хуки для розробників: фільтр cc_keycrm_order_payload (модифікація даних перед відправкою) і екшен cc_keycrm_order_sent (сторонні інтеграції).

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

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

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

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.