Webhaken in Shoporama

Mit Webhooks können Sie Shoporama so einrichten, dass automatisch eine Benachrichtigung an einen externen Dienst gesendet wird, sobald in Ihrem Shop etwas passiert. Zum Beispiel, wenn eine neue Bestellung erstellt wird, wenn ein Produkt aktualisiert wird oder wenn sich ein Kunde zum ersten Mal anmeldet. Hier erklären wir Ihnen, was Webhooks sind, auf welche Ereignisse Sie reagieren können und wie Sie sie einrichten.

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 Sie sofort, sobald eine neue Bestellung vorliegt. Das geht schnell und erfolgt 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 im linken Menü zu „Integrationen“
2. Klicke auf „Webhooks“
3. Klicken Sie auf „Webhook erstellen“
4. Geben Sie die URL an, die die Webhook-Daten empfangen soll
5. Wählen Sie die Ereignisse aus, auf die Sie achten möchten (Sie können mehrere auswählen)
6. Klicken Sie auf „Speichern“

Sie können auch direkt von der Protokollseite aus ein Testereignis mit dem Ereignis „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 Feldes „data“ 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 zum Routing 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, überprüfen Sie den Header „X-Webhook-Signature“ 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 Ihres Empfängers

Dein Empfängerdienst muss mit einem HTTP-Status von 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: Sende neue Bestellungen automatisch an das Lagerhotel, z. B. bei „paid“
• Slack/Teams-Benachrichtigung: Lass dich über neue Bestellungen in deinem Kanal per „order_created“ benachrichtigen
• Lagersynchronisierung: Aktualisiere 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. Die Protokolle werden regelmäßig automatisch gelöscht.

Häufig gestellte Fragen

Wo finde ich die Webhook-Liste?

Gehe im linken Menü deines Shoporama-Adminbereichs zu „Integrationen “ und klicke auf „Webhooks“. Du kannst auch unseren Leitfaden lesen, um die in deinem Shop erstellten Webhooks anzuzeigen.

Wie schnell wird der Webhook übermittelt?

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 das Ereignis „new_status“ mit dem neuen Status in der Nutzlast 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 Feld „event“ in der Nutzlast deines Empfängers, um sie voneinander zu unterscheiden.

Was passiert, wenn mein Server ausfällt?

Die Übermittlung wird als fehlgeschlagen protokolliert. Du kannst sie manuell über die Protokollseite erneut senden, sobald dein Server wieder verfügbar ist. Wir führen keinen automatischen Wiederholungsversuch durch. Richten Sie Ihren Empfänger daher so ein, dass er damit umgehen kann, wenn ein Webhook gelegentlich später als erwartet eintrifft, oder rufen Sie fehlende Bestellungen über die REST-API als Backup ab.

Woher weiß ich, dass es tatsächlich Shoporama ist, das den Aufruf sendet?

Überprüfe den Header „X-Webhook-Signature“ mit dem geheimen Schlüssel deines Webhooks. Dieser wird in deinem Webhook im Shoporama-Adminbereich 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 nutzen?

Ja, und das ist oft eine gute Idee. Verwende Webhooks, um benachrichtigt zu werden, und nutze die REST-API, um vollständige Daten abzurufen oder basierend auf dem Ereignis Aktionen auszuführen.

Wie viele Webhooks kann ich erstellen?

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

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