Lernen sie mokapen

Shopify

Verbinden Sie Ihren Shopify-Shop mit Mokapen, um Kunden (Kontakte), Produkte (mit Varianten und Mengen) und Bestellungen des Shops ins CRM zu übernehmen und Produkte, die in Mokapen erstellt oder aktualisiert wurden, bei passender Sync-Richtung nach Shopify zu exportieren. Ziel ist die Vereinheitlichung von E-Commerce und Vertriebssteuerung: Stammdaten, Katalog und Kaufhistorie im selben Workspace.

Allgemeine Übersicht: Integrationen. Importierte Bestellungen werden in Mokapen zu Verkaufsaufträgen (Modul Aufträge), nicht zu Pipeline-Opportunities.

Voraussetzungen

• Aktiver Shopify-Shop (URL endet mit .myshopify.com).
• Berechtigung, die Mokapen-App auf Shopify (OAuth) mit einem Store-Admin-Konto zu autorisieren.
• Ein angemessener Premium-Plan von Mokapen für E-Commerce-Integrationen. Ohne Plan öffnet die Verbindungsschaltfläche das Upgrade; in manchen Shopify-Pfaden kann auch eine wiederkehrende App-Gebühr angeboten werden.
• Mokapen-Berechtigungen für Kontakte, Produkte und Aufträge in Ihrer Organisation (siehe Rollen und Berechtigungen).
• Zugriff auf Integrationen (Mitglied/Admin je nach White-Label und Org-Rolle).

Shopify-Shop verbinden

1. Benutzermenü → Integrationen → Shopify.
2. Geben Sie den Shop-Namen ein (wie in Shopify Admin; die vollständige URL endet mit myshopify.com). Im Zweifel Shopify-Dashboard öffnen und die Browser-Adressleiste prüfen.
3. Autorisierung starten: Sie werden zu Shopify weitergeleitet, um Berechtigungen zu akzeptieren.
4. Angeforderte Scopes akzeptieren (Lesen/Schreiben Kunden und Produkte, Lesen Bestellungen — siehe unten).
5. Zurück in Mokapen: Der Shop erscheint als verbunden. Bei Ankunft aus dem Shopify App Store müssen Sie ggf. die Mokapen-Organisation wählen, auf der die Verbindung installiert wird.

Wenn Sie auf Shopify nicht akzeptieren, werden keine Daten synchronisiert. Nach der Verbindung registriert Mokapen Webhooks im Shop: Updates zu Kunden, Produkten und Bestellungen können so in Echtzeit eintreffen, zusätzlich zum Bulk-Sync, den Sie selbst starten.

Was Mokapen bei Shopify anfordert

Bei der OAuth-Autorisierung fordert Mokapen typischerweise an:

• read_customers / write_customers — Shopify-Kunden lesen (und ggf. schreiben).
• read_products / write_products — Produkte/Varianten lesen und aktualisieren.
• read_orders — Shop-Bestellungen lesen.

Mokapen ersetzt nicht das Shopify-Panel für Checkout, Themes oder Zahlungen: Es richtet Daten zum CRM aus (und bei Produkten auch vom CRM). Bei App-Widerruf in Shopify oder abgelaufenem Token trennen und in Mokapen erneut verbinden. Shopify verlangt auch GDPR-Endpunkte (Datenanfrage / Redact): Mokapen verarbeitet diese per Webhook.

Was synchronisiert wird

Richtung Mokapen (Import / Webhook)

• Kunden → Kontakte — Shopify-Stammdaten gelangen ins Adressbuch; bei Unternehmensdaten kann auch das Unternehmen erstellt/verknüpft werden. Webhooks bei Kunden create/update/delete.
• Produkte und Varianten → Produkte — Katalog mit Varianten; Shopify-Variantenbestand wird auf das Mokapen-Variantenmengenfeld gemappt (kein separates Lagermodul).
• Bestellungen → Aufträge — Shopify-Bestellungen werden in Mokapen zu Verkaufsaufträgen (mit Positionen), nicht zu Pipeline-Deals. Webhooks bei Bestellungs-Updates.
• Abgebrochene Checkouts — in der Sync kann ein Importpfad für abgebrochene Shopify-Checkouts existieren (als Bestellungen/zugehörige Daten). Dedizierte Berichte zu abgebrochenen Warenkörben / E-Commerce-Analytics auf der Seite stehen noch auf Demnächst: nicht als bereits aktive Funktion zählen.

Richtung Shopify (Export)

• Produkte — bei Sync-Richtung «nach Shopify» oder «beide» kann Mokapen Produkte im Shop exportieren/aktualisieren (Bulk-Sync und Sync-out beim Speichern eines verknüpften Produkts, wenn die Integration aktiv ist).
• Ausgehende Kontakte und Bestellungen — trotz write_customers-Scopes betrifft der heute implementierte automatische «Sync-out»-Export praktisch Produkte. Keinen vollständigen bidirektionalen Export von Kontakten oder Bestellungen voraussetzen: Kunden kommen vor allem von Shopify nach Mokapen (Import + Webhook). Wenn Marketingtexte «bidirektional nur Kontakte» erwähnen, prüfen Sie in Ihrer Umgebung, was die Sync nach der Verbindung wirklich tut.

