Lernen sie mokapen

WooCommerce

Verbinden Sie Ihren WooCommerce-Shop (WordPress) mit Mokapen, um Kunden (Kontakte), Produkte (mit Variationen und Bestand) und Bestellungen des Shops ins CRM zu übernehmen und Produkte, die in Mokapen erstellt oder aktualisiert wurden, bei passender Sync-Richtung nach WooCommerce zu exportieren. Gleiches Ziel wie Shopify: E-Commerce und Vertriebssteuerung im selben Workspace vereinen.

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

Voraussetzungen

• WordPress-Website mit aktivem WooCommerce, erreichbar über HTTPS.
• Berechtigung, Mokapen über den WC Auth-Ablauf zu autorisieren (WordPress- / WooCommerce-Administrator).
• Ein angemessener Premium-Plan von Mokapen für E-Commerce-Integrationen. Ohne Plan öffnet die Verbindungsschaltfläche das Upgrade.
• 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).

WooCommerce-Shop verbinden

1. Benutzermenü → Integrationen → WooCommerce.
2. Geben Sie die Webadresse des Shops ein (Site-URL, z. B. https://ihredomain.com). Sie finden sie in der Adressleiste im WordPress-Backend / WooCommerce-Storefront.
3. Autorisierung starten: Weiterleitung zu WordPress/WooCommerce auf die WC Auth-Seite (/wc-auth/v1/authorize) mit Scope read_write.
4. Akzeptieren Sie die Erzeugung der API-Schlüssel für Mokapen (consumer key / secret werden verschlüsselt in Mokapen gespeichert — kein manuelles Formular «API-Key einfügen»).
5. Zurück in Mokapen: Der Shop ist verbunden. Mokapen registriert WooCommerce-Webhooks (/wp-json/wc/v3/webhooks) für Echtzeit-Updates.

Wenn Sie die Autorisierung nicht akzeptieren, werden keine Daten synchronisiert. Die URL muss gültig und HTTPS sein: sonst schlägt die Validierung fehl.

Was Mokapen bei WooCommerce anfordert

Der WC Auth-Ablauf gewährt Mokapen Lese-/Schreibzugriff auf die WooCommerce-REST-APIs für Kunden, Produkte (und Variationen), Bestellungen und Webhooks. Mokapen ersetzt nicht das WooCommerce-/WordPress-Panel für Themes, Zahlungen oder Plugins: Es richtet Daten zum CRM aus (und bei Produkten auch vom CRM).

Bei Widerruf der Schlüssel oder Entfernung der Autorisierung in WordPress trennen und in Mokapen erneut verbinden.

Was synchronisiert wird

Richtung Mokapen (Import / Webhook)

• Kunden → Kontakte — WooCommerce-Kunden ins Adressbuch (und Unternehmen, wenn Daten es erlauben). Updates auch per Webhook.
• Produkte und Variationen → Produkte — Katalog mit Variationen; WooCommerce-Bestand (stock_quantity) wird auf Mokapen-Variantenmenge gemappt.
• Bestellungen → Aufträge — WooCommerce-Bestellungen werden in Mokapen zu Verkaufsaufträgen (mit Positionen), nicht zu Pipeline-Deals. Webhooks bei Updates.
• Abgebrochene Warenkörbe / Berichte — Marketing-Erwähnungen oder «Demnächst»-Einträge in der UI bedeuten keinen bereits aktiven Warenkorb-Reporting-Import wie bei anderen Flows: nicht als vollständige Funktion zählen, wenn die Seite sie noch als demnächst anzeigt.

Richtung WooCommerce (Export)

• Produkte — bei Sync-Richtung «nach WooCommerce» oder «beide» kann Mokapen Produkte im Shop exportieren/aktualisieren (Bulk-Sync und Sync-out beim Produktspeichern, wenn die Integration aktiv ist).
• Ausgehende Kontakte und Bestellungen — wie bei Shopify betrifft der heute implementierte automatische «Sync-out»-Export praktisch Produkte. Kunden kommen vor allem von WooCommerce nach Mokapen (Import + Webhook). Keinen vollständigen bidirektionalen Kontakt-Export voraussetzen, nur weil der Werbetext es nahelegt: nach der Verbindung prüfen.

In der Konfiguration erscheint auch Dienstleistungen, aber es gibt keine dedizierte Dienstleistungs-Sync: für den Shop-Katalog Produkte nutzen.

Einstellungen nach der Verbindung

Auf der WooCommerce-Seite, mit verbundenem Shop:

Sync-Richtung

• Nur nach Mokapen — WooCommerce → CRM.
• Beide — Import + Export (wo unterstützt; heute vor allem ausgehende Produkte).
• Nur nach WooCommerce — Mokapen → Shop (Produkte).

Entitäten

Kontakte, Aufträge und Produkte sind die Sync-Bereiche (oft vorausgewählt und in der UI nicht änderbar).

Sync teilen

Wer verbunden hat, kann die Verbindung mit der gesamten Organisation oder ausgewählten Nutzern teilen.

Duplikate und Konflikte

• Duplikate vermeiden — typischerweise Kontakterkennung per E-Mail.
• Bei Konflikt — WooCommerce oder Mokapen gewinnt.

Datenschutz (WooCommerce)

Anders als bei Shopify finden Sie auf der WooCommerce-Seite ggf. auch Datenschutz- und Mitarbeiter/Stakeholder-Steuerungen zur Sichtbarkeit synchronisierter Daten in der Org. Setzen Sie diese, wenn das Team nicht den gesamten importierten Katalog/Kunden gleich sehen soll.

Automatische vs. manuelle Sync

Automatische Sync für laufende Updates aktivieren (zusammen mit Webhooks); manuelle Sync für den historischen Lauf. Vor dem Sync die Daten-Autorisierung auf der Seite ankreuzen.

Empfohlener Ablauf

1. HTTPS und aktuelles WooCommerce auf der Site prüfen.
2. Shop unter Integrationen → WooCommerce verbinden und WC Auth abschließen.
3. Sync-Richtung, Duplikate, Konflikte, Datenschutz (falls vorhanden) und Freigabe setzen.
4. Autorisieren und erste Sync starten.
5. Kontakte, Produkte (Variationen/Bestand), Aufträge in Mokapen prüfen.
6. Webhooks für neue Ereignisse aktiv lassen, ohne jedes Mal alles neu zu starten.

Trennen

Unter Integrationen → WooCommerce → trennen. Im Modal wählen, ob bereits importierte Kontakte, Aufträge und Produkte in Mokapen behalten werden. Nach dem Trennen aktualisieren Webhooks nicht mehr; CRM-Daten bleiben, wenn Sie sie behalten wollten. Schlüssel/Autorisierungen können auch im WordPress-Panel widerrufen werden.

Häufige Probleme

• Ungültige URL / kein HTTPS — vollständige Site-Adresse mit https:// verwenden.
• Autorisierung fehlgeschlagen — WordPress-Admin erforderlich; prüfen, ob WooCommerce und REST-Permalinks funktionieren (Firewall/Sicherheits-Plugins können WC Auth oder Webhooks blockieren).
• Schaltfläche gesperrt / Upgrade — angemessener Premium-Plan für E-Commerce erforderlich.
• Bestellungen nicht in Opportunities — korrekt: sie liegen unter Aufträge (Vertrieb → Aufträge).
• Bestand / Menge — stammt aus stock_quantity der Variationen; kein vollständiges WMS.
• Webhooks kommen nicht an — Site muss aus dem Internet erreichbar sein; lokale oder Basic-Auth-Umgebungen erhalten WooCommerce-Benachrichtigungen oft nicht.

Häufig gestellte Fragen

F: Muss ich API-Schlüssel manuell in WooCommerce erzeugen?

A: Nein. Nutzen Sie den WC Auth-Ablauf von der Mokapen-Integrationsseite: Schlüssel werden bei Rückkehr aus der Autorisierung erstellt und gespeichert.

F: Werden WooCommerce-Bestellungen zu Opportunities?

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

F: Kann ich WooCommerce-Produkte aus Mokapen aktualisieren?

A: Ja, mit Sync-Richtung inkl. Export und aktiver Integration.

F: Unterschied zu Shopify?

A: Gleiches Datenmodell (Kontakte, Produkte, Aufträge) und gleiche E-Commerce-Premium-Logik. Unterschied die Verbindung: Shopify nutzt OAuth in der Shopify-App; WooCommerce WC Auth auf Ihrer WordPress-Site-URL. Siehe auch den Shopify-Leitfaden.

F: Ist HTTPS erforderlich?

A: Ja. Ohne HTTPS sind Verbindung und Webhooks nicht zuverlässig (und URL-Validierung kann fehlschlagen).