Webhooks
Verwaltungsseite für Webhook-Registrierungen im Shopware-6-Shop. Webhooks ermöglichen Echtzeit-Benachrichtigungen bei Ereignissen im Shop (z. B. neue Bestellung, Statusänderung), ohne dass Business Central aktiv den Shop abfragen muss.
Seite öffnen
- Über die Suche: Shopware 6 Webhooks
- Über das Shopware 6 Dashboard → Navigation → Webhooks
Felder
| Feld | Beschreibung |
|---|---|
| Shop Code | Shop, für den der Webhook registriert ist. |
| Event Name | Shopware-Event-Name (z. B. order.placed, order.state_machine.order.delivery.state_changed). |
| Webhook URL | Endpunkt-URL, an die Shopware die Events sendet (typischerweise eine Azure Function). |
| Active | Bestimmt, ob der Webhook aktiv ist und Events empfängt. |
| Shopware Webhook ID | UUID der Registrierung im Shopware-Shop. Wird automatisch beim Registrieren gesetzt. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Register Webhooks | Registriert alle konfigurierten Webhooks im Shopware-Shop. Bestehende Registrierungen werden aktualisiert. |
| Unregister Webhooks | Entfernt alle Webhook-Registrierungen aus dem Shopware-Shop. |
| Show Events | Öffnet die Liste der empfangenen Webhook-Events. |
Webhook Events
Die Seite Webhook Events zeigt alle empfangenen Events:
| Feld | Beschreibung |
|---|---|
| Event Name | Typ des empfangenen Events. |
| Received At | Zeitstempel des Empfangs. |
| Processed | Ob das Event bereits verarbeitet wurde. |
| Payload | JSON-Inhalt des Events (Vorschau). |
Hinweise
Azure Function als Endpunkt
Webhooks benötigen einen öffentlich erreichbaren HTTPS-Endpunkt. Es empfiehlt sich eine Azure Function, die eingehende Events entgegennimmt und in die Business-Central-Work-Queue weiterleitet.
HMAC-Signaturprüfung
Shopware signiert Webhook-Payloads mit einem HMAC-Secret. Die Azure Function sollte die Signatur validieren, um manipulierte Requests abzulehnen.
- Webhooks ergänzen die reguläre Job-Queue-basierte Synchronisation — sie ersetzen sie nicht.
- Bei Ausfall des Webhook-Endpunkts greift die Job Queue als Fallback.
- Nicht alle Shop-Events sind für BC relevant — konfigurieren Sie nur die benötigten Events.