Przewodnik po Mokapen

Shopify

Połącz swój sklep Shopify z Mokapen, aby przenieść do CRM klientów (kontakty), produkty (z wariantami i ilościami) oraz zamówienia ze sklepu, a także eksportować do Shopify produkty utworzone lub zaktualizowane w Mokapen, gdy kierunek sync na to pozwala. Służy to połączeniu e-commerce z zarządzaniem handlowym: dane master, katalog i historia zakupów 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

• Aktywny sklep Shopify (URL kończący się na .myshopify.com).
• Uprawnienie do autoryzacji aplikacji Mokapen w Shopify (OAuth) kontem administratora sklepu.
• Plan Mokapen odpowiedni Premium do integracji e-commerce. Bez planu przycisk połączenia otwiera upgrade; w niektórych ścieżkach Shopify może też zaproponować cykliczną opłatę powiązaną z aplikacją.
• 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 Shopify

1. Menu użytkownika → Integracje → Shopify.
2. Wprowadź nazwę sklepu (jak w Shopify Admin; pełny URL kończy się na myshopify.com). Jeśli nie masz pewności, otwórz panel Shopify i sprawdź pasek adresu przeglądarki.
3. Rozpocznij autoryzację: zostaniesz przeniesiony do Shopify, aby zaakceptować uprawnienia.
4. Zaakceptuj wymagane scope (odczyt/zapis klientów i produktów, odczyt zamówień — patrz poniżej).
5. Wróć do Mokapen: sklep jest połączony. Jeśli trafiasz z App Store Shopify, być może musisz wybrać organizację Mokapen, na której zainstalować połączenie.

Jeśli nie zaakceptujesz w Shopify, żadne dane nie będą synchronizowane. Po połączeniu Mokapen rejestruje webhook w sklepie: dzięki temu aktualizacje klientów, produktów i zamówień mogą docierać w czasie rzeczywistym, oprócz sync bulk uruchamianej przez Ciebie.

Czego Mokapen wymaga od Shopify

W autoryzacji OAuth Mokapen zwykle żąda:

• read_customers / write_customers — odczyt (i ewentualny zapis) klientów Shopify.
• read_products / write_products — odczyt i aktualizacja produktów/wariantów.
• read_orders — odczyt zamówień sklepu.

Mokapen nie zastępuje panelu Shopify dla checkoutu, motywów ani płatności: wyrównuje dane do (a w przypadku produktów — z) CRM. Jeśli cofniesz aplikację w Shopify lub token wygaśnie, odłącz i połącz ponownie z Mokapen. Shopify wymaga też endpointów GDPR (żądanie danych / redact): Mokapen obsługuje je przez webhook.

Co jest synchronizowane

Do Mokapen (import / webhook)

• Klienci → Kontakty — dane master Shopify trafiają do książki adresowej; jeśli są dane firmy, może powstać/powiązać się też firma. Webhook przy create/update/delete klientów.
• Produkty i warianty → Produkty — katalog z wariantami; ilość magazynowa Shopify w wariancie mapuje się na pole ilości wariantu Mokapen (to nie osobny moduł magazynowy).
• Zamówienia → Zamówienia — zamówienia Shopify stają się zamówieniami sprzedaży w Mokapen (z pozycjami), a nie dealami w pipeline. Webhook przy aktualizacjach zamówień.
• Porzucone checkouty — w sync może istnieć ścieżka importu porzuconych checkoutów Shopify (jako zamówienia/powiązane dane). Dedykowane raporty koszyków porzuconych / analytics e-commerce na stronie nadal są oznaczone jako Wkrótce: nie traktuj ich jako aktywnej funkcji.

Do Shopify (export)

• Produkty — przy kierunku sync «do Shopify» lub «obie strony» Mokapen może eksportować/aktualizować produkty w sklepie (sync bulk i sync-out przy zapisie powiązanego produktu, jeśli integracja jest aktywna).
• Kontakty i zamówienia wychodzące — mimo scope write_customers, automatyczny export «sync out» zaimplementowany dziś dotyczy w praktyce produktów. Nie zakładaj pełnego eksportu dwukierunkowego kontaktów ani zamówień: klienci docierają głównie ze Shopify do Mokapen (import + webhook). Jeśli tekst marketingowy mówi o «dwukierunkowości tylko kontaktów», sprawdź w swoim środowisku, co sync faktycznie robi po połączeniu.

