Kennisbank · Begrip

Webhook: een berichtje zodra er iets gebeurt

Een webhook is een URL waarnaar een extern systeem automatisch een bericht stuurt zodra er iets gebeurt, bijvoorbeeld een betaling of een nieuwe lead. Het is de goedkoopste manier om systemen realtime te koppelen.

Door , Content Strategist & GEO Editor · Laatst bijgewerkt:

Belangrijkste punten

  • Het externe systeem belt jou, in plaats van dat jij blijft pollen.
  • Verifieer altijd de handtekening voordat je de payload verwerkt.
  • Antwoord snel met 200 en verwerk zwaar werk daarna asynchroon.
  • Maak de verwerking idempotent: dezelfde melding kan twee keer komen.

Hoe een webhook werkt

Je geeft een externe dienst een URL op. Zodra daar een gebeurtenis plaatsvindt — betaling geslaagd, formulier ingevuld, order verzonden — stuurt die dienst een HTTP-verzoek naar jouw URL met de details. Jij verwerkt dat verzoek en antwoordt met een statuscode.

Verschil met een API-call

Bij een API-call vraag jij om informatie en wacht je op antwoord. Bij een webhook gebeurt het omgekeerde: het andere systeem informeert jou. Dat scheelt duizenden nutteloze verzoeken en levert vrijwel realtime updates op.

Beveiliging is niet optioneel

Een webhook-URL is openbaar bereikbaar. Verifieer daarom de meegestuurde handtekening met een gedeeld geheim, valideer de payload met een schema en voer nooit een schrijfactie uit voordat die controle geslaagd is.

Typische koppelingen

Betalingen naar je administratie, leads naar je CRM, formulierinzendingen naar Slack of e-mail, voorraadmutaties naar je webshop en AI-verwerkingen die na afloop een resultaat terugsturen.

Veelgestelde vragen

Wat als mijn endpoint even offline is?+

De meeste diensten proberen het opnieuw met oplopende tussenpozen; log daarom elke ontvangen melding.

Waarom moet verwerking idempotent zijn?+

Omdat een herhaalde levering anders dubbele orders of dubbele mails oplevert.

Hoe test ik een webhook lokaal?+

Met een tunnel naar je ontwikkelomgeving of door de payload handmatig na te bootsen in een test.

Is een webhook hetzelfde als een callback-URL?+

In de praktijk wordt die term door veel diensten door elkaar gebruikt, ja.

Verder lezen

Gerelateerde artikelen

Alles in de kennisbank →

Alles over dit thema op één plek: hub AI-strategie

Ready?

Klaar om gespot te worden?

Plan een gratis kennismaking van 30 minuten. We kijken mee naar je huidige vindbaarheid en vertellen eerlijk wat we zouden doen — wel of geen samenwerking.

Stuur ons een bericht