Webhook
Ook wel web callback
Wat is een webhook?
Webhook (ook wel web callback) is een automatisch bericht dat een systeem naar een ander systeem stuurt zodra er iets gebeurt, zoals een nieuwe bestelling of een ingevuld formulier. Je hoeft dus niet steeds te vragen of er nieuws is.
Veelgestelde vragen over webhook
Wat is het verschil tussen een webhook en een API?
Bij een API vraag jij zelf data op wanneer je dat wilt. Bij een webhook stuurt het andere systeem de data automatisch naar jou zodra er iets gebeurt.
- API: jij vraagt, het systeem antwoordt.
- Webhook: het systeem meldt zich uit zichzelf.
- Timing: een webhook werkt vrijwel direct, een API-aanvraag doe je op een moment dat jij kiest.
- Belasting: bij een webhook hoef je niet steeds te controleren of er iets nieuws is.
Tip: in de praktijk gebruik je vaak allebei. De webhook meldt dat er iets is, en via de API haal je zo nodig extra details op.
Hoe werkt een webhook?
Een webhook werkt als een melding: er gebeurt iets in systeem A en systeem A stuurt direct een bericht naar een adres van systeem B.
- Gebeurtenis: bijvoorbeeld een nieuwe bestelling of een aangemelde lead.
- URL: je geeft vooraf het webadres op waar het bericht naartoe moet.
- Bericht: er wordt een pakketje data verstuurd, meestal in JSON-formaat.
- Reactie: het ontvangende systeem bevestigt dat het bericht is aangekomen en verwerkt het.
Tip: je hoeft zelf geen code te schrijven als je een tool zoals Zapier, Make of n8n als ontvanger gebruikt.
Waar gebruik je webhooks voor in online marketing?
Webhooks verbinden je marketingtools met elkaar, zodat data automatisch meebeweegt.
- Leads: een ingevuld formulier komt direct in je CRM terecht.
- E-mail: een bestelling start automatisch een e-mailflow.
- Meldingen: je team krijgt direct een bericht in Slack of Teams bij een nieuwe aanvraag.
- Betalingen: een betaalbevestiging werkt de orderstatus bij.
Tip: begin met één proces dat je nu handmatig doet en automatiseer dat eerst.
Is een webhook veilig?
Een webhook is veilig als je hem goed instelt. Omdat het een openbaar webadres is, moet je controleren of berichten echt van de juiste afzender komen.
- HTTPS: gebruik altijd een beveiligde verbinding.
- Geheime sleutel: veel platforms ondertekenen berichten, zodat je de afzender kunt controleren.
- Beperkte data: stuur alleen door wat echt nodig is.
- Persoonsgegevens: let op de AVG als je klantgegevens doorstuurt.
Tip: houd de webhook-URL privé en deel hem niet in openbare documenten.
Wat doe je als een webhook niet werkt?
Meestal ligt het probleem bij de URL, de beveiliging of de verwerking aan de kant van de ontvanger. Je kunt stap voor stap controleren waar het misgaat.
- URL: controleer of het adres exact klopt en bereikbaar is.
- Logboek: veel tools tonen verstuurde webhooks met de statuscode van het antwoord.
- Testbericht: verstuur een proefbericht naar een testtool om te zien wat er binnenkomt.
- Foutmelding: een 4xx- of 5xx-code wijst op een fout bij de ontvanger.
Tip: veel platformen proberen een mislukte webhook later nogmaals te versturen, maar niet voor altijd. Los fouten dus snel op.
