Průvodce Mokapenem

Shopify

Propojte 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é nebo aktualizované v Mokapenu do Shopify, pokud to směr synchronizace umožňuje. Pomáhá sjednotit e-commerce a prodejní management: kmenová data, katalog a historie nákupů 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

• Aktivní obchod Shopify (URL končící na .myshopify.com).
• Oprávnění autorizovat aplikaci Mokapen v Shopify (OAuth) s účtem administrátora obchodu.
• vhodný plán Premium Mokapen pro e-commerce integrace. Bez plánu otevře tlačítko připojení obrazovku upgradu; v některých tocích Shopify může být také nabídnut opakující se poplatek spojený s aplikací.
• 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 Shopify

1. Uživatelské menu → Integrace → Shopify.
2. Zadejte název obchodu (jako v Shopify Admin; celá URL končí na myshopify.com). Pokud si nejste jisti, otevřete panel Shopify a zkontrolujte adresní řádek prohlížeče.
3. Spusťte autorizaci: budete přesměrováni do Shopify k přijetí oprávnění.
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ý. Pokud přijdete z Shopify App Store, možná budete muset zvolit organizaci Mokapen, na kterou připojení nainstalujete.

Pokud v Shopify nepřijmete, žádná data se nesynchronizují. Po připojení Mokapen zaregistruje na obchodě webhooky: aktualizace zákazníků, produktů a objednávek tak mohou přicházet v reálném čase, kromě hromadné synchronizace, kterou spustíte sami.

Co Mokapen žádá od Shopify

Během 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 aktualizace produktů/variant.
• read_orders — čtení objednávek obchodu.

Mokapen nenahrazuje panel Shopify pro checkout, šablony nebo platby: sladí data směrem do (a u produktů i z) CRM. Pokud aplikaci zrušíte v Shopify nebo token vyprší, odpojte a znovu připojte z Mokapenu. Shopify také vyžaduje GDPR endpointy (data request / redact): Mokapen je obsluhuje přes webhook.

Co se synchronizuje

Směrem do Mokapenu (import / webhook)

• Zákazníci → Kontakty — kmenová data Shopify vstoupí do adresáře; pokud jsou k dispozici údaje o společnosti, společnost může být také vytvořena/propojena. Webhooky při vytvoření/aktualizaci/smazání zákazníka.
• Produkty a varianty → Produkty — katalog 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 prodejními objednávkami v Mokapenu (s položkami), ne obchodními příležitostmi v pipeline. Webhooky při aktualizaci objednávek.
• Opuštěné checkouty — synchronizace může zahrnovat cestu pro import opuštěných checkoutů Shopify (jako objednávky/související data). Vyhrazené sestavy pro opuštěné košíky / e-commerce analytiku na stránce stále ukazují Coming soon: nepočítejte s nimi jako s aktivní funkcí.

Směrem do Shopify (export)

• Produkty — se směrem synchronizace «směrem do Shopify» nebo «oba» může Mokapen exportovat/aktualizovat produkty v obchodě (hromadná synchronizace a sync-out při uložení propojeného produktu, pokud je integrace aktivní).
• Odchozí kontakty a objednávky — navzdory rozsahům write_customers se automatický export «sync out» implementovaný dnes v praxi vztahuje na produkty. Nepředpokládejte plný obousměrný export kontaktů nebo objednávek: zákazníci přicházejí hlavně ze Shopify do Mokapenu (import + webhook). Pokud marketingový text zmiňuje «obousměrné kontakty pouze», ověřte ve svém prostředí, co synchronizace skutečně dělá po připojení.

V konfiguraci integrace jsou také uvedeny služby, ale neexistuje dedikovaná synchronizace e-commerce služeb jako u produktů: pro katalog obchodu použijte Produkty.

Nastavení po připojení

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

Směr synchronizace

• Pouze směrem do Mokapenu — data proudí ze Shopify do CRM.
• Oba — import + export (kde je podporován; dnes hlavně odchozí produkty).
• Pouze směrem do Shopify — push z Mokapenu do obchodu (produkty).

Entity

Kontakty, objednávky a produkty se zobrazují jako rozsahy synchronizace (často již vybrané a neupravitelné z UI). Historická synchronizace a webhooky pokrývají tyto tři bloky.

Sdílení synchronizace

Kdo obchod připojil, může ostatním členům umožnit používat stejné připojení (celá organizace nebo vybraní uživatelé), takže nemusí každý opakovat OAuth.

Duplicity a konflikty

• Vyhnout se duplicitám — typická možnost: kontakty rozpoznané podle e-mailu, aby se zabránilo duplicitám v adresáři.
• V případě konfliktu — zvolte, zda při úpravě stejného záznamu na obou stranách převládne Shopify nebo Mokapen.

Automatická vs ruční synchronizace

S aktivní automatickou synchronizací aktualizace (a webhooky) udržují data v souladu; stále můžete spustit ruční synchronizaci pro počáteční historický load. Před synchronizací zkontrolujte autorizaci zpracování/sdílení dat požadovanou na stránce.

Doporučený postup

1. Připojte obchod a ověřte Připojený účet.
2. Nastavte směr synchronizace (pro většinu případů: Pouze směrem do Mokapenu nebo Oba, pokud chcete aktualizovat produkty Shopify z Mokapenu).
3. Nakonfigurujte duplicity/konflikty a sdílení.
4. Autorizujte a spusťte první synchronizaci (u velkých katalogů může trvat dlouho).
5. Zkontrolujte v Mokapenu: Kontakty, Produkty (varianty/množství), Objednávky.
6. Nechte webhooky aktivní: nové objednávky a aktualizace zákazníků/produktů přijdou bez opětovného spuštění všeho pokaždé.

Odpojení

Z Integrace → Shopify → odpojit. V modálním okně můžete zvolit, zda ponechat kontakty, objednávky a produkty již importované v Mokapenu, nebo je zpracovat podle nabízených možností. Po odpojení webhooky přestanou aktualizovat; data již v CRM zůstanou, pokud jste se rozhodli je ponechat. Aplikaci můžete také zrušit z panelu Shopify.

Časté problémy

• Neplatný název obchodu — použijte subdoménu *.myshopify.com, ne pouze vlastní doménu storefrontu.
• 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. Otevřete Prodej → Objednávky.
• Množství produktu — pochází z množství varianty Shopify; nejde o plný WMS.
• Sestavy košíků / analytika — pokud na stránce ukazují «Coming soon», ještě nejsou v provozu.
• Vypršel token / synchronizace zastavena — odpojte a znovu připojte; ověřte, že aplikace nebyla odinstalována ze 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 příležitostmi?

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

O: Mohu aktualizovat produkty Shopify z Mokapenu?

A: Ano, se směrem synchronizace zahrnujícím export a aktivní integrací: produkty (varianty) lze odeslat/aktualizovat v obchodě.

O: Aktualizují se kontakty také z Mokapenu do Shopify?

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

O: Potřebuji WooCommerce vedle Shopify?

A: Ne: jsou to dvě alternativní e-commerce integrace. Použijte Shopify, pokud je váš obchod na Shopify; viz průvodce WooCommerce, pokud používáte WordPress/Woo.