W konfiguracji integracja wymienia też usługi, ale nie ma dedykowanej sync usług e-commerce jak dla produktów: do katalogu sklepu używaj Produktów.

Ustawienia po połączeniu

Na stronie Shopify, ze sklepem połączonym, zwykle konfigurujesz:

Kierunek sync

• Tylko do Mokapen — dane wychodzą ze Shopify i trafiają do CRM.
• Obie strony — import + export (gdzie wspierane; dziś głównie produkty wychodzące).
• Tylko do Shopify — wysyłka z Mokapen do sklepu (produkty).

Encje

Kontakty, zamówienia i produkty pojawiają się jako zakresy sync (często już zaznaczone i niemodyfikowalne w UI). Sync historyczna i webhook obejmują te trzy bloki.

Udostępnij sync

Osoba, która połączyła sklep, może udostępnić to samo połączenie innym członkom (cała organizacja lub wybrani użytkownicy), aby nie wszyscy musieli powtarzać OAuth.

Duplikaty i konflikty

• Unikaj duplikatów — typowa opcja: kontakty rozpoznawane po emailu, aby nie tworzyć duplikatów w książce adresowej.
• W razie konfliktu — wybierz, czy wygrywa Shopify czy Mokapen, gdy ten sam rekord był edytowany po obu stronach.

Sync automatyczna vs ręczna

Przy aktywnej sync automatycznej aktualizacje (i webhook) utrzymują dane w zgodności; możesz jednak uruchomić synchronizację ręczną dla początkowego ładowania historycznego. Przed synchronizacją zaznacz wymaganą na stronie autoryzację przetwarzania/udostępniania danych.

Zalecany przepływ

1. Połącz sklep i sprawdź Połączone konto.
2. Ustaw kierunek sync (w większości przypadków: Tylko do Mokapen lub Obie strony, jeśli chcesz aktualizować produkty Shopify z Mokapen).
3. Skonfiguruj duplikaty/konflikty i udostępnianie.
4. Autoryzuj i uruchom pierwszą sync (może potrwać przy dużych katalogach).
5. Sprawdź w Mokapen: Kontakty, Produkty (warianty/ilość), Zamówienia.
6. Pozostaw aktywne webhook: nowe zamówienia i aktualizacje klientów/produktów będą docierać bez ponownego uruchamiania wszystkiego.

Odłączenie

Z Integracji → Shopify → odłącz. W modalu możesz wybrać, czy zachować w Mokapen kontakty, zamówienia i produkty już zaimportowane, lub zarządzać nimi według proponowanych opcji. Po odłączeniu webhook przestają aktualizować; dane już w CRM pozostają, jeśli zdecydowałeś się je zachować. Możesz też cofnąć aplikację w panelu Shopify.

Częste problemy

• Nieprawidłowa nazwa sklepu — użyj subdomeny *.myshopify.com, nie tylko własnej domeny witryny.
• Przycisk zablokowany / upgrade — potrzebny jest odpowiedni plan Premium do e-commerce.
• Zamówienia nie w Szansach — to poprawne: trafiają do Zamówień. Otwórz Sprzedaż → Zamówienia.
• Ilość produktu — pochodzi z ilości wariantu Shopify; to nie pełny WMS.
• Raporty koszyków / analytics — jeśli na stronie widać «Wkrótce», nie są jeszcze operacyjne.
• Token wygasł / sync zatrzymana — odłącz i połącz ponownie; sprawdź, czy aplikacja nie została odinstalowana w Shopify.

Najczęstsze pytania

P: Gdzie znajdę URL sklepu?

O: W pasku adresu panelu Shopify Admin: kończy się na myshopify.com.

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

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

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

O: Tak, przy kierunku sync obejmującym export i aktywnej integracji: produkty (warianty) mogą być wysyłane/aktualizowane w sklepie.

P: Czy kontakty aktualizują się też z Mokapen do Shopify?

O: Import i webhook przenoszą klientów Shopify do CRM. Automatyczny export kontaktów nie jest dziś główną ścieżką (w odróżnieniu od produktów): sprawdź w swoim planie/środowisku po połączeniu.

P: Czy potrzebuję WooCommerce obok Shopify?

O: Nie: to dwie alternatywne integracje e-commerce. Użyj Shopify, jeśli sklep jest na Shopify; zob. przewodnik WooCommerce, jeśli używasz WordPress/Woo.