Webhooks
Hjälpartiklar kanske inte är helt korrekta — på grund av frekventa uppdateringar och automatisk översättning kan de släpa efter appen. Kontakta supporten om du är osäker.
På den här sidan
Webhooks låter dina egna system få veta det ögonblick något händer i EventMann — en bokning bekräftad, en biljett incheckad, en utbetalning betald — istället för att du avsöker för ändringar. De finns under samma Integrationer-rad i sidofältet, på fliken Webhooks.
Hur du lägger till en slutpunkt
- Gå till Integrationer → Webhooks → Lägg till
- Ge det ett namn och den offentliga http(s)-URL som ska ta emot samtal — en privat eller intern adress avvisas helt och hållet, både här och varje gång en webhook faktiskt skjuts
- Bocka för vilka eventtyper du vill ta emot
- Spara. En 64-teckens signeringsnyckel genereras för dig automatiskt och visas maskerad; använd Visa/Göm för att avslöja det en gång
Événemang du kan prenumerera på
| Evenemang | Skjuts när |
|---|---|
booking.created | en bokning startar, före betalning |
booking.confirmed | en bokning bekräftas |
booking.cancelled | en bokning annulleras |
booking.refunded | en bokning återbetalas |
event.created | du skapar ett nytt evenemang |
event.published | ett evenemang går live |
event.cancelled | ett evenemang annulleras |
event.updated | evenemangsdetaljer ändras |
ticket.checked_in | en biljett skannas vid ingången |
payment.received | en betalning avvecklas |
payment.refunded | en betalning återbetalas |
payout.created | en utbetalning skapas |
payout.paid | en utbetalning betalas ut |
staff.assigned | en personal medlem tilldelas ditt evenemang |
staff.checked_in | en personal medlem checkar in för ett arbetspass |
vendor.assigned | en leverantör tilldelas ditt evenemang |
vendor.invoice_submitted | en leverantör skickar en faktura |
Själva leveransen
Varje samtal är ett POST av JSON formad så här:
{"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":"..."}
Tillsammans med det får du ett X-Webhook-Event-huvud som namnger evenemanget, ett X-Webhook-Delivery-Id och ett X-Webhook-Signature-huvud — en HMAC-SHA256 av det råa begärandekroppen, nyckklat med den nyckel som visas på slutpunktssidan. Beräkna om det på samma sätt på din sida och jämför innan du litar på en nyttolast.
Omförsök och vad som händer när en mottagare är nere
- En leverans försöks upp till 5 gånger, väntar 10, sedan 30, sedan 60 sekunder mellan försöken; bara ett 2xx-svar räknas som levererat
- När alla 5 försöken för ett evenemang har misslyckats, går slutpunktens misslyckande gå upp med exakt ett — inte en gång per försök
- 10 misslyckade leveranser inuti en rullande timme pausar den slutpunkten i 5 minuter; om misslyckande-räkningen någonsin går över 10, eller den pausen utlöses, stängs slutpunkten av automatiskt och slutar ta emot någonting tills du fixar det
- Du får ett in-app-meddelande det ögonblick detta händer, som namnger slutpunkten
- En inaktiverad slutpunkt visar ett “Denna slutpunkt är inaktiverad”-meddelande, med orsaken, på både slutpunktslistan och dess egen sida — att redigera dess namn, URL eller evenemang för inte att få den tillbaka. Fixa vad som helst som var fel med din mottagare, använd sedan Återaktivera-knappen; den rensar misslyckande-räkningen och återupptar leveransen, håller samma URL och signeringsnyckel
- Leveranshistorik — eventtyp, HTTP-status, varaktighet och tid — behålls i 30 dagar och rensas sedan automatiskt
Bra att veta
- Testa, på en slutpunkts sida, skickar ett syntetiskt
ping-evenemang så att du kan kontrollera din mottagare och signaturverifikation innan du prenumererar på något verkligt - Omför på en misslyckad leverans skickar det evenemanget friskt till dina för närvarande aktiva slutpunkter — det är en ny leverans, inte en återupptagning av den ursprungliga försökskedjan
- Webhook skickar körs i sin egen kö, separat från checkout och e-post, så en långsam eller bruten mottagare på din sida kan inte sakta ner bokningar eller biljetter e-post
- Att unbocka en eventtyp stoppar tyst att det skickas — det finns inget meddelande att du slutade ta emot någonting
Felsökning
- Leveranser stoppade utan fel synligt på min sida — öppna slutpunkten och kontrollera dess misslyckande räkning och status; om den visar inaktiverad, fixa din mottagare och klicka på Återaktivera
- Signatur matchar aldrig — hash det exakta råa begärandekroppen, inte en omserialisierad kopia av det, med den nyckel som visas på slutpunktssidan
- Testa lyckas men verkliga evenemang anländer aldrig — bekräfta att den specifika eventtypen är bockat på den slutpunkten; oprenumererade typer skickas helt enkelt aldrig