Sprievodca Mokapenom

WooCommerce

Prepojte 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é alebo aktualizované v Mokapenu do WooCommerce, pokud to smer synchronizácia umožňuje. Stejný cíl jako Shopify: sjednotit e-commerce a predajní management ve stejném pracovném prostoru.

Obecný prehľad: Integrácie. Importované objednávky se stanou predajními objednávkami v Mokapenu (modul Objednávky), ne príležitosťmi v pipeline.

Požiadavky

• WordPress web s aktívnam WooCommerce, dostupný cez HTTPS.
• Oprávnenia autorizovat Mokapen cez tok WC Auth (administrátor WordPress / WooCommerce).
• vhodný plán Premium Mokapen pre e-commerce integrácie. Bez plánu otevře tlačidlo pripojení obrazovku upgradu.
• Oprávnenia Mokapen ku kontaktům, produktům a objednávkám ve vaší organizácii (viz Role a oprávnenia).
• Prístup k Integracím (člen/admin podľa white-label a role v org).

Pripojenie obchodu WooCommerce

1. Používateľské menu → Integrácie → WooCommerce.
2. Zadajte webovou adresu obchodu (URL webu, napr. https://yourdomain.com). Najdete ji v adresním řádku, keď jste v backendu WordPress / storefrontu WooCommerce.
3. Spustite autorizáciu: 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 kľúčů pre Mokapen (consumer key / secret sú uloženy šifrovaně v Mokapenu — neexistuje ruční formulář «vložit API kľúč»).
5. Vraťte se do Mokapenu: obchod je připojen. Mokapen zaregistruje webhooky WooCommerce (/wp-json/wc/v3/webhooks) pre příjem aktualizací v reálnom čase.

Ak autorizáciu nepřijmete, žiadna údaje sa nesynchronizujú. URL musí byť platná a HTTPS: jinak validace selže.

Co Mokapen žádá od WooCommerce

Tok WC Auth uděluje Mokapenu prístup ku čtení/zápisu REST API WooCommerce potřebný pre zákazníky, produkty (a variace), objednávky a webhooky. Mokapen nenahrazuje panel WooCommerce/WordPress pre šablóny, platby alebo pluginy: zosúladí údaje smerom do (a u produktů i z) CRM.

Ak kľúče zrušíte alebo odeberete autorizáciu na straně WordPress, odpojte a znova pripojte z Mokapenu.

Co se synchronizuje

Smerem do Mokapenu (import / webhook)

• Zákazníci → Kontakty — zákazníci WooCommerce v adresári (a spoločnosť, pokud údaje umožňují). Aktualizácie tiež cez webhook.
• Produkty a variace → Produkty — katalóg s variacemi; sklad WooCommerce (stock_quantity) se mapuje na množství varianty Mokapen.
• Objednávky → Objednávky — objednávky WooCommerce se stanou predajními objednávkami v Mokapenu (s položkami), ne obchodnémi príležitosťmi v pipeline. Webhooky pri aktualizáciách.
• Opuštěné košíky / sestavy — marketingové zmínky alebo položky «Coming soon» v UI neznamenají aktívna import sestav košíků ako pri iných toků: nepočítejte s nimi jako s kompletní funkcí, pokud na stránke stále ukazují coming soon.

Smerem do WooCommerce (export)

• Produkty — se směrem synchronizácia «smerom do WooCommerce» alebo «oba» môže Mokapen exportovať/aktualizovat produkty v obchodě (hromadná synchronizácia a sync-out pri uložení produktu, ak je integrácie aktívna).
• 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). Niepředpokládejte plný obousměrný export kontaktů len proto, že to naznačuje obchodné text: overte po pripojení.

Konfigurace tiež zobrazuje služby, ale neexistuje dedikovaná synchronizácia služeb: pre katalóg obchodu použite Produkty.

Nastavenia po pripojení

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

Smer synchronizácia

• Iba smerom do Mokapenu — WooCommerce → CRM.
• Oba — import + export (kde je podporovaný; dnes hlavně odchozí produkty).
• Iba smerom do WooCommerce — Mokapen → obchod (produkty).

