Externe Commerce-Synchronisierung

Übersicht

Kanäle & Integrationen → Externer Commerce (/de/integrations/commerce) hält den Checkout auf Shopify oder WooCommerce aufrecht, während unterstützte Daten in OrderInChat gespiegelt werden. Das Widget, die KI für WhatsApp und Instagram, Automatisierungen und optionale Versandetiketten verwenden die gespiegelten Daten.

Diese Integration klont nicht das Quell-Theme und ersetzt nicht den externen Checkout.

Shopify-Verbindung

OrderInChat verwendet Shopify OAuth, sodass Sie Tokens nicht manuell kopieren müssen.

1. Erstellen Sie im Shopify Partner-Dashboard eine App mit dem Namen Order in Chat.
2. Fügen Sie die Callback-URL https://app.orderinchat.com/api/store/commerce/shopify/oauth/callback zu Erlaubte Umleitungs-URL(s) hinzu.
3. Gewähren Sie diese Admin-API-Berechtigungen: read_products, write_products, read_inventory, write_inventory, read_orders, read_customers, read_content, read_legal_policies, read_discounts, read_shipping, read_files, read_locales, read_locations, read_script_tags, write_script_tags.
4. Gehen Sie in OrderInChat zu Kanäle & Integrationen → Externer Commerce, wählen Sie Shopify, geben Sie die HTTPS-Shop-URL ein (zum Beispiel https://your-store.myshopify.com) und klicken Sie auf Mit Shopify verbinden.
5. Genehmigen Sie die Berechtigungen in Shopify. Sie kehren automatisch zu OrderInChat zurück. Klicken Sie dann auf Verbindung testen, Webhooks registrieren und Jetzt synchronisieren.

Wenn Sie OAuth nicht verwenden können, erweitern Sie den Abschnitt Manuelle Token-Einrichtung und fügen Sie das Admin-API-Zugriffstoken und den API-Geheimschlüssel der benutzerdefinierten App ein. Der API-Geheimschlüssel ist erforderlich, um die HMAC-Signaturen von Shopify-Webhooks zu überprüfen. OrderInChat verschlüsselt Anmeldeinformationen und zeigt sie nie wieder an.

Offizielle Anleitungen: Shopify benutzerdefinierte Apps und Admin-API-Zugriffstoken.

WooCommerce-Verbindung

Öffnen Sie in WordPress WooCommerce → Einstellungen → Erweitert → REST API, erstellen Sie einen Schlüssel mit Leseberechtigung für die nur spiegelnde Synchronisierung oder mit Lese-/Schreibberechtigung, wenn Änderungen des Bulk Editors in WooCommerce zurückgeschrieben werden sollen, und geben Sie die HTTPS-Shop-URL, den Verbraucherschlüssel und das Verbrauchergeheimnis ein. Um WordPress-Seiten und -Beiträge zu synchronisieren, geben Sie auch einen WordPress-Benutzernamen und ein Anwendungspasswort aus Benutzer → Profil ein.

Offizielle Anleitung: WooCommerce REST API.

Einige Hosts lehnen die HTTP-Basisauthentifizierung ab. Der Connector kann WooCommerce-Anfragen mit Authentifizierung über die Abfragezeichenfolge erneut versuchen; Anmeldeinformationen werden aus Protokollen entfernt.

Synchronisierungsverhalten

1. Speichern und testen Sie die Verbindung.
2. Webhooks registrieren — erstellt Abonnements im externen Shop, sodass Produkt-, Bestell- und Kundenänderungen OrderInChat nahezu in Echtzeit benachrichtigen. OrderInChat prüft außerdem regelmäßig auf Änderungen, falls ein Webhook verpasst wird.
3. Wählen Sie die Ressourcen aus, die gespiegelt werden sollen.
4. Führen Sie die erste Synchronisierung durch.

Aus Sicherheitsgründen überprüft OrderInChat jeden Webhook und prüft die Daten bei Shopify oder WooCommerce erneut, bevor sie gespeichert werden. Die regelmäßigen Prüfungen erfassen verpasste Webhooks nur solange, wie die Verwendung als Commerce-Quelle aktiviert ist. Wenn der Webhook-Status einen Fehler anzeigt und die Verbindung inaktiv ist, verwenden Sie Webhooks registrieren und Jetzt synchronisieren nach Änderungen im Quellshop; Nur die Verbindung testen aktualisiert keine Produkte. Wiederholte Aktualisierungen erzeugen keine doppelten Datensätze.

Das Versandgewicht von Shopify-Varianten wird aus dem Gewicht der Variante in Shopify importiert; der Produkteditor zeigt es in der konfigurierten Gewichtseinheit des Shops an. Dimensionen-Metafelder mit den Namen length, width oder height werden in Zentimeter umgerechnet. Produktbeschreibungen von Shopify stammen aus der eigenen Beschreibung des Produkts, nicht aus gemeinsamen Theme-Abschnitten oder Bannern; der Text des Themes wird nicht zu einer produktspezifischen Beschreibung. Entwurf und archivierte Produkte werden den Kunden nicht angezeigt.

Wenn Ihr Shop externen Commerce nutzt, kaufen Kunden über die Quellprodukt-URL. Der OrderInChat-Warenkorb-Checkout und die WhatsApp-Checkout-Abläufe sind für diesen Shop deaktiviert.

Lagerorte

Shopify-Standorte und Bestandswerte pro Variante werden in OrderInChat-Lager-/Standortdatensätze gespiegelt. Produkt- und Variantenbestände zeigen für Chat und Checkout die Summe über alle Standorte. WooCommerce-Kern gibt einen Gesamtbestandswert an, sodass dieser in einen standardmäßigen virtuellen Standort gespiegelt wird; Bestände an mehreren Standorten aus WooCommerce-Plugins erfordern ein unterstütztes Plugin.

Sie können eigene OrderInChat-Standorte unter Katalog → Inventar hinzufügen. Die Bestandszellen des Bulk Editors erweitern sich pro Standort. Das Übertragen von Beständen zu Shopify aktualisiert nur den ausgewählten Standort und erfordert den Scope write_inventory. Gesperrte Bestandsfelder werden durch eine spätere Bestandsynchronisierung nicht überschrieben.

Versandetiketten

OrderInChat-Versandetiketten sind standardmäßig deaktiviert. Aktivieren Sie sie nur, wenn OrderInChat der einzige Ort sein soll, an dem Etiketten erstellt werden. Selbst wenn sie aktiviert sind, kauft OrderInChat kein Etikett, wenn die externe Bestellung bereits Erfüllungs- oder Trackinginformationen hat.

Widget-Snippet

Shopify: Webhooks registrieren versucht auch, das Chat-Widget automatisch in Ihrem Shopify-Shop zu installieren. Sie können das Snippet bei Bedarf weiterhin in Custom Liquid einfügen. Gewähren Sie write_script_tags auf der benutzerdefinierten App, wenn die automatische Installation fehlschlägt.

WooCommerce: Die REST-API kann keine Theme-Skripte injizieren. Kopieren Sie das JavaScript- oder PHP-Snippet von der Integrationsseite in den Footer des Themes oder in functions.php.

Seiten → Wissensdatenbank

Wenn Seiten und Beiträge aktiviert ist, werden Shopify-Seiten/-Artikel/-Richtlinien und WooCommerce-Seiten/-Beiträge zur OrderInChat-Wissensdatenbank für KI-Antworten hinzugefügt (oder dort aktualisiert). Übereinstimmende Shopify-Richtlinientitel füllen auch die Felder für Rückgabe-/Bedingungen im Shop aus. Dies ist kein vollständiger Theme/CMS-Klon.

API-Beschränkungen

Die Integration meldet nicht unterstützte oder nicht verfügbare Daten, anstatt Werte zu erfinden. Häufige Einschränkungen sind:

• Shopify gibt nicht alle Zahlungseinstellungen über die Admin-API preis.
• Von der Versanddienstleister berechnete Versandpreise bleiben beim externen Checkout berechnet.
• WooCommerce REST umfasst keine WordPress-Seiten ohne ein WordPress-Anwendungspasswort.
• Bewertungen und Buchungen erfordern eine Plattform- oder App-API, die diese Ressourcen bereitstellt.
• Produktzusätze werden nur gespiegelt, wenn die Quell-API ein echtes Äquivalent hat.