Webhooks: meteen weten dat er een ticket verkocht is

Stel: je wil dat de teller op je eigen website meteen verspringt wanneer er een ticket verkocht is. Er zijn twee manieren om dat voor elkaar te krijgen, en één ervan is een stuk beter.

Dit artikel legt uit wat een webhook is en of je er een nodig hebt. Hoe je er een instelt, knop voor knop, staat in Webhooks instellen.

De omgekeerde wereld

Zonder webhook moet je website het blijven vragen. Elke minuut, de hele dag: "is er al iets verkocht?" Meestal is het antwoord nee. Op een dag zijn dat veertienhonderd vragen om drie keer ja te horen — en tussen twee vragen in klopt je teller niet.

Met een webhook draai je dat om. Je geeft ons één adres van je eigen site, en zodra er iets gebeurt, sturen wij daar een berichtje naartoe. Eén bericht, op het moment zelf.

Vandaar de naam: een hook is een haakje waar wij iets aan hangen zodra het zover is.

Wat je ermee kan doen

• de teller op je website laten verspringen zodra er verkocht is;
• een bericht in je teamchat krijgen bij elke bestelling boven een bedrag;
• je ledenlijst bijwerken wanneer iemand een jaarkaart koopt;
• een mail naar jezelf wanneer een bestelling geannuleerd wordt;
• je kassa of boekhouding meteen laten weten dat er geld binnen is.

Wat je nodig hebt

Drie dingen, en je webbouwer kent ze alle drie:

1. Een adres op je eigen site dat berichten kan ontvangen. Dat is een gewone pagina die niemand bezoekt; hij staat er alleen om ons bericht aan te nemen. Het moet met https:// beginnen.
2. Een plek om dat adres in te vullen. Dat doe je zelf, in Instellingen → API-toegang, op het tabblad Webhooks — zie Webhooks instellen. Wil je webbouwer het liever vanuit zijn eigen programma regelen, dan heeft hij een sleutel met het recht Webhooks nodig; zie Een API-sleutel aanmaken.
3. Het geheim dat bij dat adres hoort. Dat krijg je van ons zodra het adres ingesteld is, en daarmee rekent je site na dat een bericht echt van ons komt.

Die derde is belangrijk. Zonder controle op het geheim kan iedereen die je adres raadt, jouw website wijsmaken dat er iets verkocht is. Met die controle niet.

Hoe het eruitziet

Er komt een berichtje binnen dat zegt wat er gebeurd is en waarover. Je site kijkt naar het geheim, ziet dat het klopt, en doet er dan iets mee: een teller ophogen, een regel wegschrijven, een mail sturen.

Wat er precies in zo'n bericht staat, en hoe je de controle op het geheim programmeert, staat in het developersportaal — dat is de pagina die je doorstuurt naar wie het bouwt.

Drie dingen die vaak misgaan

Antwoord snel. Ons bericht wacht hoogstens tien seconden op een antwoord, niet tot jouw site klaar is met al haar rekenwerk. Neem het bericht aan, zeg dat het aangekomen is, en doe het werk daarna.

Reken op herhalingen. Was je site even onbereikbaar, dan proberen wij het opnieuw — tot zes keer, verspreid over ruim anderhalve dag. Het kan dus gebeuren dat hetzelfde bericht twee keer aankomt. Zorg dat je site daar tegen kan — twee keer hetzelfde bericht hoort niet twee keer dezelfde mail op te leveren.

Houd het geheim geheim. Het hoort in de instellingen van je server te staan, niet in code die op je website terechtkomt.

Moet je dit hebben?

Nee. Een webhook is handig wanneer iets meteen moet gebeuren. Is een dagelijks overzicht genoeg, dan heb je er geen nodig — dan volstaat het om één keer per dag de cijfers op te halen.

Webhooks horen bij dezelfde formule als de rest van de API. Wat er in welke formule zit, staat op de prijzenpagina van Passavo.

Verder lezen

• Webhooks instellen — het scherm zelf: een adres toevoegen, een proefbericht sturen, het berichtenlog lezen.
• Wat is een API, en heb ik dat nodig?
• Een API-sleutel aanmaken
• Het developersportaal — voor wie de koppeling bouwt.