Webhaken in Shoporama

Mit Webhooks kannst du Shoporama so einrichten, dass es automatisch eine Benachrichtigung an einen externen Dienst sendet, sobald in deinem Shop etwas passiert. Zum Beispiel, wenn eine neue Bestellung erstellt wird, ein Produkt aktualisiert wird oder sich ein Kunde zum ersten Mal anmeldet. Hier erklären wir dir, was Webhooks sind, auf welche Ereignisse du reagieren kannst und wie du sie einrichtest.

Was sind Webhooks?

Ein Webhook ist eine automatische Benachrichtigung, die Shoporama an eine von Ihnen angegebene URL sendet, wenn ein bestimmtes Ereignis eintritt. Stellen Sie sich das als eine „umgekehrte API“ vor. Anstatt dass Sie Shoporama fragen: „Gibt es neue Bestellungen?“, teilt Shoporama Ihnen dies automatisch mit.

Ohne Webhooks: Dein Dienst fragt Shoporama alle 5 Minuten: „Gibt es neue Bestellungen?“. Das ist ineffizient und verursacht unnötige Belastung.

Mit Webhooks: Shoporama benachrichtigt dich sofort, sobald eine neue Bestellung vorliegt. Das ist schnell und läuft in Echtzeit.

Verfügbare Webhook-Ereignisse

Du kannst Webhooks für die folgenden Ereignisse einrichten. Beachte, dass die Ereignisnamen einen Unterstrich (order_created) und keinen Punkt verwenden.

Bestell-Ereignisse

Produkt- und Kategorie-Ereignisse

Kunden- und Newsletter-Ereignisse

Checkout-Ereignisse (der Weg des Kunden durch den Checkout)

Erstelle einen Webhook

1. Gehe zu Einstellungen (Zahnrad)
2. Klicken Sie auf die drei Punkte und wählen Sie „Webhooks“
3. Klicken Sie auf „Neuen Webhook erstellen“
4. Geben Sie die URL an, die die Webhook-Daten empfangen soll
5. Wähle die Ereignisse aus, auf die du achten möchtest (du kannst mehrere auswählen)
6. Klicken Sie auf „Speichern“

Sie können auch direkt von der Log-Seite aus ein Test-Event mit dem Event „test.ping“ senden, um zu überprüfen, ob Ihr Empfänger funktioniert.

Format der Webhook-Nutzlast

Wenn ein Ereignis ausgelöst wird, sendet Shoporama eine HTTP-POST-Anfrage an Ihre URL mit Daten im JSON-Format. Alle Webhooks haben dieselbe Struktur:

{
  "event": "order_created",
  "action": "create",
  "timestamp": "2026-05-01T10:30:00+02:00",
  "webshop_id": 1234,
  "data": {
    "order_id": 56789,
    "order_no": 1042,
    "email": "kunde@eksempel.dk",
    "total": 549.50
  }
}

Der Inhalt des Datenfelds variiert je nach Ereignis. Bei Bestellereignissen erhältst du Informationen zur Bestellung, bei Produkt-Ereignissen Informationen zum Produkt und so weiter. Das Datenobjekt entspricht dem, was die REST-API für das jeweilige Objekt zurückgibt.

HTTP-Header

Jede Webhook-Anfrage enthält diese Header, die du zur Authentifizierung und Weiterleitung verwenden kannst:

• Content-Type: application/json
• X-Webhook-Event, der Name des Ereignisses, z. B. order_created
• X-Webhook-Signature, eine HMAC-SHA-256-Signatur im Format sha256=..., berechnet aus dem Request-Body und dem geheimen Schlüssel des Webhooks

Signatur verifizieren

Wenn Sie sichergehen möchten, dass die Anfrage tatsächlich von Shoporama stammt, verifizieren Sie den X-Webhook-Signature-Header mit dem geheimen Schlüssel, den Sie in Ihrem Webhook im Shoporama-Adminbereich einsehen können. Beispiel in PHP:

