Naar hoofdinhoud
Terug naar E-commerce Woordenboek

Webhooks

ProcesbeheerIntermediate niveau

Een webhook is een automatisch HTTP-bericht dat een app naar een door jou gekozen URL stuurt bij een gebeurtenis, zoals een nieuwe bestelling of voorraadwijziging.

Image by · CC BY 4.0

Wat is Webhooks?

Een webhook is een automatisch HTTP-bericht dat een applicatie naar een door jou gekozen URL stuurt zodra er iets gebeurt, zoals een nieuwe bestelling, een voorraadwijziging of een productupdate. Je systeem hoeft niet steeds te vragen of er iets veranderd is; het andere systeem meldt het zelf. Het bericht bevat meestal een JSON-payload met het type gebeurtenis en de gewijzigde gegevens, plus een handtekening waarmee de ontvanger controleert of het echt is. Het verschil met een API-aanroep is de richting: met een API vraag je zelf data op wanneer jij wilt, met een webhook krijg je bericht als er iets verandert. In webshops starten webhooks vaak de orderverwerking, een feedupdate of het verversen van een cache. Voor productdata die op een schema in plaats van per gebeurtenis beweegt, zie automations.

Waarom Webhooks belangrijk is voor e-commerce

Een webshop hangt af van veel systemen die over dezelfde gebeurtenissen moeten horen: de shop, het magazijn, de boekhouding, e-mail en marktplaatsen. Met webhooks reageert elk systeem op een bestelling, terugbetaling of voorraadwijziging zonder elke paar minuten te hoeven vragen. Dat scheelt belasting en vertraging, zolang de ontvangende kant goed omgaat met herhalingen, dubbele berichten en mislukte leveringen.

Voorbeelden van Webhooks

  • 1Gebeurtenis: orders/create, Afzender: Shopify, Ontvanger: Magazijnsysteem start met orderpicken
  • 2Gebeurtenis: Voorraad op nul, Afzender: ERP, Ontvanger: Webshop verbergt de bestelknop
  • 3Gebeurtenis: Betaling terugbetaald, Afzender: Betaalprovider, Ontvanger: Boekhoudpakket boekt een creditnota
  • 4Gebeurtenis: Product gewijzigd, Afzender: Webshop, Ontvanger: Zoekindex ververst het product

Hoe WISEPIM helpt

  • Met de optionele auto-sync gaat een opgeslagen product ongeveer 30 seconden later naar gekoppelde platforms.
  • Auto-sync werkt met Magento 2, Shopify, WooCommerce, Lightspeed eCom, Ecwid, CCV Shop, Kaufland, PrestaShop, ShopWired en Google Merchant Center.
  • Geplande imports en exports draaien via automations met triggers per uur, dag, week of maand.
  • Via de publieke API (Pro-abonnement) lezen en wijzigen je eigen systemen productdata.

Veelgemaakte fouten met Webhooks

  • De handtekening niet controleren, waardoor iedereen nepberichten naar je endpoint kan sturen.
  • Eerst traag werk doen en pas daarna antwoorden, waardoor de afzender een time-out krijgt en opnieuw stuurt.
  • Geen rekening houden met dubbele leveringen van dezelfde gebeurtenis.
  • Geen terugvaloptie hebben als webhooks een tijd niet aankomen.

Tips voor Webhooks

  • Antwoord eerst met status 200 en verwerk de gebeurtenis daarna op de achtergrond.
  • Sla het event-ID op en sla gebeurtenissen over die je al verwerkt hebt.
  • Controleer de handtekening met het geheim dat de afzender je geeft.
  • Houd mislukte leveringen in de gaten en draai een geplande sync als vangnet.

Trends rondom Webhooks

  • Platforms voegen eventfilters toe zodat je alleen de velden krijgt die je nodig hebt.
  • Eventbussen en wachtrijen staan tussen de webhook en de app voor betrouwbaarheid.
  • Standaard ondertekeningsmethoden maken controle bij verschillende aanbieders makkelijker.
  • Teams combineren webhooks met een periodieke volledige sync om gemiste gebeurtenissen op te vangen.

Tools voor Webhooks

  • Webhook.site of RequestBin om testberichten te bekijken
  • ngrok om tijdens ontwikkeling een lokaal endpoint bereikbaar te maken
  • Zapier of Make voor webhookflows zonder code
  • Wachtrijdiensten zoals AWS SQS voor betrouwbare verwerking

Gerelateerde termen

Ook bekend als

HTTP-callbackReverse APIEventmeldingWebcallback

Veelgestelde vragen

Veelgebruikte voorbeelden zijn nieuwe bestellingen naar het magazijnsysteem sturen, producten verbergen als de voorraad op nul staat, terugbetalingen in de boekhouding zetten en de zoekindex verversen als een product verandert. Elk voorbeeld start met een gebeurtenis in de shop of een ander systeem.

Met een API vraagt je systeem zelf om data wanneer het dat wil. Bij een webhook stuurt het andere systeem data naar jouw URL zodra er iets gebeurt, dus je hoeft niet steeds te vragen.

Gebruik HTTPS, controleer bij elk bericht de handtekening met het gedeelde geheim en weiger verzoeken die niet kloppen. Beperk ook wat het endpoint mag doen en log elke gebeurtenis die binnenkomt.

De meeste afzenders proberen het een paar keer opnieuw. Plan daarnaast een periodieke sync die gemiste wijzigingen alsnog ophaalt.

Nog vragen?

Kan je het antwoord niet vinden? Neem contact op met ons team.

Contact opnemen

Verder ontdekken

Zorgvuldig gekozen vervolgstappen om dieper te gaan.