NetHunt Sync — CRM для WooCommerce

NetHunt Sync для WooCommerce — плагін, який автоматично передає кожне нове замовлення WooCommerce у NetHunt CRM. Одразу після оформлення в папці NetHunt з’являється запис із телефоном, email, сумою, списком товарів і посиланням на замовлення — менеджер працює із заявкою в CRM, а не переносить дані з адмінки магазину вручну.

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

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

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

1. Покупець оформлює замовлення — підтримується і класичний checkout, і Checkout Blocks.
2. Плагін збирає поля запису: ім’я, телефон (нормалізується до формату +380), email, суму, товари, адресу і спосіб оплати — та надсилає POST /api/v2/folders/{folderId}/records у NetHunt із заголовком Authorization: Bearer.
3. NetHunt повертає ID запису — він зберігається у меті замовлення _cc_nethunt_record_id, тому дублі виключені.
4. Якщо NetHunt тимчасово недоступний — WP-Cron повторює відправку автоматично: 3 спроби з паузами 5 хв / 30 хв / 2 год.
5. Менеджер бачить результат у метабоксі замовлення та в журналі синхронізації; сплачені онлайн замовлення отримують чекбокс Paid і позначку «✅ Оплачено онлайн» у коментарі.

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

Безкоштовно. Плагін розповсюджується під ліцензією GPLv2, код відкритий на GitHub. Усі функції доступні одразу після встановлення — платної версії не існує.

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

• WordPress 6.2+ (тестовано до 7.0)
• WooCommerce 6.0 або новіше
• PHP 7.4+
• API-токен NetHunt — створюється у кабінеті: Settings → API & MCP → Create token

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

• Публічне REST API v2 NetHunt з Bearer-токеном; кнопка «Перевірити з’єднання» робить GET /folders і одразу показує, чи валідний токен.
• Автопровіжн папки: якщо папку не вказано, плагін створює «WooCommerce Orders (домен)» з усіма полями однією дією. Якщо вказати власну папку — додасть лише відсутні поля (Phone, Email, Total, Products, Payment method тощо), наявні не чіпає.
• Захист від подвійної відправки на рівні БД: чекаут, зміна статусу і колбек оплати можуть прилетіти на одне замовлення одночасно — лок бере рівно один запит, решта відсіюються, тож другого запису в CRM не буде.
• Поле «Order ID» у папці: якщо відповіді від NetHunt не було (таймаут), плагін перед повторною спробою шукає запис за цим полем і підхоплює наявний замість того, щоб створити другий. Папкам, створеним у 0.1.0, поле додається автоматично.
• Чисте видалення: разом із плагіном зникають таблиця журналу й налаштування; ID записів на замовленнях лишаються навмисно — саме вони не дають при перевстановленні залити старі замовлення в CRM удруге.
• Шифрування API-токена у БД — libsodium з HMAC-фолбеком; токен не лежить у відкритому вигляді.
• HPOS-сумісність (custom order tables) — робота із замовленнями тільки через WC_Order CRUD.
• Точки розширення для розробників: фільтр cc_nethunt_order_payload (змінити дані перед відправкою) і хук cc_nethunt_order_sent (реакція на успішну синхронізацію).

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

1. Завантажте catcode-order-sync-with-nethunt-for-woocommerce-0.2.0.zip через Плагіни → Додати новий → Завантажити плагін.
2. Активуйте плагін у меню «Плагіни».
3. Відкрийте WooCommerce → NetHunt Sync і вставте API-токен з кабінету NetHunt (Settings → API & MCP → Create token).
4. Збережіть налаштування — плагін сам створить папку «WooCommerce Orders» з полями або підключить вказану вами.
5. Натисніть «Перевірити з’єднання» — має з’явитися підтвердження.
6. Зробіть тестове замовлення і перевірте, що запис з’явився в NetHunt.

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

0.2.0 — серпень 2026

Кнопка «Відправити повторно» нарешті працює: метабокс малював власну форму всередині форми замовлення, і браузер її викидав. Захист від подвійної відправки переїхав з транзієнта на лок у базі — паралельні запити більше не створюють два записи. Додано поле «Order ID» у папці й пошук за ним після таймауту, щоб спроба без відповіді не перетворилась на другий запис. Видалення плагіна тепер прибирає таблицю журналу. Стилі адмінки — через wp_add_inline_style, інтерфейс переведено на англійську з українським перекладом у /languages. Плагін перейменовано на «CatCode Order Sync with NetHunt for WooCommerce» (налаштування, мета й таблиця не змінились — мігрувати нічого не треба).

0.1.0 — липень 2026

Перший публічний реліз: відправка замовлень у папку NetHunt через REST API v2, автопровіжн папки з полями, повторні спроби через WP-Cron, метабокс у замовленні, журнал синхронізації, перевірка з’єднання, шифрування токена.