Webhooks
Hilfeartikel können unvollständig oder veraltet sein – sie können sich aufgrund häufiger Updates und automatisierter Übersetzung von der App unterscheiden. Im Zweifelsfall wenden Sie sich bitte an den Support.
Webhooks lassen Ihre eigenen Systeme in dem Moment benachrichtigen, in dem in EventMann etwas passiert — eine Buchung bestätigt, ein Ticket eingecheckt, eine Auszahlung ausgezahlt — statt dass Sie auf Änderungen pollen müssen. Sie finden sich in derselben Seitenleisten-Zeile Integrationen, auf dem Tab Webhooks.
So fügen Sie einen Endpunkt hinzu
- Gehen Sie zu Integrationen → Webhooks → Hinzufügen
- Geben Sie einen Namen und die öffentliche http(s)-URL an, die die Aufrufe empfangen soll — eine private oder interne Adresse wird rundweg abgelehnt, sowohl hier als auch jedes Mal, wenn ein Webhook tatsächlich auslöst
- Haken Sie an, welche Ereignistypen Sie empfangen möchten
- Speichern. Ein 64 Zeichen langer Signierungsschlüssel wird automatisch für Sie erzeugt und maskiert angezeigt; nutzen Sie Anzeigen/Ausblenden, um ihn einmal einzusehen
Ereignisse, die Sie abonnieren können
| Ereignis | Löst aus, wenn |
|---|---|
booking.created | eine Buchung beginnt, vor der Zahlung |
booking.confirmed | eine Buchung bestätigt wird |
booking.cancelled | eine Buchung storniert wird |
booking.refunded | eine Buchung erstattet wird |
event.created | Sie ein neues Event erstellen |
event.published | ein Event live geht |
event.cancelled | ein Event storniert wird |
event.updated | sich Eventdetails ändern |
ticket.checked_in | ein Ticket am Einlass gescannt wird |
payment.received | eine Zahlung abgeschlossen wird |
payment.refunded | eine Zahlung erstattet wird |
payout.created | eine Auszahlung erstellt wird |
payout.paid | eine Auszahlung ausgezahlt wird |
staff.assigned | ein Teammitglied Ihrem Event zugewiesen wird |
staff.checked_in | ein Teammitglied für eine Schicht eincheckt |
vendor.assigned | ein Anbieter Ihrem Event zugewiesen wird |
vendor.invoice_submitted | ein Anbieter eine Rechnung einreicht |
Die Zustellung selbst
Jeder Aufruf ist ein POST von JSON in dieser Form:
{"event":"booking.confirmed","data":{"id":1,"reference":"BK-ABC123","status":"confirmed","total":49.99,"currency":"USD","attendee_name":"Jane Doe","attendee_email":"jane@example.com","event_id":10,"confirmed_at":"2026-03-01T12:05:00Z"},"timestamp":"2026-03-01T12:05:00Z","delivery_id":"..."}
Zusätzlich erhalten Sie einen Header X-Webhook-Event, der das Ereignis benennt, eine X-Webhook-Delivery-Id, und einen Header X-Webhook-Signature — ein HMAC-SHA256 des rohen Request-Bodys, mit dem auf der Endpunktseite angezeigten Schlüssel signiert. Berechnen Sie es auf Ihrer Seite genauso neu und vergleichen Sie es, bevor Sie einer Nutzlast vertrauen.
Wiederholungen und was passiert, wenn ein Empfänger nicht erreichbar ist
- Eine Zustellung wird bis zu 5-mal versucht, mit 10, dann 30, dann 60 Sekunden Wartezeit zwischen den Versuchen; nur eine 2xx-Antwort zählt als zugestellt
- Sobald alle 5 Versuche für ein Ereignis fehlgeschlagen sind, steigt der Fehlerzähler des Endpunkts um genau eins — nicht pro Versuch
- 10 fehlgeschlagene Zustellungen innerhalb einer gleitenden Stunde pausieren diesen Endpunkt für 5 Minuten; überschreitet der Fehlerzähler jemals 10, oder wird diese Pause ausgelöst, schaltet sich der Endpunkt automatisch ab und empfängt nichts mehr, bis Sie ihn reparieren
- Sie erhalten in dem Moment, in dem das passiert, eine In-App-Benachrichtigung mit dem Namen des Endpunkts
- Ein deaktivierter Endpunkt zeigt sowohl in der Endpunktliste als auch auf seiner eigenen Seite den Hinweis „Dieser Endpunkt ist deaktiviert" samt Grund — das Bearbeiten von Name, URL oder Ereignissen bringt ihn nicht zurück. Beheben Sie, was mit Ihrem Empfänger nicht stimmte, und nutzen Sie dann die Schaltfläche Wieder aktivieren; sie setzt den Fehlerzähler zurück und hebt die Pause auf, wobei URL und Signierungsschlüssel gleich bleiben
- Der Zustellverlauf — Ereignistyp, HTTP-Status, Dauer und Zeitpunkt — wird 30 Tage lang aufbewahrt und danach automatisch gelöscht
Gut zu wissen
- Test sendet auf der Seite eines Endpunkts ein synthetisches
ping-Ereignis, damit Sie Ihren Empfänger und die Signaturprüfung testen können, bevor Sie irgendetwas Reales abonnieren - Erneut versuchen bei einer fehlgeschlagenen Zustellung sendet dieses Ereignis frisch an Ihre aktuell aktiven Endpunkte erneut — es ist eine neue Zustellung, keine Fortsetzung der ursprünglichen Versuchskette
- Der Webhook-Versand läuft in einer eigenen Warteschlange, getrennt von Checkout und E-Mail, sodass ein langsamer oder defekter Empfänger auf Ihrer Seite weder Buchungen noch Ticket-E-Mails verlangsamen kann
- Einen Ereignistyp abzuhaken beendet dessen Versand stillschweigend — es gibt keinen Hinweis darauf, dass Sie etwas nicht mehr empfangen
Fehlerbehebung
- Zustellungen sind gestoppt, ohne dass auf meiner Seite ein Fehler sichtbar ist — öffnen Sie den Endpunkt und prüfen Sie seinen Fehlerzähler und Status; wenn er deaktiviert anzeigt, beheben Sie Ihren Empfänger und klicken Sie auf Wieder aktivieren
- Die Signatur stimmt nie überein — hashen Sie den exakten rohen Request-Body, nicht eine neu serialisierte Kopie davon, mit dem auf der Endpunktseite angezeigten Schlüssel
- Der Test gelingt, aber echte Ereignisse kommen nie an — bestätigen Sie, dass der jeweilige Ereignistyp für diesen Endpunkt angehakt ist; nicht abonnierte Typen werden schlicht nie gesendet