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
En webhook berättar för ditt egna system i samma ögonblick som något händer i EventMann, så att du inte behöver fråga hela tiden. EventMann skickar en HTTPS-förfrågan till en adress du väljer varje gång en prenumererad händelse inträffar: en bokning bekräftas, en order återbetalas eller ett evenemang publiceras. Webhooks finns under fliken Webhooks i Integrationer i sidomenyn.
- Öppna Integrationer och klicka på fliken Webhooks.
- Klicka på Lägg till webhook för att skapa en slutpunkt.
- Kolumnen Status visar Aktiv eller Inaktiverad, tillsammans med HTTP-statusen för det senaste försöket.
- En inaktiverad slutpunkt erbjuder Aktivera igen.
Lägg till en slutpunkt
- Ge den ett Namn, för ditt eget bruk.
- Ange Slutpunkts-URL, en publik webbadress som accepterar en POST.
- Bocka i de händelser du vill ha under Prenumerera på händelser. Minst en krävs.
- Klicka på Lägg till webhook. En signeringshemlighet med 64 tecken skapas åt dig.
Händelser du kan välja
Formuläret listar femton händelser, och var och en av dem skickas:
| Händelse | Skickas när |
|---|---|
booking.created | En order uppstår: vid utcheckningen för gratis order och förfrågningar om godkännande, vid betalningssteget för betalda order. |
booking.confirmed | En order bekräftas: betald, gratis eller inlagd manuellt. |
payment.received | En betalning går igenom. Den skickas tillsammans med booking.confirmed, även för gratis order. |
booking.cancelled | En order avbokas: av köparen, av dig eller ditt team, eller av EventManns support. cancelled_by anger vem (attendee, organizer eller admin). |
booking.refunded | En order återbetalas helt. |
payment.refunded | En återbetalning går igenom, även delvisa. En för varje återbetalning, med dess belopp. |
event.created | Ett evenemang skapas, oavsett hur (guiden, kopiering, återkommande serie). |
event.updated | Ett evenemangs uppgifter ändras: titel, beskrivning, bild, datum, lokal eller adress, onlinelänk, försäljningsfönster, synlighet. changed listar fälten. En statusändring är inte en uppdatering; den har egna händelser. |
event.published | Ett evenemang publiceras. |
event.cancelled | Du avbokar ett evenemang. |
ticket.checked_in | En biljett släpps in vid entrén: skannad, angiven för hand, incheckad i grupp, synkad från en offlineskanner eller såld och insläppt vid biljettkassan. Utcheckning av en biljett och markering av utebliven gäst skickar den inte, och inte heller åtgärden Checka in i ordrarnas lista, som markerar hela order som ankomna utan skanning vid entrén. |
staff.assigned | Någon blir personal på ett evenemang: du godkänner deras ansökan, eller de accepterar en inbjudan till det evenemanget. |
staff.checked_in | En personalmedlem stämplar in för ett pass. |
vendor.assigned | Du tilldelar en leverantör till ett evenemang. |
vendor.invoice_submitted | En leverantör skickar in en faktura för ett uppdrag. |
Det finns inga utbetalningshändelser. Stripe betalar dina biljettintäkter direkt till ditt eget konto, och EventMann skapar eller ser inte dessa utbetalningar.
Så ser en leverans ut
Varje leverans är en POST med en JSON-kropp i denna form: event (namnet), data (uppgifterna), timestamp och delivery_id. Datan för booking.confirmed innehåller order-id, referens, status, totalbelopp, köparens namn och e-postadress, evenemangets id och bekräftelsetiden. booking.created lägger till evenemangets titel och anger i stället skapandetiden. payment.received innehåller boknings-id, belopp, betalningsleverantör, transaktions-id och tid.
Förfrågan innehåller tre headers: X-Webhook-Event, X-Webhook-Delivery-Id och X-Webhook-Signature. Signaturen är en HMAC-SHA256 av den råa förfrågningskroppen i hexadecimal form, nycklad med slutpunktens signeringshemlighet. Beräkna den på din sida från den råa kroppen och jämför innan du litar på innehållet.
Kontrollera en slutpunkt
- Klicka på Skicka test för att skicka en exempel-
pingtill din adress och se resultatet direkt. - Prenumererade händelser visar vad slutpunkten tar emot. Använd Redigera för att ändra namn, adress eller händelser.
- Signeringshemlighet är dold; klicka på Visa för att visa den.
- Senaste leveranser listar de senaste försöken med händelse, status, HTTP-kod, varaktighet och tid. Visa alla visar fler.
Återförsök, fel och automatisk avstängning
- Endast ett 2xx-svar räknas som levererat. En omdirigering eller något annat svar är ett fel; omdirigeringar följs inte.
- En misslyckad leverans försöks upp till fem gånger, med 10, 30 och sedan 60 sekunders väntan mellan försöken.
- När alla försök för en händelse misslyckas ökar slutpunktens felräknare med ett. Tio fel inom en timme pausar leveranserna till slutpunkten i fem minuter; leveranserna väntar ut pausen.
- Om pausen utlöses, eller felräknaren passerar tio, stängs slutpunkten av och du får ett meddelande som nämner den.
- En adress som pekar på ett privat eller internt nätverk nekas när en leverans försöks. Testet visar ”Blockerad”, och en riktig leverans stänger av slutpunkten.
- Leveranshistoriken sparas i 30 dagar.
- En inaktiverad slutpunkt visar Den här slutpunkten är inaktiverad med skälet.
- Rätta det som var fel hos din mottagare och klicka sedan på Aktivera igen. Felräknaren nollställs; adressen och hemligheten förblir desamma. Att ändra namnet eller adressen aktiverar inte slutpunkten igen.
- Försök igen på en misslyckad leverans skickar den händelsen igen som en ny leverans till dina för närvarande aktiva slutpunkter som prenumererar på den. Detta inkluderar dina andra slutpunkter, så de kan få den två gånger.
Bra att veta
- Utskick av webhooks körs på en egen kö, så en långsam mottagare kan inte bromsa bokningar eller biljettmejl.
- Om du avmarkerar en händelse slutar den att skickas tyst. Du får ingen notis om att du slutat ta emot den.
- Om du kopplar ett verktyg som Zapier med en EventMann API-token visas de prenumerationer det skapar här också, namngivna efter händelsen.
- Webhooks skickar varje orders köparnamn och e-postadress till din server. Se till att adressen är din och att du får behandla de uppgifterna.
Felsökning
- Leveranserna har stannat och jag ser inget fel — öppna slutpunkten. Om den är inaktiverad, rätta mottagaren och klicka på Aktivera igen.
- Signaturen stämmer aldrig — hasha exakt den råa kroppen, inte en omkodad kopia, med hemligheten från slutpunktens sida, och jämför hexadecimal text.
- Testet fungerar men riktiga händelser kommer inte fram — kontrollera att händelsen är ibockad för denna slutpunkt, och att det som hände stämmer med kolumnen ”Skickas när” i tabellen.
- Jag får samma händelse två gånger — du tryckte på Försök igen, eller du har två slutpunkter som prenumererar på den. Använd leverans-id:t för att ignorera upprepningar.