Wissensdatenbank

Webhooks (Shop)

Webhooks benachrichtigen ein anderes System automatisch, sobald in Ihrem Shop ein bestimmtes Ereignis eintritt — zum Beispiel eine neue Bestellung. Statt dass ein externes Programm ständig nachfragen muss, sendet SELLERLOGIC Commerce Services selbstständig eine Nachricht an eine von Ihnen hinterlegte Internetadresse. Dies richtet sich an technische Anbindungen, z. B. an eine externe Warenwirtschaft.

Was kann ich hier tun?

  • Webhooks anlegen, bearbeiten und löschen
  • Festlegen, bei welchen Ereignissen eine Benachrichtigung gesendet wird
  • Einen Webhook aktivieren oder deaktivieren
  • Sehen, wann ein Webhook zuletzt ausgelöst wurde und ob es fehlgeschlagene Zustellungen gab
  • Nach Webhooks suchen

Schritt für Schritt

  1. Neuen Webhook anlegen: Klicken Sie auf „Webhook erstellen" und tragen Sie die Ziel-URL ein, an die SCS die Benachrichtigungen senden soll.
  2. Ereignisse auswählen: Setzen Sie Häkchen bei allen Ereignissen, über die Sie benachrichtigt werden möchten (z. B. „order.created" für neue Bestellungen). Über „Alle auswählen" können Sie alle Ereignisse auf einmal aktivieren.
  3. Geheimschlüssel sichern: Nach dem Anlegen wird Ihnen einmalig ein geheimer Schlüssel angezeigt, mit dem das empfangende System die Echtheit der Nachrichten prüfen kann. Kopieren Sie ihn sofort und bewahren Sie ihn sicher auf — er wird später nicht erneut angezeigt.
  4. Webhook bearbeiten: Öffnen Sie über das Drei-Punkte-Menü „Bearbeiten", um URL, Ereignisse oder den Aktiv-Status zu ändern.
  5. Fehlschläge prüfen: Ein roter Hinweis mit Fehleranzahl zeigt an, dass Zustellungen an die Ziel-URL fehlgeschlagen sind — prüfen Sie in diesem Fall die Erreichbarkeit der Ziel-URL.
Bildschirmfoto der Seite Webhooks (Shop)Bildschirmfoto der Seite Webhooks (Shop)
Ansicht: /shop/webhooks
Nachgebauter Ausschnitt der Ansicht: /shop/webhooks

Felder erklärt

Feld Bedeutung Hinweise/Auswirkung
Ziel-URL Internetadresse, an die Benachrichtigungen gesendet werden Pflichtfeld, muss vom Empfangssystem erreichbar sein
Ereignisse Ausgewählte Ereignisse, bei denen benachrichtigt wird Mindestens eines erforderlich
Geheimschlüssel Einmalig angezeigter Schlüssel zur Signaturprüfung Nur bei der Erstellung sichtbar
Status Aktiv oder Inaktiv Inaktive Webhooks senden keine Benachrichtigungen
Letzte Auslösung Zeitpunkt der letzten gesendeten Benachrichtigung Nur zur Information
Fehleranzahl Anzahl fehlgeschlagener Zustellversuche Hoher Wert deutet auf ein Problem beim Empfangssystem hin

Werte & Status

Verfügbare Ereignisse (webhook_event)

Bestellung

Wert Bedeutung
order.created Eine neue Bestellung wurde aufgegeben
order.updated Eine Bestellung wurde geändert
order.completed Eine Bestellung wurde vollständig abgeschlossen
order.cancelled Eine Bestellung wurde storniert
order.payment_received Der Zahlungseingang zu einer Bestellung wurde verbucht
order.shipped Eine Bestellung wurde als versendet markiert
order.delivered Eine Bestellung wurde als geliefert markiert

Kunde

Wert Bedeutung
customer.registered Eine neue Kundin/ein neuer Kunde hat sich registriert
customer.updated Kundendaten wurden geändert
customer.deleted Ein Kundenkonto wurde gelöscht

Produkt

Wert Bedeutung
product.created Ein neues Produkt wurde angelegt
product.updated Ein Produkt wurde geändert
product.deleted Ein Produkt wurde gelöscht
product.stock_changed Der Lagerbestand eines Produkts hat sich geändert
product.price_changed Der Preis eines Produkts hat sich geändert

Warenkorb

Wert Bedeutung
cart.created Ein neuer Warenkorb wurde angelegt
cart.updated Der Inhalt eines Warenkorbs hat sich geändert
cart.abandoned Ein Warenkorb wurde als abgebrochen markiert (Kundschaft hat den Checkout nicht abgeschlossen)

Retoure

Wert Bedeutung
return.requested Eine Rücksendung wurde angefragt
return.approved Eine Rücksendung wurde genehmigt
return.refunded Eine Rücksendung wurde erstattet

Fulfillment

Wert Bedeutung
fulfillment.shipped Eine Sendung wurde versendet
fulfillment.delivered Eine Sendung wurde zugestellt

Checkout

Wert Bedeutung
checkout.completed Ein Checkout wurde abgeschlossen
checkout.failed Ein Checkout ist fehlgeschlagen

Postfach (Inbox)

Wert Bedeutung
inbox.thread_created Ein neuer Nachrichten-Thread wurde angelegt
inbox.message_received Eine eingehende Nachricht wurde empfangen
inbox.message_sent Eine Nachricht wurde versendet
inbox.thread_assigned Ein Thread wurde einer Person zugewiesen
inbox.thread_archived Ein Thread wurde archiviert

Häufige Fragen

Was mache ich, wenn ich den Geheimschlüssel verloren habe?
Der Schlüssel wird nur einmalig bei der Erstellung angezeigt und kann danach nicht erneut abgerufen werden. Löschen Sie in diesem Fall den Webhook und legen Sie ihn neu an.

Wofür wird der Geheimschlüssel verwendet?
Mit ihm kann das empfangende System prüfen, dass eine Nachricht tatsächlich von SCS stammt und nicht gefälscht wurde.

Was tue ich bei vielen fehlgeschlagenen Zustellungen?
Prüfen Sie, ob die hinterlegte Ziel-URL noch erreichbar ist und korrekt auf eingehende Anfragen antwortet.

Verwandte Themen