Ръководството на Мокапен

WooCommerce

Свържете магазина си в WooCommerce (WordPress) с Mokapen, за да пренесете клиентите (контакти), продуктите (с вариации и наличност) и поръчките от магазина в CRM, както и да експортирате продукти, създадени или актуализирани в Mokapen, към WooCommerce, когато посоката на синхронизация го позволява. Същата цел като Shopify: обединете електронната търговия и управлението на продажбите в едно работно пространство.

Общ преглед: Интеграции. Импортираните поръчки стават поръчки за продажба в Mokapen (модул Поръчки), а не възможности в pipeline.

Изисквания

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

Свързване на магазина WooCommerce

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

Ако не приемете упълномощаването, не се синхронизират данни. URL трябва да е валиден и HTTPS: иначе валидацията се проваля.

Какво Mokapen иска от WooCommerce

Потокът WC Auth дава на Mokapen достъп за четене/запис до REST API на WooCommerce, нужни за клиенти, продукти (и вариации), поръчки и webhooks. Mokapen не замества панела на WooCommerce/WordPress за теми, плащания или плъгини: подравнява данните към (и, за продуктите, от) CRM.

Ако отмените ключовете или премахнете упълномощаването от страна на WordPress, прекъснете и свържете отново от Mokapen.

Какво се синхронизира

Към Mokapen (импорт / webhook)

• Клиенти → Контакти — клиенти от WooCommerce в адресната книга (и фирма, ако данните го позволяват). Актуализации и чрез webhook.
• Продукти и вариации → Продукти — каталог с вариации; наличността в WooCommerce (stock_quantity) се съпоставя с количеството на варианта в Mokapen.
• Поръчки → Поръчки — поръчките от WooCommerce стават поръчки за продажба в Mokapen (с редове), не сделки в pipeline. Webhooks при актуализации.
• Изоставени колички / отчети — маркетингови споменавания или записи «Coming soon» в UI не означават активен импорт на отчети за колички като при други потоци: не ги бройте като завършена функция, ако на страницата все още се показват като скоро.

Към WooCommerce (експорт)

• Продукти — с посока «към WooCommerce» или «и двете» Mokapen може да експортира/актуализира продукти в магазина (масова синхронизация и sync-out при запазване на продукт, ако интеграцията е активна).
• Изходящи контакти и поръчки — както при Shopify, автоматичният експорт «sync out», реализиран днес, на практика се прилага за продукти. Клиентите пристигат основно от WooCommerce към Mokapen (импорт + webhook). Не приемайте за даденост пълен двупосочен експорт на контакти само защото търговският текст го предполага: проверете след свързване.

Конфигурацията показва и услуги, но няма специализирана синхронизация на услуги: използвайте Продукти за каталога на магазина.

Настройки след свързване

На страницата WooCommerce, при свързан магазин:

Посока на синхронизация

• Само към Mokapen — WooCommerce → CRM.
• И двете — импорт + експорт (където се поддържа; днес основно изходящи продукти).
• Само към WooCommerce — Mokapen → магазин (продукти).

Обекти

Контакти, поръчки и продукти са обхватите на синхронизация (често предварително избрани и нередактируеми от UI).

Споделяне на синхронизацията

Който е свързал, може да сподели връзката с цялата организация или с избрани потребители.

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

• Избягвай дубликати — обикновено разпознаване на контакти по имейл.
• При конфликт — печели WooCommerce или Mokapen.

Поверителност (WooCommerce)

За разлика от Shopify, на страницата WooCommerce може да намерите и контроли за поверителност и сътрудници/заинтересовани лица, свързани с това как синхронизираните данни са видими в org. Задайте ги, ако екипът не трябва да вижда целия импортиран каталог/клиенти по един и същ начин.

Автоматична срещу ръчна синхронизация

Активирайте автоматичната синхронизация за текущи актуализации (заедно с webhooks); използвайте ръчната за историческото зареждане. Проверете упълномощаването за данни на страницата преди синхронизация.

Препоръчителен поток

1. Проверете HTTPS и актуален WooCommerce на сайта.
2. Свържете магазина от Интеграции → WooCommerce и завършете WC Auth.
3. Задайте посока на синхронизация, дубликати, конфликти, поверителност (ако е налична) и споделяне.
4. Упълномощете и стартирайте първата синхронизация.
5. Проверете Контакти, Продукти (вариации/наличност), Поръчки в Mokapen.
6. Дръжте webhooks активни за нови събития без да пускате всичко отново всеки път.

Прекъсване

От Интеграции → WooCommerce → прекъснете. В модала изберете дали да запазите контактите, поръчките и продуктите, вече импортирани в Mokapen. След прекъсване webhooks вече не обновяват; данните, вече в CRM, остават, ако сте ги запазили. Можете и да отмените ключове/упълномощавания от панела на WordPress.

Чести проблеми

• Невалиден URL / не е HTTPS — използвайте пълния адрес на сайта с https://.
• Неуспешно упълномощаване — нужен е администратор на WordPress; проверете дали WooCommerce и REST permalinks работят (firewall/плъгини за сигурност може да блокират WC Auth или webhooks).
• Бутонът е блокиран / надграждане — необходим е подходящ план Premium за електронна търговия.
• Поръчките не са във Възможности — това е правилно: отиват в Поръчки (Продажби → Поръчки).
• Наличност / количество — идва от stock_quantity на вариацията; не е пълен WMS.
• Webhooks не пристигат — сайтът трябва да е достъпен от интернет; локални среди или среди с basic-auth често не получават известия от WooCommerce.

Често задавани въпроси

В: Трябва ли ръчно да генерирам API ключове в WooCommerce?

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

В: Стават ли поръчките от WooCommerce възможности?

О: Не. В Mokapen стават поръчки за продажба. Всеки текст, който говори за «възможности», е неточен спрямо текущото поведение.

В: Мога ли да актуализирам продуктите в WooCommerce от Mokapen?

О: Да, с посока на синхронизация, която включва експорт, и активна интеграция.

В: Разлика от Shopify?

О: Същият модел на данни (контакти, продукти, поръчки) и същата Premium логика за електронна търговия. Връзката се различава: Shopify използва OAuth върху приложението Shopify; WooCommerce използва WC Auth върху URL на вашия WordPress сайт. Вижте и ръководството за Shopify.

В: Задължителен ли е HTTPS?

О: Да. Без HTTPS връзката и webhooks не са надеждни (и валидацията на URL може да се провали).