Webhooks
Helpartikelen zijn mogelijk niet volledig accuraat — door frequente updates en automatische vertaling kunnen ze achterlopen op de app. Neem bij twijfel contact op met support.
Met webhooks kunnen uw eigen systemen op het moment zelf worden geïnformeerd zodra er iets gebeurt in EventMann — een boeking bevestigd, een ticket ingecheckt, een uitbetaling voldaan — in plaats van dat u zelf moet pollen op wijzigingen. Ze staan onder dezelfde rij Integraties in de zijbalk, op het tabblad Webhooks.
Een eindpunt toevoegen
- Ga naar Integraties → Webhooks → Toevoegen
- Geef het een naam en de openbare http(s)-URL die de aanroepen moet ontvangen — een privé- of intern adres wordt meteen geweigerd, zowel hier als elke keer dat een webhook daadwerkelijk wordt geactiveerd
- Vink aan welke gebeurtenistypen u wilt ontvangen
- Opslaan. Er wordt automatisch een ondertekeningsgeheim van 64 tekens voor u gegenereerd en gemaskeerd weergegeven; gebruik Tonen/Verbergen om het eenmalig te onthullen
Gebeurtenissen waarop u zich kunt abonneren
| Gebeurtenis | Wanneer dit wordt geactiveerd |
|---|---|
booking.created | een boeking start, vóór betaling |
booking.confirmed | een boeking wordt bevestigd |
booking.cancelled | een boeking wordt geannuleerd |
booking.refunded | een boeking wordt terugbetaald |
event.created | u maakt een nieuw evenement aan |
event.published | een evenement gaat live |
event.cancelled | een evenement wordt geannuleerd |
event.updated | evenementgegevens wijzigen |
ticket.checked_in | een ticket wordt bij de deur gescand |
payment.received | een betaling wordt afgerond |
payment.refunded | een betaling wordt terugbetaald |
payout.created | een uitbetaling wordt aangemaakt |
payout.paid | een uitbetaling wordt uitbetaald |
staff.assigned | een personeelslid wordt toegewezen aan uw evenement |
staff.checked_in | een personeelslid checkt in voor een dienst |
vendor.assigned | een leverancier wordt toegewezen aan uw evenement |
vendor.invoice_submitted | een leverancier dient een factuur in |
De aflevering zelf
Elke aanroep is een POST van JSON met deze vorm:
{"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":"..."}
Daarnaast krijgt u een header X-Webhook-Event die de gebeurtenis benoemt, een X-Webhook-Delivery-Id, en een header X-Webhook-Signature — een HMAC-SHA256 van de ruwe request-body, met als sleutel het geheim dat op de eindpuntpagina wordt getoond. Bereken deze op dezelfde manier aan uw kant opnieuw en vergelijk ze voordat u een payload vertrouwt.
Opnieuw proberen en wat er gebeurt als een ontvanger niet bereikbaar is
- Een aflevering wordt tot 5 keer geprobeerd, met wachttijden van 10, dan 30, dan 60 seconden tussen de pogingen; alleen een 2xx-reactie telt als afgeleverd
- Zodra alle 5 pogingen voor één gebeurtenis zijn mislukt, gaat de mislukkingenteller van het eindpunt precies één keer omhoog — niet één keer per poging
- 10 mislukte afleveringen binnen een voortschrijdend uur zetten dat eindpunt 5 minuten op pauze; als de mislukkingenteller ooit boven de 10 uitkomt, of die pauze wordt geactiveerd, schakelt het eindpunt automatisch uit en ontvangt het niets meer totdat u het probleem verhelpt
- U krijgt op het moment dat dit gebeurt een melding in de app, met de naam van het eindpunt
- Een uitgeschakeld eindpunt toont zowel op de eindpuntenlijst als op de eigen pagina de melding "Dit eindpunt is uitgeschakeld", met de reden — het bewerken van de naam, URL of gebeurtenissen van het eindpunt brengt het niet terug. Los op wat er mis was met uw ontvanger, en gebruik dan de knop Opnieuw inschakelen; deze zet de mislukkingenteller terug op nul en hervat de aflevering, met behoud van dezelfde URL en hetzelfde ondertekeningsgeheim
- De afleveringsgeschiedenis — gebeurtenistype, HTTP-status, duur en tijdstip — wordt 30 dagen bewaard en daarna automatisch gewist
Goed om te weten
- Test verzenden, op de pagina van een eindpunt, verstuurt een synthetische
ping-gebeurtenis, zodat u uw ontvanger en handtekeningverificatie kunt controleren voordat u zich op iets echts abonneert - Opnieuw proberen bij een mislukte aflevering verstuurt die gebeurtenis opnieuw naar uw huidige actieve eindpunten — dit is een nieuwe aflevering, geen voortzetting van de oorspronkelijke pogingenreeks
- Het verzenden van webhooks draait op een eigen wachtrij, los van afrekenen en e-mail, zodat een trage of kapotte ontvanger aan uw kant geen boekingen of ticket-e-mails kan vertragen
- Het uitvinken van een gebeurtenistype stopt het verzenden ervan zonder melding — er is geen waarschuwing dat u iets niet meer ontvangt
Problemen oplossen
- Afleveringen zijn gestopt zonder zichtbare fout aan mijn kant — open het eindpunt en controleer de mislukkingenteller en status; als het uitgeschakeld toont, lost u uw ontvanger op en klikt u op Opnieuw inschakelen
- Handtekening komt nooit overeen — hash exact de ruwe request-body, niet een opnieuw geserialiseerde kopie ervan, met het geheim dat op de eindpuntpagina wordt getoond
- Test slaagt, maar echte gebeurtenissen komen nooit aan — controleer of het specifieke gebeurtenistype is aangevinkt op dat eindpunt; niet-geabonneerde typen worden simpelweg nooit verzonden