Webhooks
Hjælpeartikler er muligvis ikke helt nøjagtige — på grund af hyppige opdateringer og automatisk oversættelse kan de halte efter appen. Kontakt support, hvis du er i tvivl.
På denne side
En webhook fortæller dit eget system med det samme, når noget sker i EventMann, så du ikke behøver at spørge hele tiden. EventMann sender en HTTPS-forespørgsel til en adresse, du vælger, hver gang en abonneret begivenhed indtræffer: en booking bliver bekræftet, en ordre bliver refunderet, en begivenhed går live. Webhooks findes under fanen Webhooks under Integrationer i sidemenuen.
- Åbn Integrationer og klik på fanen Webhooks.
- Klik på Tilføj webhook for at oprette et endpoint.
- Kolonnen Status viser Aktiv eller Inaktiv sammen med HTTP-statussen for det seneste forsøg.
- Et inaktivt endpoint tilbyder Genaktivér.
Tilføj et endpoint
- Giv det et Navn, til din egen brug.
- Indtast Endpoint-URL, en offentlig webadresse, der accepterer en POST.
- Sæt kryds ved de begivenheder, du vil have, under Abonner på begivenheder. Mindst én er påkrævet.
- Klik på Tilføj webhook. Der oprettes en 64-tegns signeringsnøgle til dig.
Begivenheder du kan vælge
Formularen viser femten begivenheder, og hver af dem bliver sendt:
| Begivenhed | Sendes når |
|---|---|
booking.created | En ordre opstår: ved betalingen for gratis ordrer og ordrer med godkendelsesanmodning, og ved betalingstrinnet for betalte ordrer. |
booking.confirmed | En ordre bliver bekræftet: betalt, gratis eller indtastet manuelt. |
payment.received | En betaling bliver afregnet. Den sendes sammen med booking.confirmed, også for gratis ordrer. |
booking.cancelled | En ordre bliver annulleret: af køberen, af dig eller dit team, eller af EventMann-support. cancelled_by angiver hvem (attendee, organizer eller admin). |
booking.refunded | En ordre bliver refunderet helt. |
payment.refunded | En refusion bliver afregnet, også delvise. Én pr. refusion, med beløbet. |
event.created | En begivenhed oprettes, uanset hvordan den er lavet (guiden, kopi eller en gentagelsesserie). |
event.updated | En begivenheds oplysninger ændres: titel, beskrivelse, billede, datoer, sted eller adresse, onlinelink, salgsperiode eller synlighed. changed viser felterne. En statusændring er ikke en opdatering; den har sine egne begivenheder. |
event.published | En begivenhed går live. |
event.cancelled | Du annullerer en begivenhed. |
ticket.checked_in | En billet bliver lukket ind ved døren: scannet, indtastet manuelt, tjekket ind i bulk, synkroniseret fra en offline-scanner eller solgt og lukket ind ved billetkontoret. At tjekke en billet ud og markere en udeblivelse sender den ikke, og det gør heller ikke handlingen Tjek ind i bulk på ordrelisten, som markerer hele ordrer som ankomne uden en scanning ved døren. |
staff.assigned | Nogen bliver personale på en begivenhed: du godkender deres ansøgning, eller de accepterer en invitation til den begivenhed. |
staff.checked_in | Et personalemedlem stempler ind til en vagt. |
vendor.assigned | Du tildeler en leverandør til en begivenhed. |
vendor.invoice_submitted | En leverandør indsender en faktura for en opgave. |
Der er ingen udbetalingsbegivenheder. Stripe udbetaler dine billetindtægter direkte til din egen konto, og EventMann opretter eller ser ikke disse udbetalinger.
Sådan ser en levering ud
Hver levering er en POST med en JSON-tekst i denne form: event (navnet), data (detaljerne), timestamp og delivery_id. Dataene for booking.confirmed indeholder ordrens id, reference, status, total, deltagerens navn og e-mail, begivenhedens id og bekræftelsestidspunktet. booking.created tilføjer begivenhedens titel og indeholder i stedet oprettelsestidspunktet. payment.received indeholder booking-id, beløb, betalingsudbyder, transaktions-id og tidspunkt.
Forespørgslen har tre headers: X-Webhook-Event, X-Webhook-Delivery-Id og X-Webhook-Signature. Signaturen er en HMAC-SHA256 af den rå forespørgselstekst i hexadecimal, nøglet med endpointets signeringsnøgle. Beregn den igen på din side ud fra den rå tekst, og sammenlign den, før du stoler på en payload.
Kontroller et endpoint
- Klik på Send test for at sende en prøve-
pingtil din adresse og se resultatet med det samme. - Abonnerede begivenheder viser, hvad endpointet modtager. Brug Rediger for at ændre navn, adresse eller begivenheder.
- Signeringsnøglen er skjult; klik på Vis for at afsløre den.
- Seneste leveringer viser de sidste forsøg med begivenhed, status, HTTP-kode, varighed og tidspunkt. Se alle viser flere.
Forsøg, fejl og automatisk deaktivering
- Kun et 2xx-svar tæller som leveret. En omdirigering eller et andet svar er en fejl; omdirigeringer bliver ikke fulgt.
- En mislykket levering forsøges op til fem gange med 10, 30 og derefter 60 sekunders pause mellem forsøgene.
- Når alle forsøg for én begivenhed fejler, stiger endpointets fejltælling med én. Ti fejl inden for en time sætter levering til det pågældende endpoint på pause i fem minutter; leveringer venter pausen ud.
- Hvis pausen udløses, eller fejltællingen passerer ti, bliver endpointet deaktiveret, og du får en besked, der navngiver det.
- En adresse, der peger på et privat eller internt netværk, bliver afvist, når en levering forsøges. Testen viser „Blokeret“, og en rigtig levering deaktiverer endpointet.
- Leveringshistorikken gemmes i 30 dage.
- Et deaktiveret endpoint viser Dette endpoint er deaktiveret med årsagen.
- Ret det, der var galt hos din modtager, og klik derefter på Genaktivér. Fejltællingen nulstilles; adressen og nøglen forbliver de samme. Ændring af navn eller adresse genaktiverer ikke endpointet.
- Prøv igen på en mislykket levering sender den begivenhed igen som en ny levering til dine nuværende aktive endpoints, der abonnerer på den. Det omfatter dine andre endpoints, så de kan modtage den to gange.
Godt at vide
- Afsendelse af webhooks kører i sin egen kø, så en langsom modtager ikke kan bremse bookinger eller billet-e-mails.
- Hvis du fjerner markeringen ved en begivenhed, stopper den lydløst. Du får ingen besked om, at du er holdt op med at modtage den.
- Hvis du forbinder et værktøj som Zapier med en EventMann-API-token, vises de abonnementer, det opretter, også her, navngivet efter begivenheden.
- Webhooks sender hver ordres deltagernavn og e-mail til din server. Sørg for, at adressen er din, og at du må behandle disse data.
Fejlfinding
- Leveringerne er stoppet, og jeg ser ingen fejl — åbn endpointet. Hvis det er deaktiveret, så ret modtageren og klik på Genaktivér.
- Signaturen passer aldrig — beregn hash over den præcise rå tekst, ikke en omkodet kopi, med nøglen fra endpointsiden, og sammenlign hexadecimal tekst.
- Testen virker, men rigtige begivenheder kommer ikke frem — kontroller, at begivenheden har markering på dette endpoint, og at det, der skete, passer med kolonnen „Sendes når“ i tabellen.
- Jeg får den samme begivenhed to gange — du trykkede på Prøv igen, eller du har to endpoints, der abonnerer på den. Brug leverings-id’et til at ignorere gentagelser.