Een webhook testen

Webhooks zitten achter veel koppelingen: een betaalprovider die je webshop laat weten dat er betaald is, een formulier dat een aanvraag naar je CRM stuurt, een agenda die een automatisering start. Als een webhook niet werkt, merk je dat vaak pas als er iets ontbreekt. Testen voorkomt dat. Hoe webhooks werken, staat in Koppelingen, API's en webhooks.

Hoe werkt een webhook?

1. Er gebeurt iets in systeem A (bijvoorbeeld een nieuwe bestelling).
2. Systeem A stuurt een HTTP-verzoek (meestal POST) naar een vooraf ingestelde URL van systeem B.
3. Het verzoek bevat gegevens, vaak in JSON.
4. Systeem B verwerkt de gegevens en antwoordt met een statuscode (bijvoorbeeld 200 voor gelukt).

Stap 1: ontvanger klaarzetten

• Automatiseringstool: Zapier, Make en n8n hebben een webhooktrigger met een eigen URL en tonen ontvangen berichten. Zie Zapier of Make kiezen.
• Testdienst: er zijn online diensten die een tijdelijke URL geven en ontvangen verzoeken tonen. Gebruik daarvoor geen echte persoonsgegevens.
• Eigen ontvanger: een ontwikkelaar kan een testomgeving gebruiken.

Stap 2: testgebeurtenis veroorzaken

• Gebruik de testknop van het verzendende systeem, als die er is.
• Of veroorzaak een echte gebeurtenis in een testomgeving: testbestelling, testformulier.

Stap 3: bericht controleren

• URL — Waar op letten: klopt de URL exact (https, geen typfout)?
• Methode — Waar op letten: POST, GET of iets anders, zoals verwacht?
• Headers — Waar op letten: content-type, eventuele handtekening of sleutel
• Inhoud — Waar op letten: zijn alle verwachte velden aanwezig en goed gevuld?
• Statuscode — Waar op letten: 200/201 = gelukt; 4xx = fout aan de verzendkant of verkeerde gegevens; 5xx = fout bij de ontvanger

Stap 4: verwerking controleren

• Is het record correct aangemaakt of bijgewerkt in systeem B?
• Kloppen de velden (namen, datums, bedragen, speciale tekens)?
• Wat gebeurt er bij een herhaling: dubbel record of netjes bijgewerkt?

Veelvoorkomende fouten

• Verkeerde of verouderde URL na een wijziging.
• Beveiliging (sleutel of handtekening) klopt niet.
• Verkeerd datum- of getalformaat.
• Firewall of beveiligingsplugin blokkeert het verzoek.
• Time-out: de ontvanger reageert te traag en de verzender probeert opnieuw, met dubbele records als gevolg.

Zie ook Koppeling werkt niet: eerste controles.

Na het testen

• Stel meldingen in bij fouten. Zie Mislukte automatiseringen bewaken.
• Documenteer de webhook: URL, gebeurtenis, velden, eigenaar. Zie Automatiseringen documenteren.

Voorbeeld

Stel: een webshop stuurt bij elke bestelling een webhook naar een automatiseringstool die de klant in het CRM zet. Bij een test met één product werkt het, maar bij een bestelling met drie producten ontbreken er twee. In het ontvangen bericht blijken de producten in een lijst te staan, terwijl de automatisering alleen het eerste element uitlas. Na aanpassing worden alle producten verwerkt.

Veelgestelde vragen

Wat is het verschil tussen een webhook en een API?

Bij een API vraag je zelf gegevens op; bij een webhook stuurt het systeem ze automatisch als er iets gebeurt.

Waarom krijg ik dubbele records?

Vaak door herhaalpogingen na een time-out. Laat de ontvanger controleren of een record al bestaat.

Is een webhook veilig?

Met https en een handtekening of geheime sleutel wel. Controleer die altijd aan de ontvangende kant.

Kan ik een webhook opnieuw versturen?

Veel systemen bieden een logboek met de optie om opnieuw te versturen.

Mag ik echte klantgegevens gebruiken bij testen?

Liever niet bij externe testdiensten. Gebruik testgegevens.

Hulp nodig?

Wil je koppelingen die betrouwbaar blijven werken? Bekijk onze dienst workflowautomatisering.

Test met echte voorbeelddata die alle varianten bevat: lege optionele velden, speciale tekens, meerdere producten. Veel koppelingen falen pas bij een 'afwijkende' inzending.