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. Менеджер видит результат в метабоксе заказа и в журнале событий.

Что под капотом

• Дедупликация на двух уровнях: плагин передаёт 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. Нажмите «Перевірити з’єднання» (в английском интерфейсе — «Test connection») — убедитесь, что связь с CRM работает.
5. Выберите триггер отправки (сразу после оформления или конкретные статусы) и сохраните настройки.