Wat is een webhook? Uitleg voor niet-developers: je chatbot koppelen aan je andere tools
Een webhook is een automatisch bericht dat de ene app naar de andere stuurt zodra er iets gebeurt. Zo werken chatbot-webhooks, zo verschillen ze van een API en zo houd je ze…

In dit artikel
Wat is een webhook eigenlijk? Een webhook is een automatisch bericht dat de ene app naar de andere stuurt op het moment dat er iets gebeurt, bijvoorbeeld wanneer je chatbot een nieuwe lead binnenhaalt. In plaats van dat je andere tools om de paar minuten vragen "is er iets nieuws?", laat de chatbot het ze meteen weten.
Zie het als het verschil tussen elk uur naar je brievenbus lopen en een deurbel hebben. De deurbel gaat alleen als er echt iemand voor de deur staat.
Hieronder: hoe chatbot-webhooks werken, hoe ze zich verhouden tot een API, welke events de moeite waard zijn om te versturen en hoe je ze veilig houdt.
Belangrijkste punten
- Een webhook duwt gegevens naar een ander systeem zodra er een event plaatsvindt; een API roep je meestal zelf aan om gegevens op te halen.
- Bruikbare chatbot-webhooks gaan af bij zakelijke events, zoals een nieuwe lead, een overdracht naar een medewerker of een afgesloten gesprek.
- HMAC-handtekeningen bewijzen dat een bericht echt is, en nieuwe pogingen zorgen ervoor dat een korte storing geen gegevens kost.
Wat is een webhook, in gewone taal?
Een webhook bestaat uit drie delen:
- Een event: er gebeurt iets in de bronapp, bijvoorbeeld een bezoeker die in de chat zijn e-mailadres achterlaat.
- Een URL: het adres van het ontvangende systeem, vaak het endpoint genoemd. Die plak je in de instellingen van de bronapp.
- Een payload: een klein pakketje gegevens, meestal in JSON, dat beschrijft wat er is gebeurd.
Vindt het event plaats, dan stuurt de bronapp de payload naar die URL. Het ontvangende systeem leest hem en doet er iets nuttigs mee: een contact aanmaken, een melding plaatsen, een rij toevoegen aan een spreadsheet. Niemand hoeft op een knop te drukken of een script te schrijven dat op wijzigingen controleert.
De ontvangende kant hoef je ook niet zelf te bouwen. Automatiseringsplatforms zoals Zapier, Make en n8n maken in een paar klikken een webhook-URL voor je aan. Daardoor kunnen ook niet-developers met webhooks werken.
Webhook vs. API: wat is het verschil?
Mensen zien ze vaak als concurrenten, maar ze werken als duo. Een API (application programming interface) is een reeks deuren naar een app waarop jij klopt om gegevens te lezen of te wijzigen. Een webhook is de app die op jouw deur klopt als er iets gebeurt.
Zonder webhooks kom je alleen achter nieuwe events door polling: steeds opnieuw aan de API vragen of er iets is veranderd.
| Webhook (push) | API-polling (pull) | |
|---|---|---|
| Wie het in gang zet | De bronapp, zodra er een event plaatsvindt | Jouw systeem, volgens een schema |
| Snelheid | Bijna realtime | Zo snel als je pollinginterval |
| Het meest geschikt voor | Meldingen, nieuwe records synchroniseren, workflows starten | Bulkexports, rapportages, opzoekingen op aanvraag |
| Inrichting | URL plakken, events kiezen | Script of geplande taak schrijven |
| Belangrijkste risico | Gemiste berichten als de ontvanger offline is (opgevangen met nieuwe pogingen) | Vertraging, verspilde verzoeken, rate limits |
Veel integraties gebruiken allebei. Een webhook meldt "gesprek 123 is net overgedragen", en het ontvangende systeem roept daarna de API aan als het meer details nodig heeft.
Chatbot-webhooks: voorbeelden van events die het versturen waard zijn
De beste chatbot-webhooks sluiten aan op momenten die je team al belangrijk vindt. Drie veelvoorkomende voorbeelden:
Nieuwe lead verzameld
Een bezoeker deelt contactgegevens en beantwoordt een of twee kwalificatievragen. Gebruikelijke toepassingen: een contact in je CRM aanmaken of bijwerken, je saleskanaal waarschuwen of de lead aan een nurture-lijst toevoegen (met toestemming). Omdat snel reageren op nieuwe leads meer deals oplevert, is dit meestal de eerste webhook die teams instellen.
Gesprek overgedragen aan een medewerker
De assistent besloot dat een mens het moest overnemen, of de klant vroeg erom. Gebruikelijke toepassingen: de dienstdoende medewerker waarschuwen, een ticket in je helpdesk openen of een prioriteitsaccount markeren. De payload hoort de context mee te sturen waar je proces voor de overdracht van chatbot naar medewerker op leunt, zoals intentie, labels en contactgegevens.
Gesprek afgesloten
Een gesprek is beëindigd, opgelost door de AI of door een medewerker. Gebruikelijke toepassingen: het vastleggen voor rapportages, een dashboard bijwerken of een taak voor opvolging aanmaken.
Een eenvoudige regel: abonneer je alleen op events waar je iets mee doet. Elke webhook die je aanzet, is weer iets om in de gaten te houden.
Webhookbeveiliging: handtekeningen, nieuwe pogingen en het volgen van leveringen
Een webhook-URL is gewoon een adres op internet. Wat houdt iemand tegen om er nep-"nieuwe lead"-berichten naartoe te sturen? En wat gebeurt er als je server tien minuten plat ligt? Drie waarborgen geven antwoord op die vragen.
HMAC-handtekeningen. Verzender en ontvanger delen een geheime sleutel. De verzender berekent uit de payload en het geheim een handtekening en stuurt die met elk verzoek mee. De ontvanger berekent hem opnieuw en weigert alles wat niet overeenkomt, zodat vervalste of gemanipuleerde berichten worden tegengehouden.
Nieuwe pogingen. Bevestigt de ontvanger de levering niet, dan probeert de verzender het later opnieuw, meestal met steeds langere pauzes tussen de pogingen. Een korte storing betekent dan geen verloren gegevens.
Circuit breakers en het volgen van leveringen. Blijft een endpoint falen, dan pauzeert een circuit breaker de leveringen een tijdje in plaats van een kapotte server te blijven bestoken. Leveringslogs laten zien wat er is verstuurd en of dat is gelukt, zodat je zonder giswerk kunt debuggen.
Aan de ontvangende kant voorkomen een paar gewoontes de meeste problemen:
- Controleer de handtekening voordat je de gegevens gebruikt.
- Antwoord snel met een succescode en doe het zware werk daarna op de achtergrond.
- Reken op duplicaten: een nieuwe poging kan hetzelfde event twee keer afleveren, dus gebruik het event-ID om herhalingen over te slaan.
- Gebruik alleen HTTPS-endpoints.
- Stuur alleen de persoonsgegevens door die de ontvangende tool nodig heeft; de AVG-regels voor AI-chatbots blijven gelden zodra gegevens de chat verlaten.
Zo werken realtime webhooks in Conviro
Conviro biedt realtime webhooks. Events komen bij je endpoint aan op het moment dat ze plaatsvinden, ondertekend met HMAC zodat je elk verzoek kunt verifiëren, automatisch opnieuw verstuurd als de levering mislukt en beschermd door een circuit breaker. Via het volgen van leveringen zie je wat er is verstuurd en of het is aangekomen.
Laat die webhooks naar je eigen code wijzen of naar een no-codetool: Conviro koppelt ook met Zapier, Make en n8n, en biedt een REST API met bearer-token-authenticatie en sleutels met beperkte rechten om gegevens op aanvraag op te halen. Dit alles is beschikbaar vanaf het Pro-abonnement. De documentatie voor developers behandelt payloads en de controle van handtekeningen, en de pagina met automatiseringsintegraties laat de no-coderoutes zien.
Veelgestelde vragen
Wat is een webhook in simpele woorden?
Een webhook is een automatische melding die de ene app naar de andere stuurt wanneer een bepaald event plaatsvindt. Je geeft de bronapp een URL, kiest de events, en de app stuurt elke keer een klein pakketje gegevens naar die URL. Het werkt als een deurbel voor software: het ontvangende systeem hoort direct over wijzigingen in plaats van steeds zelf te controleren.
Heb ik een developer nodig om webhooks te gebruiken?
Niet altijd. Automatiseringsplatforms zoals Zapier, Make en n8n maken een webhook-URL voor je aan en laten je inkomende gegevens in een visuele editor aan acties koppelen. Een developer wordt handig als je een eigen endpoint bouwt, handtekeningen in code controleert of een intern systeem koppelt waarvoor geen kant-en-klare connector bestaat.
Is een webhook sneller dan een API?
Om van nieuwe events te horen wel. Een webhook komt enkele ogenblikken na het event binnen, terwijl polling via een API maar zo snel is als hoe vaak je controleert. Voor historische gegevens of extra details is de API het juiste gereedschap. De meeste goed gebouwde integraties gebruiken webhooks om te melden en de API om dingen op te zoeken.
Wat gebeurt er als mijn webhook-endpoint offline is?
Dat hangt af van de verzender. Goede webhooksystemen proberen mislukte leveringen gedurende een bepaalde tijd opnieuw, zodat korte storingen geen gegevens kosten, en sommige pauzeren de leveringen aan een endpoint dat blijft falen. Ga na of je aanbieder nieuwe pogingen doet, en zorg dat je endpoint veilig kan omgaan met hetzelfde event dat twee keer binnenkomt.
Volgende stappen
Kies één event waar je vandaag al iets mee zou doen, meestal nieuwe leads, en koppel het aan de tool waarin je team al werkt. Loopt dat betrouwbaar, voeg dan overdrachten en afgesloten gesprekken toe. Start gratis met Conviro om je assistent in te richten, en stap over op Pro zodra je webhooks wilt koppelen.
Gepubliceerd door
Conviro
Deelt inzichten over AI-aangedreven klantenservice, chatbot-automatisering en SaaS-groeistrategieën.
Bouw op Conviro
Koppel gespreksworkflows aan je stack
Bekijk ontwikkelaarsbronnen en integratiepatronen voordat je de implementatie ontwerpt.
Gerelateerde artikelen
Meer berichten
Engineering
IMAP of POP3 (en SMTP) uitgelegd: een supportmailbox koppelen aan een AI-assistent
7 min leestijd
Artikel lezen

Engineering
7 manieren om een chatbot-API te gebruiken: bouwen op je supportgesprekken
7 min leestijd
Artikel lezen