Zum Inhalt springen
memberarea memberarea.io

Das Shopify-Webhook-Protokoll lesen

Lesen Sie jede Zustellung, die Ihr Shop geschickt hat, verstehen Sie, was Ihr memberarea damit gemacht hat, und verarbeiten Sie eine fehlgeschlagene erneut.

In diesem Artikel

Passiert etwas in Ihrem Shop, schickt Shopify eine Nachricht darüber an Ihr memberarea. Jede dieser Nachrichten ist eine Zustellung, und jede Zustellung wird mit ihrem Ergebnis erfasst, ob sie geklappt hat oder nicht. Im Webhook-Protokoll sehen Sie nach, wenn ein Käufer sagt, dass sein Kurs fehlt, oder wenn Sie wissen wollen, was eine Erstattung oder eine Produktänderung tatsächlich bewirkt hat.

Das Protokoll öffnen

Öffnen Sie Ihre Shopify-Seite unter /admin/settings/integrations/shopify, oder öffnen Sie Einstellungen, dann Integrationen, dann Integration hinzufügen und Shopify. Wählen Sie dann den Tab Webhook-Protokoll. Das Protokoll bleibt lesbar, während der Shop getrennt ist, Sie können also weiterhin nachsehen, was vorher angekommen ist.

Bis die erste Zustellung eintrifft, zeigt der Tab „Noch keine Webhooks empfangen. Lösen Sie eine Testbestellung in Ihrem Shop aus, um die Verbindung zu prüfen.“ Eine Testbestellung ist der schnellste Weg zur ersten Zeile.

Was eine Zeile zeigt

Die Liste hat keine Spaltenüberschriften. Jede Zustellung ist eine Zeile:

Wo Was es zeigt
Oberste Zeile Das Thema, das nennt, was im Shop passiert ist.
Zeile darunter Eine kurze Notiz, was Ihr memberarea mit der Zustellung gemacht hat. Ist sie fehlgeschlagen, steht dort stattdessen der Fehler.
Unter der Notiz Datum und Uhrzeit, zu der die Zustellung empfangen wurde.
Badge rechts Das Ergebnis: Verarbeitet, Ignoriert, Noch nicht verarbeitet, Wird wiederholt oder Fehlgeschlagen.
Schaltfläche daneben Erneut verarbeiten, nur bei Zeilen, die sich erneut ausführen lassen.
Das Webhook-Protokoll listet Zustellungen mit den Ergebnissen Verarbeitet, Ignoriert, Wird wiederholt und Fehlgeschlagen, jeweils mit Hinweis und Uhrzeit.
Das Webhook-Protokoll listet Zustellungen mit den Ergebnissen Verarbeitet, Ignoriert, Wird wiederholt und Fehlgeschlagen, jeweils mit Hinweis und Uhrzeit.

Klicken Sie auf eine Zeile, um ihre Details zu öffnen. Sie listen auf, was die Zustellung von Bestellnummer, E-Mail-Adresse, Gesamt, Währung und Shopify-ID mitbrachte, immer die Anzahl der Versuche und den vollständigen Fehler, falls es einen gab. Klicken Sie erneut auf die Zeile, um sie zu schließen.

Die Themen, die Sie sehen werden, sind orders/paid, orders/cancelled, refunds/create, customers/create, customers/update, customers/delete, products/update, products/delete und app/uninstalled. Auch Shopifys drei Datenschutzthemen customers/data_request, customers/redact und shop/redact landen hier.

Die fünf Ergebnisse

Verarbeitet heißt, Ihr memberarea hat die Arbeit erledigt. Bei einer bezahlten Bestellung lautet die Notiz etwa „Order SHP-1042 imported, 1 mapped item(s).“, und der Käufer hat den zugeordneten Zugang. Eine bezahlte Bestellung für ein Produkt, das niemand zugeordnet hat, wird ebenfalls verarbeitet: Die Notiz lautet „Order SHP-1042 imported, no mapped item.“ Die Bestellung existiert, zählt in Ihren Umsatz, und der Käufer wird Mitglied ohne jeden Zugang. Das gilt auch für physische Waren, die Sie neben Ihren Kursen verkaufen.

