In gewone taal
Webhook binnen een werkend bedrijfsproces
Een webhook werkt als een digitale melding: ‘deze factuur is zojuist betaald’. Het bronsysteem stuurt direct een klein bericht naar het ontvangende systeem. Dat is efficiënter dan iedere paar minuten alle facturen opvragen, maar alleen wanneer duidelijk is hoe afzender, gebeurtenis en verwerking worden gecontroleerd.
Hoe werkt het?
Gebeurtenis ontstaat
Het bronsysteem registreert bijvoorbeeld dat een betaling is bevestigd of een dossierstatus is gewijzigd.
Melding verzenden
Het systeem stuurt een HTTPS-bericht met gebeurtenistype, identificatie en minimale relevante gegevens naar een vooraf geregistreerd endpoint.
Afzender en inhoud controleren
De ontvanger verifieert een handtekening of geheim, controleert formaat en voorkomt dat hetzelfde event twee keer effect heeft.
Bevestigen en verwerken
De ontvanger antwoordt snel en verwerkt de zakelijke actie betrouwbaar, eventueel via een wachtrij. Bij tijdelijke fouten volgt een gecontroleerde retry.
Illustratief praktijkvoorbeeld
Boekhoudsysteem meldt een betaalde factuur
- Situatie
- Een zakelijke dienstverlener controleert meerdere keren per dag handmatig of openstaande facturen in het boekhoudsysteem zijn betaald.
- Aanpak
- Na betaalbevestiging stuurt het boekhoudsysteem een ondertekende webhook met event-ID en factuurreferentie. De backend controleert de melding, haalt zo nodig actuele details via de API op en werkt de interne status bij.
- Beoogde uitkomst
- De opvolging kan korter na betaling starten. Dubbele meldingen veranderen de status niet opnieuw en mislukte verwerkingen blijven zichtbaar voor herstel.
Wat betekent dit voor uw bedrijf?
Een webhook kan wachttijd en periodieke controles verminderen. De bedrijfswaarde ontstaat pas wanneer de melding onderdeel is van een beheerste integratie met duidelijke foutafhandeling.
Snellere opvolging
Vervolgacties kunnen kort na de gebeurtenis starten zonder een medewerker of periodieke taak die steeds opnieuw controleert.
Minder verkeer
Het ontvangende systeem vraagt niet voortdurend grote lijsten op wanneer er meestal niets is veranderd.
Benodigde data
Event-ID, type, tijd en bronreferentie zijn nodig om een melding te controleren en herhaalbaar te verwerken.
Beheer
Monitoring, foutwachtrij, geheimrotatie en afspraken over retries en bewaartermijnen horen bij de integratie.
Wanneer is webhook interessant?
Wanneer is het minder geschikt?
Realistische voordelen
Risico’s en aandachtspunten
Verschil met verwante begrippen
Een API wordt vaak actief aangeroepen om gegevens op te vragen of acties uit te voeren. Een webhook meldt uit zichzelf dat een gebeurtenis heeft plaatsgevonden; beide worden vaak gecombineerd.
SysteemintegratieEen webhook is één communicatiepatroon. Systeemintegratie omvat daarnaast gegevensmapping, beveiliging, foutafhandeling, monitoring en eigenaarschap.
Veelgestelde vragen
Wat is het verschil tussen een webhook en een API?
Een API wordt meestal door de afnemer aangeroepen. Een webhook wordt door de bron verstuurd zodra iets gebeurt. Vaak meldt de webhook alleen de wijziging en haalt de ontvanger details via de API op.
Wat gebeurt er wanneer een webhook niet aankomt?
De verzender kan retries uitvoeren. De ontvanger moet fouten monitoren en periodiek met de bron kunnen vergelijken om definitief gemiste gebeurtenissen te ontdekken.
Kunnen dubbele webhookmeldingen ontstaan?
Ja, bijvoorbeeld wanneer een bevestiging te laat is. Gebruik een uniek event-ID en idempotente verwerking zodat hetzelfde event niet twee keer dezelfde zakelijke actie uitvoert.
Hoe wordt een webhook beveiligd?
Gebruik HTTPS, verifieer een cryptografische handtekening of gedeeld geheim, beperk herhaling in tijd en valideer inhoud. Een geheim in alleen de URL is meestal onvoldoende.
Vragen voor een praktische vervolgstap
- 01Welke gebeurtenis moet welke concrete vervolgstap starten?
- 02Hoe worden authenticatie, dubbele events en gemiste meldingen afgehandeld?
- 03Wie ontvangt een signaal wanneer verwerking na retries blijft mislukken?