Przewodnik po Mokapen

WooCommerce

Połącz swój sklep WooCommerce (WordPress) z Mokapen, aby przenieść do CRM klientów (kontakty), produkty (z wariantami i stanem magazynowym) oraz zamówienia ze sklepu, a także eksportować do WooCommerce produkty utworzone lub zaktualizowane w Mokapen, gdy kierunek sync na to pozwala. Ten sam cel co Shopify: połączenie e-commerce z zarządzaniem handlowym w tym samym workspace.

Przegląd ogólny: Integracje. Importowane zamówienia stają się zamówieniami sprzedaży w Mokapen (moduł Zamówienia), a nie szansami w pipeline.

Wymagania

• Witryna WordPress z aktywnym WooCommerce i dostępną przez HTTPS.
• Uprawnienie do autoryzacji Mokapen przez przepływ WC Auth (administrator WordPress / WooCommerce).
• Plan Mokapen odpowiedni Premium do integracji e-commerce. Bez planu przycisk połączenia otwiera upgrade.
• Uprawnienia Mokapen do kontaktów, produktów i zamówień w organizacji (zob. Role i uprawnienia).
• Dostęp do Integracji (członek/admin zgodnie z white-label i rolą org).

Połączenie sklepu WooCommerce

1. Menu użytkownika → Integracje → WooCommerce.
2. Wprowadź adres internetowy sklepu (URL witryny, np. https://twojadomena.com). Znajdziesz go na pasku adresu w backendzie WordPress / witrynie WooCommerce.
3. Rozpocznij autoryzację: zostaniesz przeniesiony do WordPress/WooCommerce na stronę WC Auth (/wc-auth/v1/authorize) ze scope read_write.
4. Zaakceptuj wygenerowanie kluczy API dla Mokapen (consumer key / secret są zapisywane zaszyfrowane w Mokapen — nie ma ręcznego formularza «wklej API key»).
5. Wróć do Mokapen: sklep jest połączony. Mokapen rejestruje webhook WooCommerce (/wp-json/wc/v3/webhooks), aby odbierać aktualizacje w czasie rzeczywistym.

Jeśli nie zaakceptujesz autoryzacji, żadne dane nie będą synchronizowane. URL musi być prawidłowy i w HTTPS: w przeciwnym razie walidacja się nie powiedzie.

Czego Mokapen wymaga od WooCommerce

Przepływ WC Auth przyznaje Mokapen dostęp odczytu/zapisu do REST API WooCommerce potrzebnych dla klientów, produktów (i wariantów), zamówień i webhook. Mokapen nie zastępuje panelu WooCommerce/WordPress dla motywów, płatności ani wtyczek: wyrównuje dane do (a w przypadku produktów — z) CRM.

Jeśli cofniesz klucze lub odinstalujesz autoryzację po stronie WordPress, odłącz i połącz ponownie z Mokapen.

Co jest synchronizowane

Do Mokapen (import / webhook)

• Klienci → Kontakty — klienci WooCommerce w książce adresowej (i firma, jeśli dane na to pozwalają). Aktualizacje także przez webhook.
• Produkty i warianty → Produkty — katalog z wariantami; stock WooCommerce (stock_quantity) mapuje się na ilość wariantu Mokapen.
• Zamówienia → Zamówienia — zamówienia WooCommerce stają się zamówieniami sprzedaży w Mokapen (z pozycjami), a nie dealami w pipeline. Webhook przy aktualizacjach.
• Porzucone koszyki / raporty — wzmianki marketingowe lub wpisy «Wkrótce» w UI nie oznaczają aktywnego importu raportów koszyków jak w innych przepływach: nie traktuj ich jako pełnej funkcji, jeśli na stronie nadal są oznaczone jako wkrótce.

Do WooCommerce (export)

• Produkty — przy kierunku sync «do WooCommerce» lub «obie strony» Mokapen może eksportować/aktualizować produkty w sklepie (sync bulk i sync-out przy zapisie produktu, jeśli integracja jest aktywna).
• Kontakty i zamówienia wychodzące — jak w Shopify, automatyczny export «sync out» zaimplementowany dziś dotyczy w praktyce produktów. Klienci docierają głównie z WooCommerce do Mokapen (import + webhook). Nie zakładaj pełnego eksportu dwukierunkowego kontaktów tylko dlatego, że sugeruje to tekst handlowy: sprawdź po połączeniu.

W konfiguracji pojawiają się też usługi, ale nie ma dedykowanej sync usług: do katalogu sklepu używaj Produktów.

Ustawienia po połączeniu

Na stronie WooCommerce, ze sklepem połączonym:

Kierunek sync

• Tylko do Mokapen — WooCommerce → CRM.
• Obie strony — import + export (gdzie wspierane; dziś głównie produkty wychodzące).
• Tylko do WooCommerce — Mokapen → sklep (produkty).

Encje

Kontakty, zamówienia i produkty to zakresy sync (często wstępnie zaznaczone i niemodyfikowalne w UI).

Udostępnij sync

Osoba, która połączyła, może udostępnić połączenie całej organizacji lub wybranym użytkownikom.

Duplikaty i konflikty

• Unikaj duplikatów — zwykle rozpoznawanie kontaktów po emailu.
• W razie konfliktu — wygrywa WooCommerce lub Mokapen.

Prywatność (WooCommerce)

W odróżnieniu od Shopify, na stronie WooCommerce możesz też znaleźć kontrolki prywatności i współpracowników/stakeholderów dotyczące widoczności zsynchronizowanych danych w org. Skonfiguruj je, jeśli zespół nie powinien widzieć całego zaimportowanego katalogu/klientów w ten sam sposób.

Sync automatyczna vs ręczna

Włącz sync automatyczną dla ciągłych aktualizacji (razem z webhook); użyj sync ręcznej do ładowania historycznego. Zaznacz autoryzację danych na stronie przed synchronizacją.

Zalecany przepływ

1. Sprawdź HTTPS i aktualny WooCommerce na witrynie.
2. Połącz sklep z Integracji → WooCommerce i ukończ WC Auth.
3. Ustaw kierunek sync, duplikaty, konflikty, prywatność (jeśli dostępna) i udostępnianie.
4. Autoryzuj i uruchom pierwszą sync.
5. Sprawdź Kontakty, Produkty (warianty/stock), Zamówienia w Mokapen.
6. Pozostaw aktywne webhook dla nowych zdarzeń bez ponownego uruchamiania wszystkiego.

Odłączenie

Z Integracji → WooCommerce → odłącz. W modalu wybierz, czy zachować w Mokapen kontakty, zamówienia i produkty już zaimportowane. Po odłączeniu webhook nie aktualizują już danych; dane już w CRM pozostają, jeśli je zachowałeś. Możesz też cofnąć klucze/autoryzacje w panelu WordPress.

Częste problemy

• Nieprawidłowy URL / brak HTTPS — użyj pełnego adresu witryny z https://.
• Autoryzacja nie powiodła się — potrzebny admin WordPress; sprawdź, czy WooCommerce i permalinki REST działają (firewall/wtyczki bezpieczeństwa mogą blokować WC Auth lub webhook).
• Przycisk zablokowany / upgrade — potrzebny jest odpowiedni plan Premium do e-commerce.
• Zamówienia nie w Szansach — to poprawne: trafiają do Zamówień (Sprzedaż → Zamówienia).
• Stock / ilość — pochodzi z stock_quantity wariantów; to nie pełny WMS.
• Webhook nie docierają — witryna musi być dostępna z internetu; środowiska lokalne lub z basic auth często nie odbierają powiadomień WooCommerce.

Najczęstsze pytania

P: Czy muszę ręcznie generować klucze API w WooCommerce?

O: Nie. Użyj przepływu WC Auth ze strony Integracji Mokapen: klucze są tworzone i zapisywane po powrocie z autoryzacji.

P: Czy zamówienia WooCommerce stają się szansami?

O: Nie. W Mokapen stają się zamówieniami sprzedaży. Teksty mówiące o «szansach» są nieprecyzyjne względem obecnego zachowania.

P: Czy mogę aktualizować produkty WooCommerce z Mokapen?

O: Tak, przy kierunku sync obejmującym export i aktywnej integracji.

P: Różnica względem Shopify?

O: Ten sam model danych (kontakty, produkty, zamówienia) i ta sama logika Premium e-commerce. Różni się połączenie: Shopify używa OAuth w aplikacji Shopify; WooCommerce używa WC Auth pod URL Twojej witryny WordPress. Zob. też przewodnik Shopify.

P: Czy potrzebny jest HTTPS?

O: Tak. Bez HTTPS połączenie i webhook nie są niezawodne (a walidacja URL może się nie powieść).