Hoe werkt een webhook?

Bij traditionele API-communicatie moet een applicatie steeds opnieuw vragen (pollen) of er nieuwe informatie beschikbaar is. Dit kost veel servertijd en bandbreedte. Webhooks werken juist volgens het push-principe: informatie wordt automatisch verzonden zodra er iets relevants gebeurt.

‍

De werking van een webhook in 5 stappen

Registratie: Allereerst configureer je een webhook in de verzendende applicatie (bijvoorbeeld Shopify, WooCommerce of Magento). Je geeft aan welke gebeurtenissen je wilt volgen en naar welke URL de berichten moeten worden gestuurd. Deze URL wordt de hook URL genoemd. In het geval van Server-Side Tagging verstuur je het naar je server container URL.

Trigger: Wanneer in de verzendende applicatie een gebeurtenis plaatsvindt die je hebt ingesteld als trigger (zoals een nieuwe bestelling), wordt de webhook geactiveerd.

Verzending: De applicatie stuurt automatisch een HTTP POST-verzoek naar je hook URL. Dit bericht bevat alle relevante informatie over de gebeurtenis, meestal in JSON- of XML-formaat. In het geval van Server-Side Tagging zit de webhook payload in de vorm van een JSON-bestand gevuld met eCommerce-, marketing- en userinfo.

Ontvangst en verwerking: Je server ontvangt het webhook-bericht en verwerkt de gegevens volgens de geprogrammeerde logica. Dit kan bijvoorbeeld het updaten van een database, het versturen van een e-mail of het bijwerken van statistieken zijn. In het geval van Server-Side Tagging is dit het verwerken van de ontvangen data in een purchase-gebeurtenis die doorgestuurd kan worden naar onder andere Google Analytics 4 of Meta Ads.

Bevestiging: Je server stuurt een HTTP-statuscode terug (zoals 200 OK) om aan te geven dat het bericht succesvol is ontvangen. Als de verzendende applicatie geen positieve bevestiging krijgt, kan deze proberen het bericht opnieuw te verzenden.

‍

Voor een goed werkende webhook-implementatie is het belangrijk dat je hook URL altijd bereikbaar is. Ook moet je rekening houden met de beveiliging, bijvoorbeeld door de authenticiteit van binnenkomende berichten te verifiëren met een geheime sleutel of handtekening. Webhooks bieden een krachtige manier om applicaties te laten communiceren zonder voortdurend te moeten controleren op nieuwe informatie. Door het push-mechanisme zijn ze efficiënt en zorgen ze voor real-time gegevensuitwisseling tussen verschillende systemen.

‍