Vragen of laten melden
Er zijn twee manieren om te weten of er iets nieuws is in een ander programma. Je kunt steeds vragen: is er al een nieuwe bestelling? Een koppeling kan dat bijvoorbeeld elk uur doen. De andere manier is dat het programma zelf aanbelt zodra er iets gebeurt. Dat is een webhook: een bericht dat naar een vooraf ingesteld webadres wordt gestuurd, met de gegevens van wat er net is gebeurd. Het werkt als een deurbel. Je hoeft niet elke tien minuten naar de voordeur te lopen om te zien of er iemand staat.
Hoe stel je het in?
Bij de afzender, bijvoorbeeld je webshop, boekingssysteem of betaaldienst, vul je in naar welk webadres het bericht moet en bij welke gebeurtenissen: nieuwe order, geslaagde betaling, verstuurd formulier. Aan de andere kant staat iets dat op dat adres luistert en met het bericht aan de slag gaat. Dat kan een eigen programma zijn, of een dienst als Zapier of n8n. Zo kan een betaling die slaagt direct een bevestiging versturen of een regel in je planning zetten.
Wat kan er misgaan?
Een webhook is sneller dan elk uur vragen, maar ook kwetsbaarder. Is de ontvanger op het moment van het bericht niet bereikbaar, dan kan het bericht verloren gaan. Berichten kunnen ook twee keer aankomen of in een andere volgorde. Een goede ontvanger slaat een bericht daarom eerst op en verwerkt het daarna, en herkent dubbele berichten. Zo bouw ik koppelingen ook: eerst opslaan, dan doorsturen, en dezelfde order maar één keer verwerken.
Let ook op de afzender. Iedereen die het webadres kent, kan er een bericht naartoe sturen. Veel diensten sturen daarom een handtekening mee waarmee de ontvanger kan controleren of het bericht echt van hen komt. Gebruik dat als het kan.
Wanneer kies je een webhook?
Als snelheid ertoe doet. Een klant verwacht binnen een minuut een bevestiging, of een betaling moet meteen een bestelling vrijgeven. Is eens per uur genoeg, dan is vragen op vaste tijden vaak de rustigere keuze, want dat is eenvoudiger en stabieler te bouwen. Een veelgebruikte combinatie is een webhook voor de snelheid en een controle een paar keer per dag als vangnet voor wat is gemist.
Het webhookbericht is zelf meestal klein. De details haal je daarna op via de API van de afzender. Hoe zo’n geheel in elkaar zit, lees je bij API-koppeling en in wat is een API-koppeling. Wat ik aan koppelingen bouw staat op koppelingen tussen systemen.

