Webhaken in Shoporama

Webhooks ermöglichen es Ihnen, dass Shoporama automatisch eine Nachricht an einen externen Dienst sendet, wenn etwas in Ihrem Shop passiert. Zum Beispiel, wenn eine neue Bestellung erstellt wird, wenn ein Produkt aktualisiert wird oder wenn sich ein Kunde zum ersten Mal anmeldet. Hier erfahren Sie, was Webhooks sind, auf welche Ereignisse Sie hören können und wie Sie sie erstellen.

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 wie eine "umgekehrte API" vor. Anstatt dass Sie Shoporama fragen: "Gibt es neue Bestellungen?", teilt Ihnen Shoporama dies automatisch mit.

Ohne Webhooks: Ihr Dienst fragt Shoporama alle 5 Minuten: "Gibt es neue Bestellungen?". Das ist ineffizient und verursacht unnötige Last.

Mit Webhooks: Shoporama benachrichtigt Sie sofort, wenn es eine neue Bestellung gibt. Das ist schnell und läuft in Echtzeit ab.

Verfügbare Webhook-Ereignisse

Sie können Webhooks für die folgenden Ereignisse einrichten. Beachten Sie, dass in den Ereignisnamen Unterstriche(order_created) und keine Punkte verwendet werden.

Ereignisse der Bestellung

Produkt- und Kategorieereignisse

Kunden- und Newsletter-Ereignisse

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

Erstellen Sie einen Webhook

1. Gehen Sie 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 für den Empfang von Webhook-Daten an
5. Wählen Sie die Ereignisse, die Sie abhören möchten (Sie können mehrere auswählen)
6. Klicken Sie auf "Speichern

Sie können auch ein Testereignis mit dem Ereignis test.ping direkt von der Protokollseite aus senden, um zu prüfen, ob Ihr Empfänger funktioniert.

Format der Webhook-Nutzdaten

Wenn ein Ereignis ausgelöst wird, sendet Shoporama eine HTTP POST-Anfrage an Ihre URL mit Daten im JSON-Format. Alle Webhooks haben die gleiche 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 Datenfeldes variiert je nach Ereignis. Bei Bestellungsereignissen erhalten Sie Informationen über die Bestellung, bei Produktereignissen Informationen über das Produkt und so weiter. Das Datenobjekt entspricht dem, was die REST-API für dieses Objekt zurückgibt.

HTTP-Header

Jede Webhook-Anfrage enthält diese Header, die Sie zur Überprüfung und Weiterleitung verwenden können:

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

Überprüfen der Signatur

Wenn Sie sicher sein wollen, dass die Anfrage tatsächlich von Shoporama kommt, verifizieren Sie den X-Webhook-Signature-Header mit dem geheimen Schlüssel, den Sie in Ihrem Webhook im Shoporama-Admin sehen 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

Ihr Empfangsdienst sollte mit dem HTTP-Status 2xx (normalerweise 200) antworten, um den Empfang zu bestätigen. Andere Statuscodes werden als Fehler protokolliert und Sie können fehlgeschlagene Zustellungen über die Protokollseite erneut senden.

Verwendung von Webhooks

Typische Anwendungen von Webhooks:

• Lagerintegration: neue Bestellungen automatisch an das Lager senden, z.B. bei Bezahlung
• Slack/Teams-Benachrichtigung: Lassen Sie sich über neue Bestellungen in Ihrem Kanal durch order_created benachrichtigen
• Lagerhaus-Synchronisation: Aktualisieren Sie das externe System, wenn der Bestand ausläuft
• CRM-Synchronisation: Erstellen Sie den Kunden in Klaviyo, ActiveCampaign oder Ihrem eigenen CRM mit customer_created
• Automatisierung: Workflows in Zapier, Make oder ähnlichem auslösen

Protokolle und erneutes Senden

Für jeden Webhook können Sie ein Protokoll aller Lieferungen (Antwortcodes, Dauer, Nutzlast und Fehler) einsehen. Sie können nach Ereignistyp, Status und Datum filtern. Fehlgeschlagene Zustellungen können mit einem Klick manuell nachgesendet werden. Die Protokolle werden kontinuierlich automatisch geleert.

Häufig gestellte Fragen

Wo kann ich die Webhook-Liste finden?

Klicken Sie auf das Zahnrad in Ihrem Shoporama-Admin und gehen Sie über die drei Punkte zu Webhooks. Sie können auch unsere Anleitung lesen, um die erstellten Webhooks in Ihrem Shop einzusehen.

Wie schnell wird der Webhook angezeigt?

Webhooks werden in eine Warteschlange gestellt und in der Regel innerhalb weniger Sekunden versendet. Zu Spitzenzeiten kann es zu einer leichten Verzögerung kommen, die aber nie mehr als ein oder zwei Minuten beträgt.

Gibt es ein Ereignis "order_sent"?

Nein, gibt es nicht. Es gibt kein separates Ereignis für "gesendet". Wenn Sie eine Bestellung als gesendet markieren, wird new_status mit dem neuen Status in der Nutzlast ausgelöst. Hören Sie auf dieses Ereignis und prüfen Sie data.status, wenn Sie auf Statusänderungen reagieren wollen.

Sollten Ereignisse mit Punkten oder Unterstrichen geschrieben werden?

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

Kann ich auf mehrere Ereignisse im selben Webhook hören?

Ja, das können Sie. Wählen Sie einfach mehrere Ereignisse aus, wenn Sie den Webhook erstellen oder bearbeiten. Verwenden Sie den X-Webhook-Event-Header oder das Ereignisfeld in der Nutzlast in Ihrem Empfänger, um sie zu unterscheiden.

Was passiert, wenn mein Server ausgefallen ist?

Die Zustellung wird als fehlgeschlagen protokolliert. Wenn Ihr Server wieder verfügbar ist, können Sie den Versand manuell über die Protokollseite wiederholen. Wir versuchen es nicht automatisch erneut. Richten Sie also Ihren Empfänger so ein, dass er gelegentlich einen Webhook toleriert, der 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 anruft?

Überprüfen Sie den X-Webhook-Signature-Header mit dem geheimen Schlüssel Ihres Webhooks. Er erscheint auf Ihrem Webhook in der Shoporama-Verwaltung. Vergleichen Sie mit einem HMAC SHA-256 über den empfangenen Body. Wenn Sie nicht übereinstimmen, lehnen Sie die Anfrage ab.

Kann ich Webhooks 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 der Grundlage des Ereignisses durchzuführen.

Wie viele Webhooks kann ich erstellen?

In Shoporama gibt es keine feste Grenze. Sie können so viele Webhooks erstellen, wie Sie benötigen. Löschen Sie jedoch nicht mehr verwendete Webhooks, um unnötigen Datenverkehr zu nicht mehr existierenden URLs zu vermeiden.

Brauchen Sie Hilfe? Kontaktieren Sie uns unter support@shoporama.dk.