Wat is een webhook? Uitleg voor ondernemers

Een webhook is een automatisch seintje dat het ene systeem naar het andere stuurt zodra er iets gebeurt. Er komt een bestelling binnen, een formulier wordt ingevuld of een factuur wordt betaald, en op dat moment gaat er direct een bericht met de gegevens naar een ander systeem. Dat systeem kan er meteen iets mee doen. Hieronder lees je hoe dat werkt, waar je het tegenkomt en wat het verschil is met een API-koppeling.

Hoe werkt een webhook?

Vergelijk het met de bel van je voordeur. Zonder bel loop je om de paar minuten naar de deur om te kijken of er iemand staat. Met een bel hoef je niets te doen tot er wordt aangebeld. Een webhook is die bel.

In de praktijk gaat het zo:

1. Je geeft een adres op. In systeem A vul je een webadres in van systeem B. Dat adres heet de webhook-URL. Je kiest ook bij welke gebeurtenis het seintje moet gaan, bijvoorbeeld bij een nieuwe bestelling.

2. Er gebeurt iets. Een klant rekent af in je webshop.

3. Systeem A stuurt een bericht. Direct na de bestelling stuurt de webshop een bericht naar dat adres, met de gegevens erin: wat er is besteld, door wie en voor welk bedrag.

4. Systeem B reageert. Het ontvangende systeem verwerkt de gegevens. Het maakt bijvoorbeeld een factuur aan of zet de bestelling klaar voor verzending.

Voorbeelden uit de praktijk

Webshop naar boekhouding

Zodra een bestelling is betaald, stuurt de webshop een webhook. De ontvangende kant maakt in je boekhoudpakket een factuur aan en koppelt de betaling eraan. Je boekhouding loopt daardoor gelijk met je webshop, in plaats van een keer per dag of per week.

Formulier naar CRM

Veel formulierplugins en formuliertools kunnen bij elke inzending een webhook versturen. De aanvraag staat dan binnen enkele seconden als nieuw contact in je CRM, en je kunt er direct een melding aan je team aan hangen. Hoe sneller je reageert op een aanvraag, hoe groter de kans dat het een klant wordt. Meer daarover in leads opvolgen.

Betaling naar bestelstatus

Betaalproviders gebruiken webhooks om je webshop te laten weten dat een betaling gelukt, mislukt of terugbetaald is. Zo zet je webshop een bestelling automatisch op betaald, ook als de klant het browservenster al had gesloten. Wie Mollie aan WooCommerce koppelt, gebruikt dit al zonder het te weten. Zie Mollie koppelen aan WooCommerce.

Bestelling naar verzendlabel

Een nieuwe bestelling gaat via een webhook naar je verzendplatform, waar het label al klaarstaat. Wordt het pakket gescand, dan kan het verzendplatform op zijn beurt weer een webhook terugsturen, zodat de klant een mail krijgt dat zijn pakket onderweg is.

Wat is het verschil met een API-koppeling?

Een webhook en een API worden vaak door elkaar gehaald, maar ze werken andersom. Bij een API vraagt het ene systeem actief om gegevens: heb je nog nieuwe bestellingen? Bij een webhook wacht het ontvangende systeem tot het andere systeem uit zichzelf iets stuurt.

In de praktijk werken ze vaak samen. Een webhook meldt dat er een nieuwe bestelling is, en daarna haalt de koppeling via de API de volledige gegevens op of zet ze door naar het volgende systeem. Lees meer over hoe dat werkt in wat is een API-koppeling.

Waarom een webhook handig is

• Direct. Er zit geen vertraging tussen de gebeurtenis en de actie.

• Zuinig. Systemen hoeven niet steeds te vragen of er iets nieuws is. Dat scheelt rekenkracht en bij sommige tools ook kosten.

• Eenvoudig in te stellen. Vaak is het niet meer dan een adres plakken en een gebeurtenis kiezen.

Waar moet je op letten?

Een webhook kan mislukken. Ligt het ontvangende systeem er even uit, dan komt het bericht niet aan. Veel systemen proberen het daarna nog een paar keer, maar niet allemaal. Zorg voor een melding als iets misgaat.

Behandel het adres als geheim. Wie de webhook-URL kent, kan er berichten naartoe sturen. Deel hem niet zomaar en gebruik waar het kan een controle, zoals een geheime sleutel die het ontvangende systeem checkt.

Let op dubbele berichten. Soms komt hetzelfde bericht twee keer binnen. Een goede koppeling herkent dat, zodat je niet twee facturen voor één bestelling krijgt.

Zelf een webhook gebruiken

Je hoeft niet te programmeren om met webhooks te werken. Automatiseringstools als Zapier, Make en n8n geven je een webhook-adres dat je in je webshop of formuliertool plakt. Daarna klik je in de tool zelf in elkaar wat er met de gegevens moet gebeuren. In Zapier, Make of n8n vergelijken lees je welke tool bij jou past.

Liever laten regelen?

Wil je dat je webshop, formulieren en administratie automatisch met elkaar praten, maar heb je geen tijd om het uit te zoeken? Wij bouwen koppelingen vanaf € 750 per koppeling. Lees meer bij website laten maken of plan een kennismaking.