Webhooks

Webhooks lader dine egne systemer blive fortalt det øjeblik noget sker i EventMann — en booking bekræftet, en billet markeret ind, en udbetaling udbetalt — i stedet for at du afstemmer for ændringer. De lever under samme Integrationer række i sidepanelet, på fanen Webhooks.

Sådan tilføjer du et endpoint

1. Gå til Integrationer → Webhooks → Tilføj
2. Giv det et navn og den offentlige http(s)-URL der skal modtage opkaldene — en privat eller intern adresse afvises direkte, både her og hver gang en webhook faktisk affyres
3. Markér hvilke event-typer du ønsker at modtage
4. Gem. En 64-tegns underskrift hemmelighed genereres for dig automatisk og vises maskeret; brug Vis/Skjul for at afsløre den én gang

Events du kan abonnere på

Event	Affyres når
booking.created	en booking starter, før betaling
booking.confirmed	en booking bekræftes
booking.cancelled	en booking aflystes
booking.refunded	en booking refunderes
event.created	du opretter en ny event
event.published	en event går live
event.cancelled	en event aflystes
event.updated	event-detaljerne ændres
ticket.checked_in	en billet skannes ved døren
payment.received	en betaling afgjøres
payment.refunded	en betaling refunderes
payout.created	en udbetaling oprettes
payout.paid	en udbetaling udbetales
staff.assigned	et personalemedlem tildeles din event
staff.checked_in	et personalemedlem markerer ind til en vagt
vendor.assigned	en leverandør tildeles din event
vendor.invoice_submitted	en leverandør indsender en faktura

Selve leveringen

Hvert opkald er en POST af JSON formet sådan:

{"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":"..."}

Sammen med det får du en X-Webhook-Event header der navngiver eventen, en X-Webhook-Delivery-Id og en X-Webhook-Signature header — en HMAC-SHA256 af det råe request-krop, nøgleret med hemmeligheden vist på endpoint-siden. Genberegn det samme på din side og sammenlign før du stoler på en payload.

Gentagelser og hvad der sker når en modtager er nede

• En levering forsøges op til 5 gange, venter 10, derefter 30, derefter 60 sekunder mellem forsøg; kun et 2xx svar tæller som leveret
• Når alle 5 forsøg for en event er mislykket, går endpointets fejlantal op med nøjagtigt ét — ikke én gang pr. forsøg
• 10 mislykkede leveringer inden for en rulling time pause det endpoint i 5 minutter; hvis fejltallet nogensinde passerer 10 eller denne pause udløses, slår endpointet selv fra og stopper med at modtage noget til du retter det
• Du får en in-app besked det øjeblik dette sker, der nævner endpointet
• Et deaktiveret endpoint viser en "Dette endpoint er deaktiveret" besked, med årsagen, både på endpoint-listen og sin egen side — redigering af navn, URL eller events bringer det ikke tilbage. Fix hvad der end var galt med din modtager, brug derefter knappen Genaktiver; det rydder fejltallet og genoptager leveringen, keepende samme URL og underskrift hemmelighed
• Leveringshistorik — event-type, HTTP-status, varighed og tid — føres i 30 dage og ryddes derefter automatisk

Godt at vide

• Test, på et endpoints side, sender en syntetisk ping event så du kan kontrollere din modtager og signaturverifikation før du abonnerer på noget virkeligt
• Gentag på en mislykket levering sender den event frisk til dine nuværende aktive endpoints — det er en ny levering, ikke en genoptagelse af den oprindelige forsøgskæde
• Webhook-sendinger køres på deres egen kø, adskilt fra checkout og e-mail, så en langsom eller ødelagt modtager på din side ikke kan bremse bookinger eller billetemails
• Afmærkning af en event-type stopper stilfærdigt med det bliver sendt — der er ingen besked om at du stoppede med at modtage noget

Fejlfinding

• Leveringer stoppede uden fejl synlig på min side — åbn endpointet og kontroller dets fejltal og status; hvis det viser deaktiveret, fix din modtager og klik Genaktiver
• Signatur stemmer aldrig — hash det nøjagtige råe request-krop, ikke en re-serialiseret kopi af det, med hemmeligheden vist på endpointets side
• Test lykkes men rigtige events ankommer aldrig — bekræft den specifikke event-type er markeret på det endpoint; abonnementet-typer bliver simpelthen aldrig sendt

Relateret

• Integrations
• Orders
• Check-in
• Payouts