Webhooks einrichten

Mit Webhooks musst du nicht ständig nachfragen, ob es etwas Neues gibt. Sobald etwa eine Bestellung bezahlt ist, schicken wir die Daten per POST an eine Adresse deiner Wahl, zum Beispiel an dein CRM, deine Buchhaltung oder an Zapier, Make oder n8n. Jede Zustellung ist signiert, damit du prüfen kannst, dass sie von uns kommt.

Endpunkt hinzufügen

1. Öffne Integrationen und klick bei Webhooks auf Endpunkt hinzufügen.

Im Dialog trägst du ein:

1. Adresse: Die Adresse, an die wir senden. Sie muss mit https:// beginnen und aus dem Internet erreichbar sein.
2. Beschreibung: Freiwillig, damit du den Endpunkt später wiedererkennst.
3. Ereignisse: Lass Alle Ereignisse an, dann bekommt der Endpunkt alles, auch Ereignisse, die wir später einführen. Oder nimm den Haken weg und wähl nur die Ereignisse, die du brauchst.

Klick auf Endpunkt hinzufügen. Die Seite des Endpunkts öffnet sich, und ab jetzt bekommt er jedes passende Ereignis. Was die einzelnen Ereignisse bedeuten, steht unter Webhook-Ereignisse.

Ausprobieren

Auf der Seite des Endpunkts siehst du Adresse, Ereignisse, das Signatur-Geheimnis und alle Zustellungen.

1. Klick auf Test-Ereignis senden. Wir schicken sofort ein Ereignis vom Typ webhook.test, das du unten im Log siehst. So prüfst du, ob deine Adresse erreichbar ist und richtig antwortet.
2. Über Weitere Aktionen bearbeitest du den Endpunkt, schaltest ihn aus oder löschst ihn.

Was deine Adresse tun muss

• Schnell antworten: Antworte innerhalb von zehn Sekunden mit einem Status zwischen 200 und 299. Alles andere zählt als gescheitert, auch eine Weiterleitung. Gescheiterte Zustellungen versuchen wir bis zu 24 Stunden lang erneut.
• Signatur prüfen: Vertrau dem Inhalt erst, wenn die Signatur stimmt: Webhooks absichern.
• Doppelte überspringen: Dasselbe Ereignis kann ausnahmsweise zweimal ankommen. Merk dir die id jedes Ereignisses und verarbeite sie nur einmal.
• Später verarbeiten: Dauert die Verarbeitung länger, nimm das Ereignis an, antworte sofort und erledige den Rest danach.

Endpunkt bearbeiten, ausschalten oder löschen

Über Weitere Aktionen auf der Seite des Endpunkts:

Aktion	Was passiert
Bearbeiten	Adresse, Beschreibung und Ereignisse ändern. Eine neue Adresse gilt auch für Zustellungen, die wir gerade noch wiederholen.
Ausschalten	Der Endpunkt bekommt nichts mehr. Ereignisse aus dieser Zeit schicken wir auch später nicht nach.
Anschalten	Ab jetzt gehen wieder Ereignisse raus.
Löschen	Der Endpunkt und sein Zustell-Log sind weg.

In der Liste unter Integrationen siehst du für jeden Endpunkt den Status (An, Aus oder Angehalten) und wie die letzte Zustellung ausging. Angehalten heißt: Die Zustellungen sind einen ganzen Tag lang gescheitert, und wir haben den Endpunkt angehalten. Mehr dazu unter Zustellungen und Wiederholungen.

Häufige Fragen

Wie viele Endpunkte kann ich anlegen?

Bis zu 16 pro Workspace. Mehrere Endpunkte dürfen dieselben Ereignisse bekommen, jeder erhält dann seine eigene Zustellung.

Kann ich eine Adresse mit http oder in meinem eigenen Netz verwenden?

Nein. Wir senden nur an https://-Adressen, die öffentlich im Internet erreichbar sind. Interne Adressen lehnen wir aus Sicherheitsgründen ab, und Weiterleitungen folgen wir nicht.

Kann ich Endpunkte auch per API anlegen?

Ja, mit einem API-Key, der Zugriff auf Webhooks hat. Die Endpunkte stehen in der API-Doku unter „Webhook endpoints“.

Bekomme ich ein Ereignis auch, wenn ich selbst im Dashboard etwas ändere?

Ja. Es ist egal, ob eine Änderung aus dem Shop, aus dem Dashboard oder über die API kommt.

Wer darf Webhooks einrichten?

Inhaber und Admins. Die Zustellungen enthalten Namen und E-Mail-Adressen deiner Käufer, deshalb sind Webhooks auf diese Rollen beschränkt.