Ignoriert heißt, die Zustellung wurde verstanden, und es gab nichts zu tun. Die Notiz sagt, warum, zum Beispiel „This product is not mapped.“ bei einer Produktänderung, auf die keine Zuordnung zeigt, oder „This update is the echo of our own push.“, nachdem Sie selbst ein Produkt nach Shopify übertragen haben.

Noch nicht verarbeitet heißt, die Zustellung ist angekommen und wartet, bis sie dran ist. Eine Zeile sollte nicht länger als ein paar Sekunden so bleiben. Stehen viele Zeilen auf Noch nicht verarbeitet, hängt bei uns etwas. Schreiben Sie an support@memberarea.io.

Wird wiederholt heißt, bei der Zustellung ist etwas schiefgegangen, und sie wird gleich von selbst erneut versucht. Die Notizzeile nennt den Fehler des letzten Versuchs.

Fehlgeschlagen heißt, etwas ist schiefgegangen, und die automatischen Versuche sind aufgebraucht. Die Notizzeile nennt den Fehler, und die Zeile bietet Erneut verarbeiten an.

Fehlgeschlagene Zustellungen werden von selbst wiederholt

Eine Zustellung, die fehlschlägt, wird automatisch ein paar Mal erneut versucht, mit einer Pause zwischen den Versuchen. Solange diese Versuche noch laufen, zeigt die Zeile Wird wiederholt, und Versuche in den Details steigt mit jedem Versuch. Erst wenn der letzte Versuch fehlschlägt, wechselt die Zeile zu Fehlgeschlagen. Eine Zeile auf Fehlgeschlagen braucht Sie: Beheben Sie die Ursache und führen Sie sie dann erneut aus. Das Webhook-Protokoll in der App in Ihrem Shopify-Admin zeigt dieselben Zustände, „Retrying“, bis die Versuche aufgebraucht sind, und danach „Failed“.

Eine Zustellung erneut ausführen

Drücken Sie in der Zeile Erneut verarbeiten. Die Schaltfläche gibt es nur bei einer Zustellung, die fehlgeschlagen ist, wiederholt wird oder noch nicht verarbeitet wurde. Eine Zeile, die als verarbeitet oder ignoriert gilt, hat keine. Die Zeile geht zurück auf Noch nicht verarbeitet und wird dann mit den Daten abgearbeitet, die Shopify ursprünglich geschickt hat. Führen Sie sie nach dem Beheben der Ursache erneut aus, erledigt sie also die volle Arbeit, keine abgespeckte Fassung davon.

Eine aufgeklappte fehlgeschlagene Zustellung einer Rückerstattung zeigt ihren Fehler, die Zahl der Versuche und die Schaltfläche Erneut verarbeiten.
Eine aufgeklappte fehlgeschlagene Zustellung einer Rückerstattung zeigt ihren Fehler, die Zahl der Versuche und die Schaltfläche Erneut verarbeiten.
Hinweis

Nichts wird zweimal ausgeführt. Schickt Shopify dieselbe Zustellung erneut, bekommt sie keine zweite Zeile. Eine bezahlte Bestellung, die zweimal ankommt, wird trotzdem eine Bestellung und schaltet den Zugang einmal frei, und eine Erstattung, die zweimal ankommt, wird einmal gebucht. Erneut verarbeiten verdoppelt nie eine Bestellung, einen Zugang oder eine Erstattung.

Das Protokoll filtern und durchblättern

Die Schaltflächen über der Liste grenzen sie auf Verarbeitet, Ignoriert oder Fehlgeschlagen ein, und Alle holt alles zurück. Fehlgeschlagen listet nur die Zustellungen, deren automatische Versuche aufgebraucht sind. Zeilen auf Noch nicht verarbeitet und Wird wiederholt erscheinen nur unter Alle. Aktualisieren lädt die Seite neu, auf der Sie sind, so können Sie eine neue Zustellung eintreffen sehen.

Fünfundzwanzig Zustellungen passen auf eine Seite, die neuesten zuerst. Ältere Zustellungen liegen auf den nächsten Seiten, die Sie unter der Liste erreichen.