In der Konfiguration listet die Integration auch Dienstleistungen, aber es gibt keine dedizierte E-Commerce-Dienstleistungs-Sync wie bei Produkten: Nutzen Sie Produkte für den Shop-Katalog.

Einstellungen nach der Verbindung

Auf der Shopify-Seite, mit verbundenem Shop, konfigurieren Sie typischerweise:

Sync-Richtung

• Nur nach Mokapen — Daten starten in Shopify und gelangen ins CRM.
• Beide — Import + Export (wo unterstützt; heute vor allem ausgehende Produkte).
• Nur nach Shopify — Push von Mokapen zum Shop (Produkte).

Entitäten

Kontakte, Aufträge und Produkte erscheinen als Sync-Bereiche (oft bereits ausgewählt und in der UI nicht änderbar). Historische Sync und Webhooks decken diese drei Blöcke ab.

Sync teilen

Wer den Shop verbunden hat, kann anderen Mitgliedern dieselbe Verbindung zur Verfügung stellen (gesamte Organisation oder ausgewählte Nutzer), damit nicht alle OAuth wiederholen müssen.

Duplikate und Konflikte

• Duplikate vermeiden — typische Option: Kontakte per E-Mail erkennen, um keine Doppelungen im Adressbuch zu erzeugen.
• Bei Konflikt — wählen, ob Shopify oder Mokapen gewinnt, wenn derselbe Datensatz auf beiden Seiten geändert wurde.

Automatische vs. manuelle Sync

Mit aktiver automatischer Sync halten Updates (und Webhooks) die Daten abgestimmt; Sie können dennoch eine manuelle Synchronisation für den initialen historischen Lauf starten. Vor dem Sync die auf der Seite geforderte Datenverarbeitungs-/Freigabe-Autorisierung ankreuzen.

Empfohlener Ablauf

1. Shop verbinden und Verbundenes Konto prüfen.
2. Sync-Richtung setzen (in den meisten Fällen: Nur nach Mokapen oder Beide, wenn Sie Shopify-Produkte aus Mokapen aktualisieren möchten).
3. Duplikate/Konflikte und Freigabe konfigurieren.
4. Autorisieren und erste Sync starten (kann bei großen Katalogen dauern).
5. In Mokapen prüfen: Kontakte, Produkte (Varianten/Menge), Aufträge.
6. Webhooks aktiv lassen: neue Bestellungen und Kunden-/Produkt-Updates kommen ohne jedes Mal alles neu zu starten.

Trennen

Unter Integrationen → Shopify → trennen. Im Modal können Sie wählen, ob bereits importierte Kontakte, Aufträge und Produkte in Mokapen behalten werden, oder sie gemäß den angebotenen Optionen behandeln. Nach dem Trennen aktualisieren Webhooks nicht mehr; CRM-Daten bleiben, wenn Sie sie behalten wollten. Sie können die App auch im Shopify-Panel widerrufen.

Häufige Probleme

• Ungültiger Shop-Name — Subdomain *.myshopify.com verwenden, nicht nur die Custom-Storefront-Domain.
• Schaltfläche gesperrt / Upgrade — ein angemessener Premium-Plan für E-Commerce ist erforderlich.
• Bestellungen nicht in Opportunities — korrekt: sie liegen unter Aufträge. Öffnen Sie Vertrieb → Aufträge.
• Produktmenge — stammt aus der Shopify-Variantenmenge; kein vollständiges WMS.
• Warenkorb-Berichte / Analytics — wenn auf der Seite «Demnächst» steht, sind sie noch nicht aktiv.
• Token abgelaufen / Sync stoppt — trennen und erneut verbinden; prüfen, ob die App in Shopify deinstalliert wurde.

Häufig gestellte Fragen

F: Wo finde ich die Shop-URL?

A: In der Adressleiste des Shopify-Admin-Dashboards: sie endet mit myshopify.com.

F: Werden Shopify-Bestellungen zu Opportunities?

A: Nein. In Mokapen werden sie zu Verkaufsaufträgen (mit Positionen). Texte über «Opportunities» sind zum aktuellen Verhalten ungenau.

F: Kann ich Shopify-Produkte aus Mokapen aktualisieren?

A: Ja, mit Sync-Richtung inkl. Export und aktiver Integration: Produkte (Varianten) können an den Shop gesendet/aktualisiert werden.

F: Werden Kontakte auch von Mokapen nach Shopify aktualisiert?

A: Import und Webhooks bringen Shopify-Kunden ins CRM. Automatischer Kontakt-Export ist heute nicht der Hauptpfad (im Gegensatz zu Produkten): nach der Verbindung in Ihrem Plan/Umfeld prüfen.

F: Brauche ich WooCommerce zusätzlich zu Shopify?

A: Nein: zwei alternative E-Commerce-Integrationen. Shopify nutzen, wenn der Shop auf Shopify läuft; siehe den WooCommerce-Leitfaden bei WordPress/Woo.