KeepinCRM Sync — CRM для WooCommerce

KeepinCRM Sync для WooCommerce — плагін, який автоматично створює угоду в KeepinCRM на кожне нове замовлення WooCommerce. Клієнт заводиться як лід із ПІБ, email і телефоном, товари стають рядками угоди, коментар покупця потрапляє в CRM — менеджер одразу працює із заявкою, а не передруковує її з адмінки сайту. Працює і з класичним чекаутом, і з Checkout Blocks.

Плагін повністю безкоштовний, код відкритий. Завантажити з GitHub: github.com/catcodestudio/wp-keepincrm-sync. Ліцензія GPLv2 — без ключів, підписок і лімітів на замовлення.

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

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

1. Покупець оформлює замовлення — плагін реагує одразу після checkout або при переході замовлення в один із вибраних статусів.
2. Збирається угода: клієнт-лід (ПІБ, email, телефон у форматі +380), товари як рядки угоди (jobs) із ціною та кількістю, сума, коментар. Для сплачених онлайн замовлень опційно додається позначка «Оплачено онлайн».
3. Дані відправляються в KeepinCRM через REST API — POST /agreements із заголовком X-Auth-Token.
4. CRM повертає ID угоди — він зберігається в меті замовлення (_cc_keepincrm_agreement_id). Повторна подія не створить другу угоду.
5. При збої CRM плагін повторює відправку сам: 3 спроби з паузами 5 хв / 30 хв / 2 год через WP-Cron.
6. Менеджер бачить результат у метабоксі замовлення і у вкладці «Журнал» на сторінці налаштувань.

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

Безкоштовно, код відкритий. Репозиторій на GitHub: catcodestudio/wp-keepincrm-sync — ліцензія GPLv2, використовуйте без обмежень.

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

• WordPress 6.2+ (тестовано до 7.0)
• WooCommerce 7.0 або новіше, включно з HPOS (custom order tables)
• PHP 7.4+
• API-токен KeepinCRM — створюється в кабінеті: Налаштування → Профіль компанії → вкладка API

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

• API-токен зашифрований у БД — libsodium із HMAC-фолбеком для хостингів без розширення sodium.
• Дедуплікація за збереженим ID угоди: перед створенням плагін перевіряє мету замовлення — повторна відправка оновлює наявну угоду (PATCH /agreements/{id}), а не створює нову.
• HPOS-сумісність — робота з замовленнями тільки через WC_Order CRUD, без прямих SQL до постів.
• Нормалізація телефону до E.164 (+380…) перед відправкою в CRM.
• Хуки для розробників: фільтр cc_keepincrm_order_payload (змінити тіло угоди) і екшн cc_keepincrm_order_sent (реакція на успішну відправку).

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

1. Завантажте keepincrm-sync-for-woocommerce-0.1.0.zip і встановіть через Плагіни → Додати новий → Завантажити плагін.
2. Активуйте у меню «Плагіни».
3. Відкрийте WooCommerce → KeepinCRM Sync і вставте API-токен із кабінету KeepinCRM (Налаштування → Профіль компанії → вкладка API).
4. Натисніть «Перевірити з’єднання» — переконайтесь, що CRM відповідає.
5. За бажанням заповніть маршрутизацію (воронка, етап, джерело, відповідальний) і оберіть момент відправки. Збережіть — готово.

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

0.1.0 — липень 2026

Перший публічний реліз: створення угод у KeepinCRM (POST /agreements) після checkout або за статусом-тригером, клієнт-лід із товарами-рядками, маршрутизація воронка/етап/джерело/відповідальний, повторні спроби через WP-Cron, метабокс у замовленні, журнал подій, перевірка з’єднання, шифрування токена, HPOS-сумісність.