Meldet ein Kunde einen fehlenden Kurs, filtern Sie zuerst auf Fehlgeschlagen, dann auf Ignoriert, und sehen Sie sich dann seine Zeile orders/paid unter Verarbeitet an. Zwischen diesen dreien finden Sie fast immer die Antwort.

Notizen, die Sie tatsächlich sehen

Notiz Was sie bedeutet und was zu tun ist
„Order SHP-1042 imported, no mapped item.“ Die Bestellung ist da, aber ihr Produkt schaltet nichts frei. Ordnen Sie das Produkt zu, damit die nächsten Käufer Zugang bekommen, siehe Shopify-Produkt mit einem Kurs verknüpfen.
„This product is not mapped.“ Im Shop hat sich ein Produkt geändert, auf das keine Zuordnung zeigt. Nichts zu tun, außer Sie wollten es zuordnen.
„This update is the echo of our own push.“ Shopify hat eine Änderung zurückgemeldet, die Ihr memberarea gemacht hat. Nichts zu tun.
„This delivery carried no order id or the order was already imported.“ Entweder hatte die Zustellung keine Bestell-ID, oder die Bestellung ist schon da. Nichts zu tun.
„Refund recorded, the refunded items were not mapped.“ Die Erstattung ist gebucht, betraf aber Produkte, die nie zugeordnet waren, es gab also keinen Zugang zurückzunehmen.
„The order for this refund has not been imported yet, trying again shortly.“ Die Erstattung kam vor ihrer Bestellung an. Sie wird von selbst erneut versucht, und die Zeile zeigt währenddessen Wird wiederholt. Endet sie auf Fehlgeschlagen, drücken Sie Erneut verarbeiten, sobald die Zeile der Bestellung Verarbeitet zeigt.

Was Erstattungen und Stornierungen mit Zugang, Bestellung und Provisionen machen, steht in Erstattungen und Stornierungen in Shopify.

Nur echte Zustellungen von Shopify

Jede Zustellung muss eine gültige Shopify-Signatur tragen. Eine Nachricht ohne Signatur wird abgewiesen und erscheint nie im Protokoll. Eine Zustellung, die Shopify vor mehr als sieben Tagen ausgelöst hat, wird ebenfalls nicht angenommen. Fehlt eine Zeile, die Sie erwarten, ganz, prüfen Sie, ob der Shop verbunden ist, siehe Shopify-Shop verbinden.

Datenschutzanfragen von Shopify

Shopify reicht Datenschutzanfragen der Kunden Ihres Shops weiter, und jede erscheint als Zeile.

Verlangt ein Kunde bei Shopify die Löschung seiner Daten, kommt eine Zustellung customers/redact an. Ihr memberarea entfernt die Verknüpfung zu diesem Shopify-Kunden und die gespeicherten Zustellungen über ihn. Das Mitglied, der Kontakt und ihre Bestellungen bleiben: Sie gehören zu Ihrem Workspace, und der Kunde hat vielleicht auch woanders bei Ihnen gekauft. Die Notiz lautet etwa „Removed 1 link and 4 stored deliveries for Shopify customer 7012345678. The member itself belongs to the workspace and stays.“ Soll die Person auch aus Ihrem memberarea verschwinden, löschen Sie das Mitglied oder den Kontakt selbst.

Fordert ein Kunde seine Daten an, kommt eine Zustellung customers/data_request an, und die Inhaber Ihres Workspace bekommen eine E-Mail und eine Benachrichtigung mit dem Titel „Ein Shopify-Kunde hat seine Daten angefordert“. Shopify erwartet Ihre Antwort innerhalb von 30 Tagen, und Ihr memberarea sendet die Daten nicht für Sie. Was rund um Datenschutz und Deinstallation sonst passiert, steht in Shopify trennen und Shop-Daten löschen.

Was gespeichert bleibt

Jede Zustellung wird mit den Daten gespeichert, die Shopify geschickt hat, ein erneuter Lauf erledigt also die volle Arbeit. Diese Daten betreffen Ihre Kunden, deshalb werden sie verschlüsselt gespeichert. Zustellungen werden 90 Tage nach ihrem Eintreffen gelöscht.

Verwandte Artikel

Last updated on October 25, 2026

War dieser Artikel hilfreich?

Verwandte Artikel