Korte definitie

Webhook — een automatisch HTTP-bericht dat een systeem naar een vooraf ingesteld adres stuurt zodra een bepaalde gebeurtenis plaatsvindt.

Ook bekend als: HTTP callback, event webhook.

Een webhook laat een systeem meteen weten dat er iets veranderde. Een betaalprovider kan bijvoorbeeld melden dat een betaling bevestigd is, of een formulierdienst dat een nieuwe inzending klaarstaat.

Hoe werkt een webhook?

De verzender stuurt een bericht met gegevens over de gebeurtenis naar een endpoint van de ontvanger. De ontvanger controleert de handtekening, verwerkt het bericht en antwoordt snel. Omdat hetzelfde bericht meer dan één keer kan aankomen, moet verwerking idempotent zijn: een herhaling mag geen dubbele bestelling of taak veroorzaken.

Wat betekent dit voor een klein bedrijf?

Webhooks maken opvolging sneller en verminderen onnodige controles. Ze zijn vooral nuttig voor betalingen, formulieren, CMS-publicaties en planningswijzigingen. De ontvangende website moet meldingen idempotent verwerken; voor gebeurtenissen die nooit aankwamen is herlevering door de verzender of periodieke reconciliatie nodig. Een dashboard of log is belangrijker dan een stille koppeling.

Waar let je bij een webhook op?

  • controleer de cryptografische handtekening of het gedeelde geheim;
  • bewaar een uniek gebeurtenis-ID tegen dubbele verwerking;
  • antwoord snel en verplaats zwaar werk naar een wachtrij;
  • log mislukte verwerking zonder gevoelige gegevens te lekken;

Samenhang met andere websitekeuzes

Een webhook start vaak een workflowautomatisering. Voor aanvullende gegevens kan die workflow daarna een API raadplegen.