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. Менеджер бачить результат у метабоксі замовлення і у вкладці «Журнал» на сторінці налаштувань.

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

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