Eingehende Webhooks

Mit eingehenden Webhooks können externe Dienste (z. B. Shopify, Zapier, Make oder eigene Anwendungen) Automatisierungsflows in Ihrem Shop auslösen — indem sie eine HTTP-POST-Anfrage an eine eindeutige URL senden.

---

Schritt 1: Webhook-Endpunkt erstellen

1. Gehen Sie zu Admin > Einstellungen > Webhooks (im Bereich Automatisierung).
2. Klicken Sie auf Webhook erstellen.
3. Geben Sie einen Namen für den Endpunkt ein (z. B. "Shopify Bestellsync").
4. Das Dialogfenster zeigt die vollständige Webhook-URL und ein generiertes Secret.

Wichtig: Kopieren Sie das Secret jetzt — es wird nur einmal angezeigt. Nach dem Schließen des Dialogs ist es nicht mehr einsehbar. Verlieren Sie es, müssen Sie den Endpunkt löschen und neu erstellen.

5. Klicken Sie auf Speichern.

---

Schritt 2: Externen Dienst konfigurieren

Verwenden Sie die URL und das Secret in Ihrem externen Dienst:

POST {webhook-url}
Content-Type: application/json
Authorization: Bearer {secret}

{
  "aktion": "neue_bestellung",
  "bestellnummer": "ORD-12345",
  "betrag": 199.00
}

• Das Secret wird im Authorization: Bearer-Header übergeben.
• Der Body muss gültiges JSON sein (Content-Type: application/json).

Beispiel: Shopify Webhook einrichten

1. Öffnen Sie Ihr Shopify-Admin unter Einstellungen > Benachrichtigungen > Webhooks.
2. Klicken Sie auf Webhook erstellen.
3. Wählen Sie das Ereignis aus (z. B. "Bestellung abgeschlossen").
4. Tragen Sie die Webhook-URL ein.
5. Das Shopify-Secret unterscheidet sich vom Shop-Secret — Sie können den Shopify-Signature-Header in einem Conditional prüfen oder den Body direkt verarbeiten.

Beispiel: Make (ehemals Integromat)

1. Fügen Sie ein HTTP-Modul in Ihrem Szenario hinzu.
2. Methode: POST, URL: Ihr Webhook-URL.
3. Header: Authorization: Bearer {secret}, Content-Type: application/json.
4. Body: Die Daten, die Sie im Flow benötigen.

---

Schritt 3: Flow mit Webhook-Trigger erstellen

1. Gehen Sie zu Admin > Automatisierung > Flows und klicken Sie auf Flow erstellen.
2. Wählen Sie im Trigger-Dropdown Webhook empfangen.
3. Es erscheint ein Auswahlfeld — wählen Sie den soeben erstellten Webhook-Endpunkt.
4. Der Flow wird ausgelöst, sobald eine gültige POST-Anfrage an diesen Endpunkt eingeht.

---

Payload-Felder im Flow verwenden

Die gesendeten JSON-Daten sind über {{trigger.payload.feldname}} zugänglich:

Gesendetes JSON	Template-Variable
{"orderId": 42}	{{trigger.payload.orderId}}
{"customer": {"email": "..."}}	{{trigger.payload.customer.email}}
{"items": [...]}	{{trigger.payload.items}}

Außerdem stehen diese Metadaten bereit:

Variable	Beschreibung
{{trigger.hookId}}	ID des Webhook-Endpunkts
{{trigger.hookName}}	Name des Endpunkts (z. B. "Shopify Bestellsync")

Beispiel-Aktion mit Payload-Daten

E-Mail an: [email protected]
Betreff: Neue externe Bestellung: {{trigger.payload.bestellnummer}}
Text: Betrag: {{trigger.payload.betrag}} EUR

---

Endpunkte verwalten

Auf der Webhook-Liste in Admin > Einstellungen > Webhooks können Sie:

• Aktivieren/Deaktivieren — deaktivierte Endpunkte geben 404 zurück und lösen keine Flows aus.
• Löschen — löscht den Endpunkt dauerhaft; alle darauf zeigenden externen Dienste müssen aktualisiert werden.

---

Limits & Fehlercodes

Situation	Verhalten
Gültige Anfrage	HTTP 200 — Flow wird in die Warteschlange gestellt
Falsches oder fehlendes Secret	HTTP 401
Endpunkt deaktiviert	HTTP 404
Rate-Limit überschritten	HTTP 429 (max. 100 Anfragen/Stunde pro Endpunkt)
Payload > 256 KB	HTTP 413
Kein gültiges JSON	HTTP 400

Rate-Limit: Sollte Ihr externer Dienst mehr als 100 Anfragen pro Stunde senden, empfiehlt sich eine Batch-Verarbeitung oder das Zusammenführen mehrerer Ereignisse in einer Payload.