Een webhook is het eenvoudigste stuk automatisering dat er bestaat, en tegelijk het woord dat het vaakst voor een glazige blik zorgt. Het idee past in één zin: in plaats van steeds vragen of er nieuws is, laat je het systeem bellen zodra er nieuws is.
Wat is een webhook in gewone taal?
Stel dat je een pakket verwacht. Je kunt elk kwartier de trackingpagina verversen — dat is hoe een API gebruikt wordt: jij vraagt, zij antwoorden, telkens opnieuw.
Of je zet een melding aan en krijgt een bericht zodra de bezorger onderweg is. Dat is een webhook: het systeem waar iets gebeurt, stuurt uit zichzelf een berichtje naar een adres dat jij hebt opgegeven.
Technisch is het niet meer dan dat. Jij geeft een webadres door, het andere systeem stuurt daar een klein pakketje gegevens naartoe zodra er iets gebeurt waar jij in geïnteresseerd bent. Jouw kant leest het en doet er iets mee.
| API | Webhook | |
|---|---|---|
| Wie begint | Jij, telkens opnieuw | Het andere systeem, als er nieuws is |
| Wanneer | Op jouw moment | Op het moment dat het gebeurt |
| Belasting | Veel verzoeken, meestal zonder nieuws | Alleen verkeer als er iets is |
| Goed voor | Gegevens opzoeken als je ze nodig hebt | Reageren op gebeurtenissen |
Waar gebruik je een webhook voor?
Overal waar iets moet gebeuren nadat er iets gebeurd is:
- Betaling binnen bij je betaaldienstverlener, dus: factuur op betaald zetten en bevestiging mailen.
- Nieuwe bestelling in je webshop, dus: pakbon maken en voorraad bijwerken.
- Formulier ingevuld op je site, dus: aanvraag in je CRM en melding naar de juiste collega.
- Afspraak geannuleerd in je agenda, dus: plek vrijgeven en wachtlijst benaderen.
- Gesprek afgerond in je chatbot, dus: samenvatting in je CRM bij de juiste klant.
Dat laatste voorbeeld is de reden dat webhooks opduiken in elk gesprek over AI-chatbots. Een bot die een aanvraag kwalificeert, is pas nuttig als die aanvraag ergens terechtkomt waar iemand hem ziet. De webhook is het stukje dat dat regelt; zie ook AI-chatbot koppelen aan je CRM.
Wat gaat er mis bij webhooks?
Vier klassiekers, in volgorde van hoe vaak ze voorkomen.
Het bericht komt aan maar wordt niet verwerkt. Jouw kant lag er even uit. Een goed ingerichte afzender probeert het daarna opnieuw; een slecht ingerichte stuurt één keer en vergeet het. Vraag altijd of er opnieuw geprobeerd wordt en hoe vaak.
Hetzelfde bericht komt twee keer. Bij opnieuw proberen gebeurt dat gewoon. Je verwerking moet daartegen kunnen: twee keer hetzelfde bericht mag niet twee facturen opleveren. Dit heet onder bouwers "idempotent" en het is het belangrijkste detail van het hele onderwerp.
Iedereen kan dat adres aanroepen. Een webhookadres zonder controle is een deur zonder slot. Serieuze afzenders ondertekenen hun berichten met een geheime sleutel die jij controleert. Zet dat aan.
Niemand merkt dat het gestopt is. Dit is de stilste fout: geen foutmelding, gewoon geen berichten meer. Spreek af dat iemand het ziet als er een dag niets binnenkomt.
Dat laatste hoort bij de bredere beveiligingshygiëne rond koppelingen; het Digital Trust Center van de Rijksoverheid heeft daar praktische richtlijnen over voor ondernemers.
Webhook, API of connector: wat kies je?
Een simpele vuistregel:
- Je wil iets opzoeken op het moment dat je het nodig hebt → API. Bijvoorbeeld een chatbot die de status van een order opvraagt tijdens het gesprek.
- Je wil reageren zodra er iets gebeurt → webhook. Bijvoorbeeld een aanvraag die direct in je CRM moet staan.
- Je wil beide, zonder te bouwen → connector of koppelplatform. Dat gebruikt onder water allebei.
In de praktijk combineer je ze. Een chatbot vraagt tijdens een gesprek via de API een levertijd op, en stuurt na afloop via een webhook een samenvatting naar je CRM. Hoe zo'n keten in elkaar zit staat in AI-integraties maken, en als je het laat inrichten bij AI-chatbot installeren.
Veelgestelde vragen
Veelgestelde vragen over wat is een webhook
Wat is het verschil tussen een API en een webhook?
Bij een API vraag jij om gegevens wanneer het jou uitkomt; bij een webhook stuurt het andere systeem uit zichzelf een bericht zodra er iets gebeurt. API is opvragen, webhook is gebeld worden. Veel koppelingen gebruiken allebei: een webhook om te horen dat er iets veranderd is, en een API om de details op te halen.
Heb ik technische kennis nodig om een webhook in te stellen?
Voor het aanzetten niet: in de meeste pakketten vul je een adres in en vink je aan bij welke gebeurtenissen je bericht wil. Je hebt wel iemand nodig voor de ontvangende kant, tenzij je een koppelplatform gebruikt dat dat adres voor je klaarzet. Dat laatste is voor de meeste kleine bedrijven de praktische route.
Zijn webhooks veilig?
Alleen als je het inricht. Gebruik altijd een versleutelde verbinding, zet de ondertekening met een geheime sleutel aan zodat je kunt controleren dat een bericht echt van de afzender komt, en gebruik een adres dat niet te raden is. Zonder die controle kan iedereen die het adres kent, nepberichten sturen.
Wat gebeurt er als mijn systeem het bericht mist?
Dat hangt van de afzender af. Goede diensten proberen het opnieuw, vaak met toenemende tussenpozen gedurende een dag. Andere sturen één keer en de rest is jouw probleem. Vraag dit na voordat je op webhooks gaat leunen voor iets belangrijks zoals betalingen, en zorg dat je opnieuw kunt opvragen wat je gemist hebt.
Kan hetzelfde webhookbericht twee keer binnenkomen?
Ja, en daar moet je verwerking tegen kunnen. Bij opnieuw proberen na een storing komt een bericht gewoon nogmaals binnen. Elk bericht heeft meestal een uniek kenmerk; sla dat op en negeer een kenmerk dat je al verwerkt hebt. Anders krijg je dubbele facturen of dubbele aanvragen.
Kost een webhook geld?
De techniek zelf meestal niet; het aanzetten van webhooks is bij de meeste pakketten inbegrepen. Kosten ontstaan aan de ontvangende kant: een koppelplatform rekent vaak per verwerkt bericht, en een eigen ontvangstpunt kost hostingkosten en onderhoud. Bij lage volumes blijft dat beperkt tot enkele euro's per maand.
