DigituraDigitura
Plan een gratis bedrijfsscanBel 06 27 56 83 59

Je krijgt mij aan de lijn, niet een helpdesk.

Software en koppelingen

Wat is een webhook? Uitleg met voorbeeld

Kort gezegd

Een webhook is een automatisch bericht dat een programma verstuurt zodra er iets gebeurt, bijvoorbeeld een nieuwe bestelling, zodat een ander programma er meteen op kan reageren.

Ook geschreven of gezegd als: webhooks, web hook, http callback

Door Gerwin Kuijntjes, software-engineer ·

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.

Liever dat iemand meekijkt?

Ik laat je programma's elkaar bijwerken, zodat niemand nog gegevens overtypt.

Koppelingen tussen systemen

Veelgestelde vragen

Wat is het verschil tussen een webhook en een API?

Bij een API vraag jij om gegevens, bij een webhook meldt het andere programma zich uit zichzelf. Veel koppelingen gebruiken allebei: de webhook als seintje dat er iets is, en daarna de API om de details op te halen.

Heb ik een programmeur nodig voor een webhook?

Het instellen aan de kant van de afzender is meestal een webadres invullen. Het ontvangen en verwerken vraagt een programma of een dienst. Voor een simpele automatisering kan een dienst als Zapier volstaan, bij veel regels of gevoelige gegevens is een eigen koppeling betrouwbaarder.

Wat gebeurt er als de ontvanger even niet bereikbaar is?

Dat verschilt per afzender. Sommige proberen het bericht later opnieuw, andere niet. Lees de documentatie van de afzender, en bouw de ontvanger zo dat hij een gemist bericht kan inhalen, bijvoorbeeld door een paar keer per dag te controleren.

Alle begrippen

Wil je dit laten uitzoeken?

Je kunt veel zelf nakijken. Wil je dat iemand het voor je regelt, dan doe ik dat. Na oplevering is het werk van jou.

Gratis bedrijfsscan