Webhook: een seintje op het moment dat er iets gebeurt

Er komt een aanvraag binnen via je website. Iemand kopieert de gegevens naar het boekhoudpakket. Daarna een taak in de planning en de klant in de nieuwsbrieflijst. Drie keer overtypen, drie kansen op een tikfout.

Dat werk is bij vrijwel elk bedrijf te automatiseren. Meestal zonder dat er een regel code bij komt kijken.

De techniek eronder heet een webhook. Het is een van die woorden die ingewikkeld klinken en simpel zijn.

Er gebeurt iets, en je site stuurt daarover een berichtje naar een ander systeem. Meer is het niet.

Webhook uitgelegd in het webdesign woordenboek van Project Direct
Een seintje van het ene systeem naar het andere, op het moment dat er iets gebeurt.

Wat is een webhook?

Een webhook is een automatisch bericht dat een systeem verstuurt zodra er iets gebeurt. Dat gebeurt automatisch en direct.

Zo’n gebeurtenis kan van alles zijn: een verzonden formulier, een betaalde bestelling of een nieuwe klant.

Hoe het werkt

Het ontvangende systeem geeft een adres op waar het bericht heen mag. Jouw site stuurt daar de gegevens naartoe.

Dat gaat over dezelfde techniek als een gewone webpagina. Alleen leest er geen mens mee, zie backend.

Het verschil met een API

Bij een API vraag jij om gegevens. Je stelt een vraag en krijgt antwoord.

Bij een webhook is het omgekeerd. Je vraagt niets en krijgt vanzelf bericht zodra er iets gebeurt.

Waarom dat verschil telt

Elke minuut vragen of er iets nieuws is, kost capaciteit en levert meestal niets op. Een seintje krijgen is efficienter.

Bij tijdgevoelige dingen scheelt het bovendien wachttijd. Je klant krijgt zijn bevestiging direct in plaats van na een kwartier.

Waarvoor je hem gebruikt

Wat ik het vaakst inricht

  1. Een aanvraag die automatisch in de klantadministratie komt.
  2. Een bestelling die een pakbon in je magazijnsysteem maakt.
  3. Een inschrijving die naar je nieuwsbriefpakket gaat.
  4. Een melding in je teamchat bij een grote order.

Die eerste levert de meeste tijd op. Bij het overtypen voorkomen verdwijnt een halve dag handwerk per maand.

En het scheelt fouten

Een telefoonnummer dat verkeerd wordt overgetypt, kost je een klant. Meer daarover lees je bij lead.

Automatisch overzetten kent dat probleem niet. De gegevens gaan door zoals ze zijn ingevuld.

Heb je een programmeur nodig?

Vaak niet. Veel formulierpakketten en winkelsystemen hebben dit ingebouwd, zie plugin.

Je plakt een adres in een veld en kiest bij welke gebeurtenis er een bericht uitgaat.

Met een koppelplatform

Er bestaan diensten die twee pakketten aan elkaar knopen zonder code. Bij zo’n koppelplatform sleep je blokjes in de goede volgorde.

Dat kost een paar tientjes per maand en bespaart uren. Voor maatwerk heb je wel een bouwer nodig.

Als het misgaat

Dat is het punt dat wordt overgeslagen. Ligt het ontvangende systeem er even uit, dan komt het bericht niet aan.

Bij een mislukte melding verdwijnt je aanvraag geruisloos. Niemand krijgt een foutmelding.

Wat je daarom regelt

Zorg dat je site het altijd ook zelf opslaat en per mail verstuurt. De koppeling is dan een extra en geen enige route.

Vraag daarnaast of mislukte berichten opnieuw worden geprobeerd. Goede systemen doen dat een paar keer.

Test het zelf een keer

Doe een testaanvraag en kijk of hij op alle plekken terechtkomt. Niet alleen in je mailbox.

Dat is een controle van vijf minuten. Doe hem opnieuw na elke wijziging aan je formulier.

Vaak samen met een API

Het seintje komt binnen via een webhook. Daarna haalt je systeem de rest van de gegevens op.

Die twee vullen elkaar dus aan in plaats van elkaar te vervangen, zie CMS.

Wanneer maatwerk nodig is

Bij een branchepakket zonder standaardoplossing. Dan schrijft je bouwer de koppeling zelf.

Reken op een dag of twee werk. Dat verdient zich terug als je er dagelijks gegevens in overtypt.

Meer vragen over Webhook

Dit zijn de vragen die ik hierover het vaakst krijg. Ik werk ze los uit.

  • Wat is een webhook?
  • Wat is het verschil tussen een webhook en een API?
  • Waarvoor gebruik je een webhook?
  • Wat gebeurt er als een webhook mislukt?
  • Heb je een programmeur nodig voor een webhook?
  • Is een webhook veilig?
