Sprievodca Mokapenom

Shopify

Prepojte svůj obchod Shopify s Mokapenem a přiveďte do CRM zákazníky (kontakty), produkty (s variantami a množstvími) a objednávky obchodu, a exportujte produkty vytvořené alebo aktualizované v Mokapenu do Shopify, pokud to smer synchronizácia umožňuje. Pomáhá sjednotit e-commerce a predajní management: kmenová dátumy, katalóg a história nákupů 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

• Aktivní obchod Shopify (URL končící na .myshopify.com).
• Oprávnenia autorizovat aplikaci Mokapen v Shopify (OAuth) s účtem administrátora obchodu.
• vhodný plán Premium Mokapen pre e-commerce integrácie. Bez plánu otevře tlačidlo pripojení obrazovku upgradu; v něktorých tocích Shopify môže byť tiež nabídnut opakující se poplatek spojený s aplikací.
• 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 Shopify

1. Používateľské menu → Integrácie → Shopify.
2. Zadajte názov obchodu (jako v Shopify Admin; celá URL končí na myshopify.com). Ak si nejste jisti, otvorte panel Shopify a skontrolujte adresní riadok prohlížeče.
3. Spustite autorizáciu: budete přesměrováni do Shopify k přijetí oprávnenia.
4. Přijměte požadované rozsahy (čtení/zápis zákazníků a produktů, čtení objednávek — viz níže).
5. Vraťte se do Mokapenu: obchod se zobrazí jako připojený. Ak přijdete z Shopify App Store, možná budete muset zvolit organizácii Mokapen, na ktorú pripojení nainstalujete.

Ak v Shopify nepřijmete, žiadna údaje sa nesynchronizujú. Po pripojení Mokapen zaregistruje na obchodě webhooky: aktualizácie zákazníků, produktů a objednávek tak mohou přicházet v reálnom čase, kromě hromadné synchronizácia, ktorú spustíte sami.

Co Mokapen žádá od Shopify

Počas OAuth autorizace Mokapen typicky požaduje:

• read_customers / write_customers — čtení (a potenciálně zápis) zákazníků Shopify.
• read_products / write_products — čtení a aktualizácie produktů/variant.
• read_orders — čtení objednávek obchodu.

Mokapen nenahrazuje panel Shopify pre checkout, šablóny alebo platby: zosúladí údaje smerom do (a u produktů i z) CRM. Ak aplikaci zrušíte v Shopify alebo token vyprší, odpojte a znova pripojte z Mokapenu. Shopify tiež vyžaduje GDPR endpointy (údaje request / redact): Mokapen je obsluhuje cez webhook.

Co se synchronizuje

Smerem do Mokapenu (import / webhook)

• Zákazníci → Kontakty — kmenová údaje Shopify vstoupí do adresáře; pokud sú k dispozícii údaje o spoločnosti, spoločnosť môže byť tiež vytvořena/prepojena. Webhooky pri vytvorenie/aktualizaci/smazání zákazníka.
• Produkty a varianty → Produkty — katalóg s variantami; množství skladu varianty Shopify se mapuje na pole množství varianty Mokapen (ne samostatný skladový modul).
• Objednávky → Objednávky — objednávky Shopify se stanou predajními objednávkami v Mokapenu (s položkami), ne obchodnémi príležitosťmi v pipeline. Webhooky pri aktualizaci objednávek.
• Opuštěné checkouty — synchronizácia môže zahrnovat cestu pre import opuštěných checkoutů Shopify (jako objednávky/súvisiace dátumy). Vyhrazené sestavy pre opuštěné košíky / e-commerce analytiku na stránke stále ukazují Coming soon: nepočítejte s nimi jako s aktívna funkcí.

Smerem do Shopify (export)

• Produkty — se směrem synchronizácia «smerom do Shopify» alebo «oba» môže Mokapen exportovať/aktualizovat produkty v obchodě (hromadná synchronizácia a sync-out pri uložení prepojeného produktu, ak je integrácie aktívna).
• Odchozí kontakty a objednávky — navzdory rozsahům write_customers se automatický export «sync out» implementovaný dnes v praxi vztahuje na produkty. Niepředpokládejte plný obousměrný export kontaktů alebo objednávek: zákazníci přicházejí hlavně zo Shopify do Mokapenu (import + webhook). Ak marketingový text zmiňuje «obousměrné kontakty pouze», overte ve svém prostředí, co synchronizácia skutečně dělá po pripojení.

