Руководство Mokapen

WooCommerce

Подключите магазин WooCommerce (WordPress) к Mokapen, чтобы перенести в CRM клиентов (контакты), товары (с вариациями и остатками) и заказы магазина, а также экспортировать в WooCommerce товары, созданные или обновлённые в Mokapen, когда направление синхронизации это позволяет. Та же цель, что у Shopify: объединить e-commerce и коммерческое управление в одном рабочем пространстве.

Общий обзор: Интеграции. Импортированные заказы становятся в Mokapen заказами продажи (модуль Заказы), а не сделками в воронке.

Требования

• Сайт WordPress с активным WooCommerce и доступным по HTTPS.
• Разрешение на авторизацию Mokapen через поток WC Auth (администратор WordPress / WooCommerce).
• Тариф Mokapen подходящий Premium для e-commerce интеграций. Без тарифа кнопка подключения открывает апгрейд.
• Права Mokapen на контакты, товары и заказы в вашей организации (см. Роли и права).
• Доступ к Интеграциям (участник/админ в зависимости от white-label и роли в org).

Подключение магазина WooCommerce

1. Меню пользователя → Интеграции → WooCommerce.
2. Введите веб-адрес магазина (URL сайта, напр. https://vashdomen.com). Его видно в адресной строке, когда вы в backend WordPress / витрине WooCommerce.
3. Запустите авторизацию: вас перенаправит на WordPress/WooCommerce на страницу WC Auth (/wc-auth/v1/authorize) со scope read_write.
4. Примите генерацию API-ключей для Mokapen (consumer key / secret сохраняются зашифрованными в Mokapen — нет ручной формы «вставить API key»).
5. Вернитесь в Mokapen: магазин подключён. Mokapen регистрирует webhook WooCommerce (/wp-json/wc/v3/webhooks) для получения обновлений в реальном времени.

Если не примете авторизацию, данные не синхронизируются. URL должен быть действительным и по HTTPS: иначе валидация не пройдёт.

Что запрашивает Mokapen у WooCommerce

Поток WC Auth даёт Mokapen доступ на чтение/запись к REST API WooCommerce, необходимым для клиентов, товаров (и вариаций), заказов и webhook. Mokapen не заменяет панель WooCommerce/WordPress для тем, платежей или плагинов: выравнивает данные в CRM (и для товаров — из CRM).

Если отозвать ключи или удалить авторизацию в WordPress, отключите и подключите снова из Mokapen.

Что синхронизируется

В Mokapen (импорт / webhook)

• Клиенты → Контакты — клиенты WooCommerce в адресную книгу (и компания, если данные позволяют). Обновления также через webhook.
• Товары и вариации → Товары — каталог с вариациями; остаток WooCommerce (stock_quantity) маппится на количество варианта Mokapen.
• Заказы → Заказы — заказы WooCommerce становятся в Mokapen заказами продажи (со строками), а не сделками в воронке. Webhook при обновлениях.
• Брошенные корзины / отчёты — маркетинговые упоминания или пункты «Скоро» в UI не равны уже активному импорту отчётности корзин, как в других потоках: не считайте их полной функцией, если на странице они ещё «Скоро».

В WooCommerce (экспорт)

• Товары — при направлении sync «в WooCommerce» или «оба», Mokapen может экспортировать/обновлять товары в магазине (bulk sync и sync-out при сохранении товара, если интеграция активна).
• Контакты и заказы на выход — как у Shopify, автоматический «sync out» экспорт сегодня на практике касается в основном товаров. Клиенты поступают прежде всего из WooCommerce в Mokapen (импорт + webhook). Не предполагайте полный двусторонний экспорт контактов только потому, что это предлагает коммерческий текст: проверьте после подключения.

В конфиге также указаны услуги, но отдельной sync услуг нет: для каталога магазина используйте Товары.

Настройки после подключения

На странице WooCommerce, с подключённым магазином:

Направление sync

• Только в Mokapen — WooCommerce → CRM.
• Оба — импорт + экспорт (где поддерживается; сегодня в основном товары на выход).
• Только в WooCommerce — Mokapen → магазин (товары).

Сущности

Контакты, заказы и товары — области sync (часто предвыбраны и не изменяются в UI).

Общий доступ к sync

Тот, кто подключил, может поделиться подключением со всей организацией или выбранными пользователями.

Дубликаты и конфликты

• Избегать дубликатов — обычно распознавание контактов по email.
• При конфликте — побеждает WooCommerce или Mokapen.

Конфиденциальность (WooCommerce)

В отличие от Shopify, на странице WooCommerce могут быть элементы конфиденциальности и сотрудников/заинтересованных сторон, связанные с видимостью синхронизированных данных в org. Настройте их, если команда не должна видеть весь импортированный каталог/клиентов одинаково.

Автоматическая vs ручная sync

Включите автоматическую sync для непрерывных обновлений (вместе с webhook); используйте ручную sync для исторической загрузки. Отметьте авторизацию данных на странице перед синхронизацией.

Рекомендуемый поток

1. Проверьте HTTPS и актуальный WooCommerce на сайте.
2. Подключите магазин из Интеграции → WooCommerce и завершите WC Auth.
3. Задайте направление sync, дубликаты, конфликты, конфиденциальность (если есть) и общий доступ.
4. Авторизуйте и запустите первую sync.
5. Проверьте Контакты, Товары (вариации/остаток), Заказы в Mokapen.
6. Оставьте webhook активными для новых событий без повторного запуска всего.

Отключение

Из Интеграции → WooCommerce → отключить. В модальном окне выберите, сохранить ли в Mokapen уже импортированные контакты, заказы и товары. После отключения webhook больше не обновляют; данные в CRM остаются, если вы их сохранили. Ключи/авторизации можно также отозвать в панели WordPress.

Частые проблемы

• Недействительный URL / без HTTPS — используйте полный адрес сайта с https://.
• Авторизация не удалась — нужен admin WordPress; проверьте, что WooCommerce и REST permalink работают (firewall/плагины безопасности могут блокировать WC Auth или webhook).
• Заблокированная кнопка / апгрейд — нужен подходящий Premium тариф для e-commerce.
• Заказы не в Сделках — это правильно: они идут в Заказы (Продажи → Заказы).
• Остаток / количество — приходит из stock_quantity вариаций; это не полноценный WMS.
• Webhook не приходят — сайт должен быть доступен из интернета; локальные среды или с basic auth часто не получают уведомления WooCommerce.

Частые вопросы

В: Нужно ли вручную генерировать API key в WooCommerce?

О: Нет. Используйте поток WC Auth со страницы Интеграции Mokapen: ключи создаются и сохраняются при возврате из авторизации.

В: Заказы WooCommerce становятся сделками?

О: Нет. В Mokapen они становятся заказами продажи. Любые тексты про «сделки» неточны относительно текущего поведения.

В: Можно обновлять товары WooCommerce из Mokapen?

О: Да, при направлении sync с экспортом и активной интеграцией.

В: Чем отличается от Shopify?

О: Та же модель данных (контакты, товары, заказы) и та же логика Premium e-commerce. Отличается подключение: Shopify использует OAuth в приложении Shopify; WooCommerce — WC Auth на URL вашего WordPress сайта. См. также руководство Shopify.

В: Нужен ли HTTPS?

О: Да. Без HTTPS подключение и webhook ненадёжны (и валидация URL может не пройти).