$payload = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $payload, $secret);
if (!hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

Antwort von Ihrem Empfänger

Dein Empfängerdienst muss mit einem HTTP-Status 2xx (typischerweise 200) antworten, um den Empfang zu bestätigen. Andere Statuscodes werden als Fehler protokolliert, und du kannst fehlgeschlagene Übermittlungen über die Protokollseite erneut senden.

Verwendung von Webhooks

Typische Anwendungsfälle für Webhooks:

• Lagerhotel-Integration: Senden Sie neue Bestellungen automatisch an das Lagerhotel, z. B. bei Bezahlung
• Slack/Teams-Benachrichtigung: Lass dich über neue Bestellungen in deinem Kanal benachrichtigen bei order_created
• Lagersynchronisierung: Aktualisieren Sie ein externes System, wenn der Lagerbestand sinkt
• CRM-Synchronisierung: Erstelle den Kunden in Klaviyo, ActiveCampaign oder deinem eigenen CRM bei „customer_created“
• Automatisierung: Lösen Sie Workflows in Zapier, Make oder ähnlichen Diensten aus

Protokolle und erneute Übermittlung

Für jeden Webhook kannst du ein Protokoll aller Zustellungen einsehen (Statuscodes, Dauer, Payload und Fehler). Du kannst nach Ereignistyp, Status und Datum filtern. Fehlgeschlagene Zustellungen können mit einem Klick manuell erneut gesendet werden. Protokolle werden regelmäßig automatisch gelöscht.

Häufig gestellte Fragen

Wo finde ich die Webhook-Liste?

Klicke auf das Zahnrad in deinem Shoporama-Adminbereich und gehe über die drei Punkte zu „Webhooks “. Du kannst auch unseren Leitfaden lesen, um erstellte Webhooks in deinem Shop anzuzeigen.

Wie schnell kommt der Webhook an?

Webhooks werden in eine Warteschlange gestellt und in der Regel innerhalb weniger Sekunden versendet. Bei Spitzenauslastung kann es zu einer leichten Verzögerung kommen, jedoch nie länger als ein oder zwei Minuten.

Gibt es ein „order_sent“-Ereignis?

Nein. Es gibt kein eigenständiges Ereignis für „versendet“. Wenn du eine Bestellung als versendet markierst, wird „new_status“ mit dem neuen Status im Payload ausgelöst. Achte auf dieses Ereignis und überprüfe „data.status“, wenn du auf Statusänderungen reagieren möchtest.

Müssen Ereignisse mit Punkt oder Unterstrich geschrieben werden?

Unterstrich. Richtig: order_created. Falsch: order.created. Das einzige Ereignis mit Punkt ist test.ping, das für Testlieferungen verwendet wird.

Kann ich in einem Webhook auf mehrere Ereignisse abhören?

Ja. Wähle einfach mehrere Ereignisse aus, wenn du den Webhook erstellst oder bearbeitest. Verwende den X-Webhook-Event-Header oder das event-Feld in der Payload deines Empfängers, um sie zu unterscheiden.

Was passiert, wenn mein Server ausfällt?

Die Zustellung wird als fehlgeschlagen protokolliert. Du kannst sie manuell über die Protokollseite erneut senden, sobald dein Server wieder verfügbar ist. Wir versuchen es nicht automatisch erneut, also gestalte deinen Empfänger so, dass er damit umgehen kann, dass ein Webhook gelegentlich später als erwartet eintrifft, oder hole fehlende Bestellungen über die REST-API als Backup ab.

Woher weiß ich, dass es tatsächlich Shoporama ist, das anruft?

Überprüfe den X-Webhook-Signature-Header mit dem geheimen Schlüssel deines Webhooks. Dieser wird in deinem Webhook im Shoporama-Admin angezeigt. Vergleiche ihn mit einem HMAC SHA-256 über den empfangenen Body. Wenn sie nicht übereinstimmen, lehne die Anfrage ab.

Kann ich Webhooks zusammen mit der REST-API verwenden?

Ja, und das ist oft eine gute Idee. Verwenden Sie Webhooks, um benachrichtigt zu werden, und nutzen Sie die REST-API, um vollständige Daten abzurufen oder Aktionen auf Grundlage des Ereignisses auszuführen.

Wie viele Webhooks kann ich erstellen?

In Shoporama gibt es keine feste Obergrenze. Erstellen Sie so viele, wie Sie benötigen, aber löschen Sie nicht mehr verwendete Webhooks, um unnötigen Datenverkehr zu stillgelegten URLs zu vermeiden.

Benötigen Sie Hilfe? Kontaktieren Sie uns unter support@shoporama.dk.