Webhook

Was ist ein Webhook?

Ein Webhook ist ein automatisierter HTTP-Aufruf – in der Regel ein POST –, den ein System an eine vereinbarte URL sendet, sobald ein bestimmtes Ereignis eintritt. Der Empfänger muss nicht ständig nach Daten fragen; die Quelle überträgt (pusht) die Informationen selbst, sobald etwas Neues passiert. Das ist der wesentliche Unterschied zwischen einem Webhook und einer REST API: Bei einer API müssen Sie Daten wiederholt abrufen (Polling), während ein Webhook die Daten von selbst liefert, sobald das Ereignis ausgelöst wird.

Warum ist ein Webhook wichtig?

In einem Online-Shop passieren ständig Dinge, auf die andere Systeme sofort reagieren müssen: Eine Bestellung wird erstellt, eine Zahlung wird freigegeben, der Lagerbestand ändert sich. Mit Webhooks vermeiden Sie es, Shopify jede Minute abzufragen, um dies zu bemerken – das Ereignis löst die Aktion in Echtzeit aus. Das macht Integrationen in Ihr ERP, Ihr Lagersystem, Ihre Buchhaltung oder für Transaktions-E-Mails schneller und zuverlässiger und reduziert unnötige API-Aufrufe und Verzögerungen.

Häufige Anwendungsfälle

• Bestellabwicklung: Senden Sie neue Bestellungen über orders/create an ein ERP oder ein Versandsystem.
• Lagerbestand und Produkte: Synchronisieren Sie Änderungen mit products/update oder inventory_levels/update.
• App-Bereinigung: Löschen Sie Kundendaten über app/uninstalled, wenn eine App deinstalliert wird.
• Benachrichtigungen: Lösen Sie eine E-Mail, eine Slack-Nachricht oder eine Rechnung aus, sobald eine Zahlung abgeschlossen ist.

Shopify-Perspektive

In Shopify können Sie Webhooks im Adminbereich unter Einstellungen → Benachrichtigungen oder über die Admin-API einer App erstellen. Die Zustellung erfolgt als POST an Ihren HTTPS-Endpunkt – standardmäßig als JSON, obwohl auch XML und Kanäle wie EventBridge und Pub/Sub unterstützt werden. Überprüfen Sie immer den Header X-Shopify-Hmac-Sha256 mit Ihrem App-Secret, um sicherzustellen, dass der Aufruf tatsächlich von Shopify stammt. Ihr Endpunkt muss schnell mit einem 2xx-Status (normalerweise 200) antworten; andernfalls versucht Shopify die Zustellung bis zu 48 Stunden lang erneut und entfernt dann das Abonnement.