V konfiguraci integrácie sú tiež uvedeny služby, ale neexistuje dedikovaná synchronizácia e-commerce služeb jako u produktů: pre katalóg obchodu použite Produkty.

Nastavenia po pripojení

Na stránke Shopify s připojeným obchodem typicky nakonfigurujete:

Smer synchronizácia

• Iba smerom do Mokapenu — údaje proudí zo Shopify do CRM.
• Oba — import + export (kde je podporovaný; dnes hlavně odchozí produkty).
• Iba smerom do Shopify — push z Mokapenu do obchodu (produkty).

Entity

Kontakty, objednávky a produkty se zobrazují jako rozsahy synchronizácia (často už vybrané a neupraviťelné z UI). Historická synchronizácia a webhooky pokrývají tyto tři bloky.

Sdílení synchronizácia

Kdo obchod pripojil, môže ostatním členovm umožnit používať stejné pripojení (celá organizácie alebo vybraní používaťelia), takže nemusí každý opakovat OAuth.

Duplicity a konflikty

• Vyhnúť sa duplicitám — typická možnost: kontakty rozpoznané podľa e-mailu, aby se zabránilo duplicitám v adresári.
• V prípadě konfliktu — zvoľte, či pri úpravě stejného záznamu na obou stranách převládne Shopify alebo Mokapen.

Automatická vs ruční synchronizácia

S aktívna automatickou synchronizáciou aktualizácie (a webhooky) udržují údaje v souladu; stále môžete spustit ruční synchronizáciu pre počáteční historický load. Pred synchronizáciou skontrolujte autorizáciu zpracování/sdílení dat požadovanou na stránke.

Doporučený postup

1. Připojte obchod a overte Připojený účet.
2. Nastavte smer synchronizácia (pre většinu prípadů: Iba smerom do Mokapenu alebo Oba, ak chcete aktualizovat produkty Shopify z Mokapenu).
3. Nakonfigurujte duplicity/konflikty a sdílení.
4. Autorizujte a spustite první synchronizáciu (u velkých katalógů môže trvat dlouho).
5. Skontrolujte v Mokapenu: Kontakty, Produkty (varianty/množství), Objednávky.
6. Niechte webhooky aktívna: nové objednávky a aktualizácie zákazníků/produktů přijdou bez opětovného spuštění všeho pokaždé.

Odpojenie

Z Integrácie → Shopify → odpojiť. V modálním okně môžete zvolit, či ponechať kontakty, objednávky a produkty už importované v Mokapenu, alebo je zpracovat podľa nabízených možností. Po odpojenie webhooky přestanou aktualizovat; údaje už v CRM zůstanou, pokud jste se rozhodli je ponechať. Aplikaci môžete tiež zrušit z panelu Shopify.

Časté problémy

• Nieplatný názov obchodu — použite subdoménu *.myshopify.com, ne iba vlastní doménu storefrontu.
• 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. Otvorte Predaj → Objednávky.
• Množství produktu — pochází z množství varianty Shopify; neide o plný WMS.
• Sestavy košíků / analytika — pokud na stránke ukazují «Coming soon», ešte nesú v provozu.
• Vypršel token / synchronizácia zastavena — odpojte a znova pripojte; overte, že aplikácie nebyla odinstalována zo Shopify.

Často kladené otázky

O: Kde najdu URL obchodu?

A: V adresním řádku panelu Shopify Admin: končí na myshopify.com.

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

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

O: Mohu aktualizovat produkty Shopify z Mokapenu?

A: Áno, se směrem synchronizácia zahrnujícím export a aktívna integrácií: produkty (varianty) lzo odeslat/aktualizovat v obchodě.

O: Aktualizují se kontakty tiež z Mokapenu do Shopify?

A: Import a webhooky přivádějí zákazníky Shopify do CRM. Automatický export kontaktů nie je dnes hlavní cesta (na rozdíl od produktů): overte ve svém plánu/prostředí po pripojení.

O: Potřebuji WooCommerce vedle Shopify?

A: Nie: sú to dvě alternativní e-commerce integrácie. Použite Shopify, ak je váš obchod na Shopify; viz sprievodca WooCommerce, pokud používate WordPress/Woo.