Průvodce Mokapenem

WooCommerce

Propojte svůj obchod WooCommerce (WordPress) s Mokapenem a přiveďte do CRM zákazníky (kontakty), produkty (s variacemi a skladem) a objednávky obchodu, a exportujte produkty vytvořené nebo aktualizované v Mokapenu do WooCommerce, pokud to směr synchronizace umožňuje. Stejný cíl jako Shopify: sjednotit e-commerce a prodejní management ve stejném pracovním prostoru.

Obecný přehled: Integrace. Importované objednávky se stanou prodejními objednávkami v Mokapenu (modul Objednávky), ne příležitostmi v pipeline.

Požadavky

• WordPress web s aktivním WooCommerce, dostupný přes HTTPS.
• Oprávnění autorizovat Mokapen přes tok WC Auth (administrátor WordPress / WooCommerce).
• vhodný plán Premium Mokapen pro e-commerce integrace. Bez plánu otevře tlačítko připojení obrazovku upgradu.
• Oprávnění Mokapen ke kontaktům, produktům a objednávkám ve vaší organizaci (viz Role a oprávnění).
• Přístup k Integracím (člen/admin podle white-label a role v org).

Připojení obchodu WooCommerce

1. Uživatelské menu → Integrace → WooCommerce.
2. Zadejte webovou adresu obchodu (URL webu, např. https://yourdomain.com). Najdete ji v adresním řádku, když jste v backendu WordPress / storefrontu WooCommerce.
3. Spusťte autorizaci: budete přesměrováni do WordPress/WooCommerce na stránku WC Auth (/wc-auth/v1/authorize) s rozsahem read_write.
4. Přijměte generování API klíčů pro Mokapen (consumer key / secret jsou uloženy šifrovaně v Mokapenu — neexistuje ruční formulář «vložit API klíč»).
5. Vraťte se do Mokapenu: obchod je připojen. Mokapen zaregistruje webhooky WooCommerce (/wp-json/wc/v3/webhooks) pro příjem aktualizací v reálném čase.

Pokud autorizaci nepřijmete, žádná data se nesynchronizují. URL musí být platná a HTTPS: jinak validace selže.

Co Mokapen žádá od WooCommerce

Tok WC Auth uděluje Mokapenu přístup ke čtení/zápisu REST API WooCommerce potřebný pro zákazníky, produkty (a variace), objednávky a webhooky. Mokapen nenahrazuje panel WooCommerce/WordPress pro šablony, platby nebo pluginy: sladí data směrem do (a u produktů i z) CRM.

Pokud klíče zrušíte nebo odeberete autorizaci na straně WordPress, odpojte a znovu připojte z Mokapenu.

Co se synchronizuje

Směrem do Mokapenu (import / webhook)

• Zákazníci → Kontakty — zákazníci WooCommerce v adresáři (a společnost, pokud data umožňují). Aktualizace také přes webhook.
• Produkty a variace → Produkty — katalog s variacemi; sklad WooCommerce (stock_quantity) se mapuje na množství varianty Mokapen.
• Objednávky → Objednávky — objednávky WooCommerce se stanou prodejními objednávkami v Mokapenu (s položkami), ne obchodními příležitostmi v pipeline. Webhooky při aktualizacích.
• Opuštěné košíky / sestavy — marketingové zmínky nebo položky «Coming soon» v UI neznamenají aktivní import sestav košíků jako u jiných toků: nepočítejte s nimi jako s kompletní funkcí, pokud na stránce stále ukazují coming soon.

Směrem do WooCommerce (export)

• Produkty — se směrem synchronizace «směrem do WooCommerce» nebo «oba» může Mokapen exportovat/aktualizovat produkty v obchodě (hromadná synchronizace a sync-out při uložení produktu, pokud je integrace aktivní).
• Odchozí kontakty a objednávky — jako u Shopify se automatický export «sync out» implementovaný dnes v praxi vztahuje na produkty. Zákazníci přicházejí hlavně z WooCommerce do Mokapenu (import + webhook). Nepředpokládejte plný obousměrný export kontaktů jen proto, že to naznačuje obchodní text: ověřte po připojení.

Konfigurace také zobrazuje služby, ale neexistuje dedikovaná synchronizace služeb: pro katalog obchodu použijte Produkty.

Nastavení po připojení

Na stránce WooCommerce s připojeným obchodem:

Směr synchronizace

• Pouze směrem do Mokapenu — WooCommerce → CRM.
• Oba — import + export (kde je podporován; dnes hlavně odchozí produkty).
• Pouze směrem do WooCommerce — Mokapen → obchod (produkty).

Entity

Kontakty, objednávky a produkty jsou rozsahy synchronizace (často předvybrané a neupravitelné z UI).

Sdílení synchronizace

Kdo připojil, může sdílet připojení s celou organizací nebo vybranými uživateli.

Duplicity a konflikty

• Vyhnout se duplicitám — typicky rozpoznání kontaktu podle e-mailu.
• V případě konfliktu — převládne WooCommerce nebo Mokapen.

Ochrana soukromí (WooCommerce)

Na rozdíl od Shopify můžete na stránce WooCommerce najít také ovládací prvky ochrany soukromí a spolupracovníků/zainteresovaných stran související s viditelností synchronizovaných dat v org. Nastavte je, pokud tým nemá vidět celý importovaný katalog/zákazníky stejným způsobem.

Automatická vs ruční synchronizace

Povolte automatickou synchronizaci pro průběžné aktualizace (spolu s webhooky); použijte ruční synchronizaci pro historický load. Před synchronizací zkontrolujte autorizaci dat na stránce.

Doporučený postup

1. Ověřte HTTPS a aktuální WooCommerce na webu.
2. Připojte obchod z Integrace → WooCommerce a dokončete WC Auth.
3. Nastavte směr synchronizace, duplicity, konflikty, ochranu soukromí (pokud je k dispozici) a sdílení.
4. Autorizujte a spusťte první synchronizaci.
5. Zkontrolujte Kontakty, Produkty (variance/sklad), Objednávky v Mokapenu.
6. Nechte webhooky aktivní pro nové události bez opětovného spuštění všeho pokaždé.

Odpojení

Z Integrace → WooCommerce → odpojit. V modálním okně zvolte, zda ponechat kontakty, objednávky a produkty již importované v Mokapenu. Po odpojení webhooky již neaktualizují; data již v CRM zůstanou, pokud jste je ponechali. Klíče/autorizace můžete také zrušit z panelu WordPress.

Časté problémy

• Neplatná URL / bez HTTPS — použijte úplnou adresu webu s https://.
• Autorizace selhala — vyžaduje se administrátor WordPress; ověřte, že WooCommerce a REST permalinky fungují (firewall/bezpečnostní pluginy mohou blokovat WC Auth nebo webhooky).
• Tlačítko blokováno / upgrade — vyžaduje se vhodný plán Premium pro e-commerce.
• Objednávky ne v Příležitostech — to je správně: jdou do Objednávek (Prodej → Objednávky).
• Sklad / množství — pochází z stock_quantity variace; nejde o plný WMS.
• Webhooky nepřicházejí — web musí být dostupný z internetu; lokální prostředí nebo basic-auth často nepřijímají notifikace WooCommerce.

Často kladené otázky

O: Musím ručně generovat API klíče ve WooCommerce?

A: Ne. Použijte tok WC Auth ze stránky Integrace Mokapen: klíče se vytvoří a uloží při návratu z autorizace.

O: Stávají se objednávky WooCommerce příležitostmi?

A: Ne. V Mokapenu se stanou prodejními objednávkami. Jakýkoli text odkazující na «příležitosti» neodpovídá aktuálnímu chování.

O: Mohu aktualizovat produkty WooCommerce z Mokapenu?

A: Ano, se směrem synchronizace zahrnujícím export a aktivní integrací.

O: Rozdíl oproti Shopify?

A: Stejný datový model (kontakty, produkty, objednávky) a stejná logika Premium pro e-commerce. Připojení se liší: Shopify používá OAuth na aplikaci Shopify; WooCommerce používá WC Auth na URL vašeho WordPress webu. Viz také průvodce Shopify.

O: Je HTTPS povinné?

A: Ano. Bez HTTPS není připojení a webhooky spolehlivé (a validace URL může selhat).