Bij een API vraag jij om gegevens. Je stelt een vraag en krijgt antwoord. Bij een webhook is het omgekeerd. Je vraagt niets en krijgt vanzelf bericht zodra er iets gebeurt. Dat verschil telt om twee redenen. Elke minuut vragen of er iets nieuws is, kost capaciteit en levert meestal niets op. En bij tijdgevoelige dingen scheelt het wachttijd. Je klant krijgt zijn bevestiging direct in plaats van na een kwartier. In de praktijk gebruik je ze vaak samen. Het seintje komt binnen via een webhook en daarna haalt je systeem de rest van de gegevens op via de API. In de praktijk gebruik je ze vaak samen. Het seintje komt binnen via een webhook en daarna haalt je systeem de rest op. Ze vervangen elkaar dus niet. De een meldt dat er iets is, de ander haalt de details. Bij een API vraag jij om gegevens en krijg je antwoord. Bij een webhook krijg je vanzelf bericht zodra er iets gebeurt.
Een webhook is een automatisch bericht dat een systeem verstuurt zodra er iets gebeurt. Dat gaat direct en zonder tussenkomst. Zo’n gebeurtenis kan van alles zijn: een verzonden formulier, een betaalde bestelling of een nieuwe klant. Het ontvangende systeem geeft een adres op waar het bericht heen mag. Jouw site stuurt daar de gegevens naartoe. Dat gaat over dezelfde techniek als een gewone webpagina. Alleen leest er geen mens mee. Het is een van die woorden die ingewikkeld klinken en simpel zijn. Er gebeurt iets en je site stuurt daarover een berichtje naar een ander systeem. Meer is het niet. Zo’n bericht gaat automatisch en direct, zonder dat er iemand aan te pas komt. Het is een van die woorden die ingewikkeld klinken en simpel zijn. Er gebeurt iets en je site stuurt daarover een berichtje. Zo’n gebeurtenis kan van alles zijn: een verzonden formulier, een betaalde bestelling of een nieuwe klant.
Om overtypen te voorkomen, en dat is bij vrijwel elk bedrijf de grootste winst. Wat ik het vaakst inricht: een aanvraag die automatisch in de klantadministratie komt. Een bestelling die een pakbon in je magazijnsysteem maakt. Een inschrijving die naar je nieuwsbriefpakket gaat. En een melding in je teamchat bij een grote order. Die eerste levert de meeste tijd op. Er verdwijnt zo een halve dag handwerk per maand. Het scheelt bovendien fouten. Een telefoonnummer dat verkeerd wordt overgetypt, kost je een klant. Automatisch overzetten kent dat probleem niet. Kijk waar bij jou wordt overgetypt. Dat is de plek waar dit het meest oplevert. Een halve dag handwerk per maand is geen uitzondering. En elke keer overtypen is een kans op een tikfout die je een klant kost. Ik richt het vaakst een aanvraag in die automatisch in de klantadministratie komt. Daarna een bestelling die een pakbon maakt. Denk ook aan een melding in je teamchat bij een grote order.
Vaak niet. Veel formulierpakketten en winkelsystemen hebben dit ingebouwd. Je plakt een adres in een veld en kiest bij welke gebeurtenis er een bericht uitgaat. Meer hoef je niet te doen. Daarnaast bestaan er koppelplatforms die twee pakketten aan elkaar knopen zonder code. Je sleept blokjes in de goede volgorde. Dat kost een paar tientjes per maand en bespaart uren. Voor maatwerk heb je wel een bouwer nodig. Denk aan een koppeling met een branchepakket dat geen standaardoplossing heeft. Dat is werk van een dag of twee. Kijk eerst of je huidige pakketten dit al ingebouwd hebben. Bij veel formulier- en winkelsystemen is dat zo. Een koppelplatform is de tussenweg: een paar tientjes per maand en geen code. Maatwerk is werk van een dag of twee. Je plakt dan een adres in een veld en kiest bij welke gebeurtenis er een bericht uitgaat. Meer hoef je niet te doen. Een koppelplatform kost een paar tientjes per maand en bespaart uren.
Dan komt het bericht niet aan, en dat is het punt dat wordt overgeslagen. Ligt het ontvangende systeem er even uit, dan verdwijnt je aanvraag geruisloos. Niemand krijgt een foutmelding. Zorg daarom dat je site het altijd ook zelf opslaat en per mail verstuurt. De koppeling is dan een extra en geen enige route. Vraag daarnaast of mislukte berichten opnieuw worden geprobeerd. Goede systemen doen dat een paar keer. Controleer die opzet een keer door zelf een testaanvraag te doen. Kijk of hij op alle plekken terechtkomt en niet alleen in je mailbox. Zorg dat je site elke aanvraag ook zelf opslaat en per mail verstuurt. De koppeling is dan een extra en geen enige route. Zonder die vangnetten verdwijnt een aanvraag geruisloos bij een storing. Vraag ook of mislukte berichten opnieuw worden geprobeerd. Goede systemen doen dat een paar keer voordat ze opgeven. Doe daarnaast een testaanvraag en kijk of hij overal terechtkomt.
Typ je aanvragen nog handmatig over naar je administratie of je planning? Beschrijf je situatie via het formulier hieronder. Ik kijk welke koppelingen mogelijk zijn en wat dat je aan uren scheelt. Vermeld je plaats, dan weet ik meteen waar je zit.

Waar kan ik je mee helpen?