Was ein Webhook macht
Ein Webhook sendet die Details eines Ereignisses in deinem Shop in dem Moment, in dem es passiert, an einen anderen Ort. Du wählst das Ereignis und das Ziel:
- API: Storeep sendet die Ereignisdaten an eine Webadresse (URL) deines Servers, deines CRM, eines Zapier- oder Make-Szenarios oder eines Ad-Tracking-Tools.
- E-Mail: Storeep sendet die Ereignisdaten an eine E-Mail-Adresse, zum Beispiel um für jede neue Bestellung eine E-Mail zu bekommen.
Öffne Einstellungen > Webhooks. Du brauchst die Berechtigung Einstellungen.
Für viele Tools gibt es schon eine fertige App, was einfacher ist: Google Sheets, Kuriernetzwerke und Werbe-Pixel. Schau zuerst in den App-Marktplatz.
Einen Webhook erstellen
Klicke auf Neuen Webhook hinzufügen, fülle das Formular aus und klicke auf Hinzufügen.
- Aktivieren: standardmäßig angehakt. Wenn angehakt, werden Ereignisse sofort gesendet. Entferne den Haken, um den Webhook zu behalten, aber zu pausieren.
- Vorname: eine Bezeichnung für deine Liste, zum Beispiel "CRM neue Bestellungen".
- Typ: API oder E-Mail.
- Ereignis:
- Bestellung erstellt: Ein Kunde gibt eine neue Bestellung auf.
- Bestellung aktualisiert: Status oder Details einer Bestellung ändern sich.
- Sitzung erstellt: Ein neuer Besucher kommt in deinen Shop. Nur beim Typ API.
- Format: Json.
- URL (Typ API): die Adresse, an die gesendet wird. Der Teil
https://wird für dich ergänzt, tippe also den Rest ein, zum Beispielapi.example.com/orders. - E-Mail-Adresse (Typ E-Mail): wohin die E-Mail geht.
Ein E-Mail-Webhook sendet nur Bestellereignisse. Wählst du E-Mail mit Sitzung erstellt, wird nichts gesendet.
Bestelldaten in die URL einfügen
Du kannst jedes Feld der Ereignisdaten mit doppelten geschweiften Klammern in die URL einfügen, {{field_name}}. Zum Beispiel:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Das sendet die Facebook-Klick-ID und die Bestellsumme an eine Ad-Tracking- oder Affiliate-Plattform, ganz ohne zusätzlichen Server. Ein Feld, das nicht existiert, bleibt leer. Um die Feldnamen zu sehen, erstelle einen E-Mail-Webhook für dasselbe Ereignis und sieh dir die empfangenen Daten an.
Die Webhook-Liste
Jede Zeile zeigt Vorname, URL/E-Mail, Typ, Ereignis, Format und Status (Aktiviert oder Deaktiviert). Klicke auf eine Zeile, um sie zu bearbeiten. Markiere Zeilen und wähle Webhooks löschen, um sie endgültig zu entfernen. Es gibt eine Höchstzahl an Webhooks pro Shop, und du siehst eine Meldung, wenn du sie erreichst.
Du kannst mehrere Webhooks für dasselbe Ereignis erstellen, zum Beispiel einen an dein CRM und einen an deinen Ad-Tracker.
Wenn eine Zustellung fehlschlägt
- Dein Server sollte schnell mit einem Erfolgscode (2xx) antworten. Eine langsame Antwort zählt als Fehler.
- Ist dein Server nicht erreichbar oder ausgelastet (eine Antwort 5xx oder 429 oder gar keine Antwort), versucht Storeep es in den nächsten Minuten mehrmals erneut. Nur die fehlgeschlagenen Webhooks werden wiederholt, die anderen bekommen also keine Duplikate.
- Lehnt dein Server die Anfrage ab (eine Antwort 4xx wie 404 oder 403), wiederholt Storeep nicht, weil die Adresse oder ihre Sicherheit falsch ist.
- Schlägt ein Webhook mehrmals hintereinander fehl, bekommt der Shop-Inhaber eine E-Mail: "Aktion erforderlich: Ihr Storeep-Webhook schlägt fehl", mit Name, Adresse, Ereignis und letztem Fehlercode des Webhooks. Sobald der Webhook wieder funktioniert, kann ein späteres Problem eine neue Warnung auslösen. Du kannst diese E-Mail unter Benachrichtigungen ausschalten.
- E-Mail-Webhooks werden einmal gesendet, ohne Wiederholung.
Webhooks pausiert wegen eines offenen Betrags
Hat dein Shop einen unbezahlten fälligen Betrag und dein Wallet kann ihn nicht decken, warten die Webhooks. Sie werden gesendet, nachdem du Guthaben aufgeladen hast und der Betrag beglichen ist. Siehe Wallet und Abrechnung.
Tipps
- Braucht dein Server ein Passwort oder einen Schlüssel, füge ihn in die URL-Abfrage ein, zum Beispiel
?key=yoursecret. - Sitzung erstellt wird bei jedem Besucher ausgelöst, was in einem gut besuchten Shop sehr viel sein kann. Nutze es nur, wenn dein Server das verkraftet.
- Damit ein Tool deine Bestellungen und Produkte lesen kann, wann immer es will, nutze stattdessen ein Zugriffstoken.