Setup

E-Commerce (Shopify)

Synchronisieren Sie Kunden und Bestellungen aus Ihrem Shopify-Shop mit dem CRM über Ihren eigenen Shop (BYO-Modell).

Die E-Commerce-Integration nutzt IHREN Shopify-Shop (BYO-Modell: Sie bringen Ihren eigenen Shop mit). Sie hört auf die Webhooks Ihres Shops und synchronisiert mit dem CRM: Jeder Kunde wird zu einem Kontakt und jede Bestellung zu einem Verkaufsauftrag. Es entstehen keine Kosten, keine Marge und keine Vermittlung auf unserer Seite: Die Daten kommen direkt aus Ihrem Shop.

Die Integration startet inaktiv: Es passiert nichts, bis Sie die Felder ausfüllen und aktivieren. Das Webhook-Secret und das Admin-Token werden verschlüsselt im CRM gespeichert und nie wieder angezeigt.

Voraussetzungen

Ein Shopify-Shop mit Administratorzugriff (Shopify Admin), um Webhooks zu erstellen und das Signing Secret einzusehen.
Die .myshopify.com-Domain des Shops.
In Sellio: Administratorzugriff, um die Zugangsdaten zu speichern und die Integration unter Einstellungen → Integrationen zu aktivieren.

Was Sie ausfüllen müssen

Shop-Domain: die .myshopify.com-Adresse Ihres Shops (z. B. mystore.myshopify.com).
Webhook-Secret (API-Secret): das Geheimnis, mit dem Shopify die Webhooks signiert. In Shopify Admin → Settings → Notifications finden Sie das "signing secret" der Webhooks (oder, falls Sie eine eigene App verwenden, deren API-Secret). Dieser Wert wird vom CRM verwendet, um die Signatur (HMAC) jedes Aufrufs zu prüfen.
Admin-API-Zugriffstoken (optional): nur erforderlich, wenn das CRM künftig Shop-Daten über die API lesen soll. Um nur die Webhooks zu empfangen, lassen Sie es leer.

So konfigurieren Sie es

Öffnen Sie Einstellungen → Integrationen und suchen Sie die Karte "E-Commerce (Shopify)".
Füllen Sie die Shop-Domain und das Webhook-Secret aus und klicken Sie auf "Zugangsdaten speichern".
Kopieren Sie die angezeigte "Webhook-URL (Shopify)".
Erstellen Sie in Shopify Admin → Settings → Notifications → Webhooks einen Webhook (JSON-Format), der auf diese URL zeigt, für JEDES dieser Themen: customers/create, customers/update, orders/create, orders/paid.
Kehren Sie zum CRM zurück und klicken Sie auf "Aktivieren".

Was bei jedem Ereignis passiert

customers/create und customers/update: Der Kunde wird als Kontakt erstellt oder aktualisiert, abgeglichen per E-Mail. Das CRM speichert die Shopify-Kunden-ID, um Duplikate bei erneuter Zustellung zu vermeiden.
orders/create und orders/paid: Die Bestellung wird als Verkaufsauftrag erstellt oder aktualisiert (Nummer, Betrag, Währung und Status), verknüpft mit dem entsprechenden Kontakt, sofern dieser existiert. Der Status wird zu "fakturiert", wenn die Bestellung bezahlt ist, "storniert", wenn sie storniert wurde, andernfalls "bestätigt".

💡 Die Synchronisierung ist idempotent: Sendet Shopify denselben Webhook erneut, aktualisiert das CRM den vorhandenen Datensatz, statt einen neuen zu erstellen (es identifiziert den Datensatz anhand der Shopify-ID). Es werden nur die Felder aktualisiert, die aus dem Shop kommen; was Sie manuell im CRM bearbeitet haben, bleibt erhalten.

Behandeln Sie die Webhook-URL und das Webhook-Secret als geheim. Das CRM prüft die Signatur X-Shopify-Hmac-Sha256 jedes Aufrufs mit Ihrem Webhook-Secret; ungültige Signaturen werden abgelehnt. Wenn Sie versuchen zu aktivieren, ohne das Secret auszufüllen, bleibt die Integration inaktiv, und es wird nichts synchronisiert, bis alles vorhanden ist.

So testen Sie

Verwenden Sie bei aktivierter Integration und erstellten Webhooks in Shopify Admin → Settings → Notifications → Webhooks die Funktion "Send test notification" bei einem der Webhooks (oder erstellen Sie einen Testkunden/eine Testbestellung im Shop).
Prüfen Sie im CRM das Objekt Kontakte (für Kunden) und Verkaufsaufträge (für Bestellungen): Der entsprechende Datensatz sollte erscheinen.
Senden Sie denselben Test erneut und bestätigen Sie, dass KEINE Duplizierung erfolgt. Das CRM identifiziert den Datensatz anhand der Shopify-ID.

Fehlerbehebung

Ungültige Signatur (Aufruf abgelehnt): Das im CRM gespeicherte Webhook-Secret weicht vom Signing Secret von Shopify ab. Kopieren Sie das Secret erneut (Settings → Notifications, oder das API-Secret Ihrer App) und fügen Sie es ins CRM ein.
Es wird nichts synchronisiert: Prüfen Sie, ob Sie einen Webhook (JSON-Format) für JEDES Thema erstellt haben: customers/create, customers/update, orders/create, orders/paid, alle mit Verweis auf die "Webhook-URL (Shopify)".
404 bei der URL: Die Integration ist deaktiviert oder das URL-Token hat sich geändert. Reaktivieren Sie sie und kopieren Sie die URL erneut nach Shopify.
Bestellung ohne verknüpften Kontakt: Die Verknüpfung erfolgt anhand der E-Mail-Adresse des Kunden; existiert der Kunde noch nicht als Kontakt, wird die Bestellung ohne Verknüpfung erstellt und Sie können sie später zuordnen.
Von mir bearbeitete Felder wurden überschrieben: Es werden nur die Felder aktualisiert, die aus dem Shop kommen; der Rest bleibt erhalten. Wenn sich ein Shop-Feld geändert hat, spiegelt es den Shop wie vorgesehen wider.

Open this article inside the system →