Wat is een webhook?

Een webhook zorgt ervoor dat het ene systeem automatisch informatie naar een ander systeem stuurt zodra er een bepaalde gebeurtenis plaatsvindt.

Denk bijvoorbeeld aan:

• een nieuwe bestelling;

• een ingevuld formulier;

• een nieuwe aanvraag;

• een gewijzigde status;

• een afgeronde betaling.

Zo kunnen verschillende systemen automatisch op elkaar reageren.

Hoe werkt een webhook?

Stel dat iemand een bestelling plaatst in een webshop.

Zodra de bestelling binnenkomt, kan de webshop via een webhook direct een bericht naar een ander systeem sturen.

Dat andere systeem weet dan bijvoorbeeld:

Er is een nieuwe bestelling. Dit zijn de bijbehorende gegevens.

Vervolgens kan daar automatisch een volgende actie worden uitgevoerd.

Wat is het verschil tussen een API en een webhook?

Een API en webhook kunnen allebei worden gebruikt om systemen met elkaar te laten communiceren, maar de werking is anders.

Bij een API vraagt een systeem vaak zelf gegevens op bij een ander systeem.

Bij een webhook wordt automatisch een bericht verstuurd zodra een bepaalde gebeurtenis plaatsvindt.

Je kunt het simpel zien als:

API: “Is er nieuwe informatie?”
Webhook: “Er is nieuwe informatie. Hier komt het.”

In de praktijk kunnen API’s en webhooks ook samen worden gebruikt binnen één koppeling.

Is een webhook altijd mogelijk?

Nee. Het externe systeem moet webhooks ondersteunen en beschikbaar stellen voor de gebeurtenis die je wilt gebruiken.

De leverancier bepaalt bijvoorbeeld:

• welke gebeurtenissen beschikbaar zijn;

• welke gegevens worden meegestuurd;

• hoe de webhook technisch beveiligd wordt.

Daarom bekijken we eerst de technische documentatie van het betreffende systeem.

Goed om te weten

Een webhook kan belangrijk zijn voor automatische processen. Wijzig daarom niet zomaar webhook-URL’s, beveiligingsinstellingen of andere technische gegevens van een bestaande koppeling.

Een verkeerde wijziging kan ervoor zorgen dat informatie niet meer bij het andere systeem aankomt.

Wil je een webhook gebruiken voor een koppeling?

Stuur ons dan:

• de naam van het externe systeem;

• bij welke gebeurtenis iets automatisch moet gebeuren;

• welke gegevens moeten worden doorgestuurd;

• naar welk systeem de informatie moet;

• de technische documentatie van de leverancier;

• informatie over een eventuele testomgeving.

Wij kunnen vervolgens beoordelen of een webhook geschikt is en wat er nodig is om de koppeling te realiseren.