Was sind Webhooks?

Webhooks sind automatische HTTP-Aufrufe, die Daten aus Ihrem Shoporama-Webshop an eine von Ihnen selbst gewählte URL senden. Wenn ein bestimmtes Ereignis eintritt – zum Beispiel eine neue Bestellung oder eine Änderung des Lagerbestands – sendet Shoporama sofort eine Nachricht mit allen relevanten Daten an Ihren Server.

Anstatt ständig die API abzufragen: „Gibt es etwas Neues?“, informieren dich Webhooks proaktiv, sobald es etwas gibt, auf das du reagieren musst. Das sorgt für geringere Verzögerungen, weniger Serverlast und eine elegantere Integration.

Unterstützte Ereignisse

Shoporama unterstützt Webhooks für eine Vielzahl von Ereignissen, die in vier Kategorien unterteilt sind:

Bestellungen

• Bestellung erstellt – Wenn eine neue Bestellung eingeht
• Neuer Status – Wenn sich der Status einer Bestellung ändert (z. B. von „Neu“ zu „Versandt“)
• Bezahlt – Wenn die Zahlung für eine Bestellung verbucht wird

Produkte

• Produkt geändert — Wenn ein Produkt angelegt oder aktualisiert wird
• Lagerbestand geändert — Wenn sich der Lagerbestand ändert
• Kategorie geändert — Wenn Kategorien angelegt, geändert oder gelöscht werden

Kassenablauf

• In den Warenkorb gelegt — Wenn ein Kunde ein Produkt in den Warenkorb legt
• Warenkorb aktualisiert – Wenn sich der Warenkorb ändert
• Checkout-Schritte — Aufruf der Warenkorb-, Adress-, Versand-, Bestätigungs- und Dankesseite
• Bestellung bestätigt — Wenn die Bestellung endgültig bestätigt wird

Kunden und Sonstiges

• Kunde angelegt — Wenn ein neuer Kunde registriert wird
• Newsletter-Anmeldung — Wenn sich ein Besucher für den Newsletter anmeldet
• Neue Rücksendung — Wenn ein Kunde eine Rücksendung beantragt

Sicherheit und Zuverlässigkeit

Jeder Webhook wird mit einem eindeutigen geheimen Schlüssel (Secret) signiert, der bei der Erstellung automatisch generiert wird. Dadurch kann Ihr Server überprüfen, ob der Aufruf tatsächlich von Shoporama stammt und nicht gefälscht ist.

Shoporama liefert Webhooks asynchron über eine interne Warteschlange, sodass Ereignisse nicht verloren gehen, selbst wenn Ihr Server vorübergehend nicht erreichbar ist. Sie können jederzeit das Protokoll der gelieferten Webhooks einsehen, einschließlich Status, Antwortzeit und eventueller Fehler.

Protokollierung und Fehlerbehebung

Alle Webhook-Übermittlungen werden mit folgenden Details protokolliert:

• Zeitpunkt der Übermittlung
• Ereignistyp
• HTTP-Statuscode von Ihrem Server
• Antwortzeit
• Möglichkeit, einzelne Webhooks erneut zu senden

Sie können das Protokoll nach Ereignistyp, Status und Datum filtern – und Sie können Test-Webhooks senden, um zu überprüfen, ob Ihre Integration ordnungsgemäß funktioniert, bevor Sie live gehen.

Statistik

Für jeden Webhook kannst du Statistiken der letzten 30 Tage einsehen, darunter die Anzahl der Zustellungen, die Erfolgsquote und die Fehlerverteilung. So erhältst du einen schnellen Überblick darüber, ob deine Integrationen stabil laufen.

Erstellung über die API

Neben dem Admin-Panel können Webhooks auch programmgesteuert über die REST-API erstellt und verwaltet werden. Dies ermöglicht es Apps und Integrationen, ihre eigenen Webhooks automatisch einzurichten.

Typische Anwendungsszenarien

• ERP-Integration: Leite neue Bestellungen direkt an dein ERP-System weiter, sobald sie erstellt werden
• Lagerbestandswarnungen: Lassen Sie sich benachrichtigen, wenn ein Produkt im Lager zur Neige geht
• Marketing-Automatisierung: Lösen Sie E-Mail-Abläufe basierend auf dem Kundenverhalten an der Kasse aus
• Slack-Benachrichtigungen: Senden Sie bei jeder neuen Bestellung eine Nachricht an Ihren Slack-Kanal
• Benutzerdefinierte Dashboards: Erstellen Sie Ihr eigenes Echtzeit-Dashboard mit Live-Auftragsdaten