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.
Een webhook vertelt uw eigen systeem op het moment dat er iets gebeurt in EventMann, zodat u niet steeds hoeft te vragen. EventMann stuurt bij elke geabonneerde gebeurtenis een HTTPS-verzoek naar een adres dat u kiest: een boeking wordt bevestigd, een bestelling wordt terugbetaald, een evenement gaat live. Webhooks vindt u op het tabblad Webhooks van Integraties in de zijbalk.
- Open Integraties en klik op het tabblad Webhooks.
- Klik op Webhook toevoegen om een eindpunt aan te maken.
- In de kolom Status staat Actief of Uitgeschakeld, met de HTTP-status van de laatste poging.
- Een uitgeschakeld eindpunt biedt Opnieuw inschakelen aan.
Een eindpunt toevoegen
- Geef het een Naam, voor uw eigen gebruik.
- Voer de Eindpunt-URL in, een publiek webadres dat een POST accepteert.
- Vink de gebeurtenissen aan die u wilt onder Abonneren op gebeurtenissen. Minstens één is vereist.
- Klik op Webhook toevoegen. Er wordt voor u een ondertekeningsgeheim van 64 tekens aangemaakt.
Gebeurtenissen die u kunt kiezen
Het formulier toont vijftien gebeurtenissen, en elk daarvan wordt verzonden:
| Gebeurtenis | Verzonden wanneer |
|---|---|
booking.created | Een bestelling ontstaat: bij het afrekenen voor gratis bestellingen en bestellingen met een goedkeuringsverzoek, bij de betaalstap voor betaalde bestellingen. |
booking.confirmed | Een bestelling wordt bevestigd: betaald, gratis of handmatig ingevoerd. |
payment.received | Een betaling wordt afgeboekt. Hij wordt samen met booking.confirmed verzonden, ook voor gratis bestellingen. |
booking.cancelled | Een bestelling wordt geannuleerd: door de koper, door u of uw team, of door de support van EventMann. cancelled_by geeft aan wie (attendee, organizer of admin). |
booking.refunded | Een bestelling wordt volledig terugbetaald. |
payment.refunded | Een terugbetaling wordt afgeboekt, ook gedeeltelijke. Eén per terugbetaling, met het bedrag. |
event.created | Een evenement wordt aangemaakt, hoe het ook is gemaakt (wizard, kopie, terugkerende reeks). |
event.updated | De gegevens van een evenement veranderen: titel, beschrijving, afbeelding, data, locatie of adres, online link, verkoopperiode of zichtbaarheid. changed somt de velden op. Een statuswijziging is geen update; die heeft eigen gebeurtenissen. |
event.published | Een evenement gaat live. |
event.cancelled | U annuleert een evenement. |
ticket.checked_in | Een ticket wordt toegelaten bij de deur: gescand, handmatig ingevoerd, in bulk ingecheckt, uit een offline scanner gesynchroniseerd, of verkocht en toegelaten aan de kassa. Het uitchecken van een ticket en het markeren van een no-show verzenden niets, en ook de actie Inchecken in bulk op de bestellingenlijst niet; die markeert hele bestellingen als aangekomen zonder scan aan de deur. |
staff.assigned | Iemand wordt personeel bij een evenement: u keurt hun aanvraag goed, of zij accepteren een uitnodiging voor dat evenement. |
staff.checked_in | Een personeelslid meldt zich aan voor een dienst. |
vendor.assigned | U wijst een leverancier toe aan een evenement. |
vendor.invoice_submitted | Een leverancier dient een factuur in voor een opdracht. |
Er zijn geen uitbetalingsgebeurtenissen. Stripe betaalt uw ticketverkoop rechtstreeks op uw eigen rekening uit, en EventMann maakt die uitbetalingen niet aan en ziet ze ook niet.
Hoe een levering eruitziet
Elke levering is een POST met een JSON-body in deze vorm: event (de naam), data (de gegevens), timestamp en delivery_id. De gegevens voor booking.confirmed bevatten het bestel-id, de referentie, de status, het totaalbedrag, de naam en het e-mailadres van de koper, het evenement-id en het tijdstip van bevestiging. booking.created voegt de titel van het evenement toe en bevat in plaats daarvan het tijdstip van aanmaak. payment.received bevat boeking-id, bedrag, gateway, transactie-id en tijdstip.
Het verzoek bevat drie headers: X-Webhook-Event, X-Webhook-Delivery-Id en X-Webhook-Signature. De handtekening is een HMAC-SHA256 van de ruwe requestbody in hexadecimale vorm, versleuteld met het ondertekeningsgeheim van uw eindpunt. Bereken haar zelf opnieuw uit de ruwe body en vergelijk die voordat u een payload vertrouwt.
Een eindpunt controleren
- Klik op Test verzenden om een voorbeeld-
pingnaar uw adres te sturen en het resultaat meteen te zien. - Geabonneerde gebeurtenissen toont wat het eindpunt ontvangt. Gebruik Bewerken om naam, adres of gebeurtenissen te wijzigen.
- Het Ondertekeningsgeheim is verborgen; klik op Tonen om het zichtbaar te maken.
- Recente bezorgingen toont de laatste pogingen met gebeurtenis, status, HTTP-code, duur en tijd. Alles bekijken toont meer.
Nieuwe pogingen, storingen en automatisch uitschakelen
- Alleen een 2xx-antwoord telt als geleverd. Een omleiding of een ander antwoord is een storing; omleidingen worden niet gevolgd.
- Een mislukte levering wordt maximaal vijf keer opnieuw geprobeerd, met wachttijden van 10, 30 en daarna 60 seconden tussen de pogingen.
- Wanneer alle pogingen voor één gebeurtenis mislukken, gaat het storingsaantal van het eindpunt met één omhoog. Tien storingen binnen een uur pauzeren de levering naar dat eindpunt vijf minuten; leveringen wachten die pauze uit.
- Wordt de pauze geactiveerd, of gaat het storingsaantal boven tien, dan wordt het eindpunt uitgeschakeld en ontvangt u een melding met de naam ervan.
- Een adres dat naar een privé- of intern netwerk verwijst, wordt geweigerd op het moment dat er een levering wordt geprobeerd. De test toont „Geblokkeerd”, en een echte levering schakelt het eindpunt uit.
- De leveringsgeschiedenis wordt 30 dagen bewaard.
- Een uitgeschakeld eindpunt toont Dit eindpunt is uitgeschakeld met de reden.
- Los op wat er bij uw ontvanger fout was en klik daarna op Opnieuw inschakelen. Het storingsaantal wordt gewist; het adres en het geheim blijven gelijk. Het wijzigen van de naam of het adres schakelt het eindpunt niet opnieuw in.
- Opnieuw bij een mislukte levering verzendt die gebeurtenis opnieuw als nieuwe levering naar uw momenteel actieve eindpunten die haar abonneren. Dat omvat uw andere eindpunten, dus zij kunnen haar dubbel ontvangen.
Goed om te weten
- Het verzenden van webhooks loopt in een eigen wachtrij, zodat een trage ontvanger boekingen of ticket-e-mails niet kan vertragen.
- Een gebeurtenis uitvinken stopt die stilzwijgend. U krijgt geen melding dat u haar niet meer ontvangt.
- Als u een tool zoals Zapier koppelt met een EventMann-API-token, verschijnen de abonnementen die die tool aanmaakt hier ook, genoemd naar de gebeurtenis.
- Webhooks sturen de naam en het e-mailadres van de koper van elke bestelling naar uw server. Zorg dat het adres van u is en dat u die gegevens mag verwerken.
Problemen oplossen
- Leveringen zijn gestopt en ik zie geen fout — open het eindpunt. Is het uitgeschakeld, los dan het probleem bij de ontvanger op en klik op Opnieuw inschakelen.
- De handtekening klopt nooit — hash de exacte ruwe body, niet een opnieuw gecodeerde kopie, met het geheim van de eindpuntpagina, en vergelijk hexadecimale tekst.
- De test werkt maar echte gebeurtenissen komen niet aan — controleer of de gebeurtenis bij dit eindpunt is aangevinkt, en of wat er gebeurde overeenkomt met de kolom „Verzonden wanneer” in de tabel.
- Ik krijg dezelfde gebeurtenis twee keer — u drukte op Opnieuw, of u hebt twee eindpunten die haar abonneren. Gebruik het levering-id om herhalingen te negeren.