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. При желании заполните маршрутизацию (воронка, этап, источник, ответственный) и выберите момент отправки. Сохраните — готово.