Webhooks instellen

Webhooks versturen geselecteerde TicketingHub-gebeurtenissen naar een ander systeem zodra deze plaatsvinden.

Voordat u begint

• Webhooks moeten zijn ingeschakeld voor uw TicketingHub-account. Neem contact op met TicketingHub als het gedeelte Webhooks ontbreekt.
• U hebt beheerders- of managerrechten nodig.
• Het ontvangende systeem moet een openbare HTTPS-URL beschikbaar stellen.

Een webhook toevoegen

1. Ga naar Instellingen → Geavanceerd.
2. Zoek Webhooks en selecteer Bewerken.
3. Selecteer Nieuwe webhook.
4. Voer de HTTPS-URL in die de gebeurtenissen ontvangt.
5. Selecteer de gebeurtenistypen die u wilt verzenden, zoals een bevestigde of geannuleerde boeking.
6. Optioneel: voer een sterk geheim in, zodat het ontvangende systeem elk verzoek kan verifiëren.
7. Maak de webhook aan en voer vervolgens een van de geselecteerde gebeurtenissen uit om deze te testen.

Als u een geheim toevoegt, ondertekent TicketingHub elk verzoek en verstuurt het de handtekening in de header X-TicketingHub-Signature-256. Uw ontwikkelaar moet deze handtekening verifiëren voordat de gegevens worden geaccepteerd.

De webhook actief houden

Het ontvangende systeem moet snel reageren met een geslaagde 2xx-status. TicketingHub probeert leveringen opnieuw die een time-out veroorzaken of een niet-geslaagde respons retourneren. Een endpoint dat blijft mislukken, wordt automatisch uitgeschakeld. Los het probleem in het ontvangende systeem op en ga vervolgens terug naar de pagina Webhooks om de webhook opnieuw in te schakelen.

TicketingHub stuurt alleen gebeurtenissen naar openbare adressen. Als de URL verwijst naar een privénetwerkadres, zoals een server binnen uw eigen netwerk, stuurt TicketingHub de gebeurtenis niet en wordt de webhook onmiddellijk uitgeschakeld. Op de pagina Webhooks wordt “De URL verwijst naar een privénetwerkadres” weergegeven en de beheerders van uw account ontvangen een e-mail. Wijzig de URL in een openbaar HTTPS-adres en schakel de webhook vervolgens opnieuw in.

Kies alleen de gebeurtenissen die u nodig hebt en vermijd het gebruik van een test-URL in een liveaccount. Zie TicketingHub verbinden met Zapier als u gebeurtenissen naar Zapier wilt verzenden zonder zelf een ontvanger te bouwen. Zie Een API-token maken en gebruiken als u een integratie wilt bouwen die ook gegevens uit TicketingHub opvraagt.