Entity

Kontakty, objednávky a produkty sú rozsahy synchronizácia (často předvybrané a neupraviťelné z UI).

Sdílení synchronizácia

Kdo pripojil, môže sdílet pripojení s celou organizácií alebo vybranými používaťeľi.

Duplicity a konflikty

• Vyhnúť sa duplicitám — typicky rozpoznání kontaktu podľa e-mailu.
• V prípadě konfliktu — převládne WooCommerce alebo Mokapen.

Ochrana súkromie (WooCommerce)

Na rozdíl od Shopify môžete na stránke WooCommerce najít tiež ovládací prvky ochrany súkromie a spolupracovnéků/zainteresovaných stran súvisiace s viditeľnosťí synchronizovaných dat v org. Nastavte je, pokud tím nemá vidět celý importovaný katalóg/zákazníky stejným způsobem.

Automatická vs ruční synchronizácia

Povolte automatickou synchronizáciu pre průběžné aktualizácie (spolu s webhooky); použite ruční synchronizáciu pre historický load. Pred synchronizáciou skontrolujte autorizáciu dat na stránke.

Doporučený postup

1. Overte HTTPS a aktuální WooCommerce na webu.
2. Připojte obchod z Integrácie → WooCommerce a dokončiťe WC Auth.
3. Nastavte smer synchronizácia, duplicity, konflikty, ochranu súkromie (ak je k dispozícii) a sdílení.
4. Autorizujte a spustite první synchronizáciu.
5. Skontrolujte Kontakty, Produkty (variance/sklad), Objednávky v Mokapenu.
6. Niechte webhooky aktívna pre nové udalosti bez opětovného spuštění všeho pokaždé.

Odpojenie

Z Integrácie → WooCommerce → odpojiť. V modálním okně zvoľte, či ponechať kontakty, objednávky a produkty už importované v Mokapenu. Po odpojenie webhooky už neaktualizují; údaje už v CRM zůstanou, pokud jste je ponechali. Kľúče/autorizace môžete tiež zrušit z panelu WordPress.

Časté problémy

• Nieplatná URL / bez HTTPS — použite úplnou adresu webu s https://.
• Autorizace selhala — vyžaduje se administrátor WordPress; overte, že WooCommerce a REST permalinky fungují (firewall/bezpečnostní pluginy mohou blokovat WC Auth alebo webhooky).
• Tlačidlo blokováno / upgrade — vyžaduje se vhodný plán Premium pre e-commerce.
• Objednávky ne v Príležitosťech — to je správně: idú do Objednávek (Predaj → Objednávky).
• Sklad / množství — pochází z stock_quantity variace; neide o plný WMS.
• Webhooky nepřicházejí — web musí byť dostupný z internetu; lokální prostředí alebo basic-auth často nepřijímají notifikace WooCommerce.

Často kladené otázky

O: Musím ručně generovat API kľúče ve WooCommerce?

A: Nie. Použite tok WC Auth zo stránky Integrácie Mokapen: kľúče se vytvorí a uloží pri návratu z autorizace.

O: Stávají se objednávky WooCommerce príležitosťmi?

A: Nie. V Mokapenu se stanou predajními objednávkami. Jakýkoli text odkazující na «príležitosťi» nezodpovedá aktuálnímu správanie.

O: Mohu aktualizovat produkty WooCommerce z Mokapenu?

A: Áno, se směrem synchronizácia zahrnujícím export a aktívna integrácií.

O: Rozdíl oproti Shopify?

A: Stejný datový model (kontakty, produkty, objednávky) a rovnaká logika Premium pre e-commerce. Pripojenie se líšia: Shopify používá OAuth na aplikaci Shopify; WooCommerce používá WC Auth na URL vašeho WordPress webu. Viz tiež sprievodca Shopify.

O: Je HTTPS povinné?

A: Áno. Bez HTTPS nie je pripojení a webhooky spolehlivé (a validace URL môže selhat).