Een WooCommerce webhook stuurt automatisch een melding naar een extern systeem zodra er iets gebeurt in je webshop, bijvoorbeeld een nieuwe bestelling of een gewijzigde voorraad. Zo koppel je WooCommerce zonder plugins aan boekhoudpakketten, CRM-systemen of eigen scripts. In dit artikel lees je hoe je een webhook aanmaakt, test en afstemt op je hostingomgeving.
Wat is een WooCommerce webhook
Een webhook is een automatisch bericht dat WooCommerce verstuurt zodra er een specifieke actie plaatsvindt, zoals een nieuwe order, een statuswijziging of een productupdate. In plaats van dat een extern systeem steeds moet controleren of er iets gewijzigd is, stuurt WooCommerce direct de gegevens naar een URL die je zelf opgeeft. Dit scheelt serverbelasting en zorgt voor realtime synchronisatie tussen je webshop en bijvoorbeeld een boekhoudpakket of fulfilmentsysteem.
Webhook aanmaken in WooCommerce
Het instellen van een webhook doe je rechtstreeks in de WooCommerce-instellingen, zonder extra plugins. Volg onderstaand stappenplan.
Ga naar de webhook-instellingen
Open je WordPress-dashboard en navigeer naar WooCommerce > Instellingen > Geavanceerd > Webhooks.
Maak een nieuwe webhook aan
Klik op ‘Webhook toevoegen’ en geef een duidelijke naam op, bijvoorbeeld ‘Order naar boekhouding’.
Kies de topic (gebeurtenis)
Selecteer welke actie de webhook triggert, zoals ‘Order created’, ‘Order updated’ of ‘Product updated’.
Vul de bestemmings-URL in
Dit is het endpoint van het externe systeem dat de data ontvangt en verwerkt.
Stel een geheime sleutel in
Deze sleutel wordt gebruikt om de inhoud van het bericht te verifiëren aan de ontvangende kant, zodat je zeker weet dat het verzoek echt van jouw webshop komt.
Sla de webhook op en activeer deze
Zet de status op ‘Actief’ en sla de instellingen op. WooCommerce verstuurt vanaf nu automatisch meldingen bij de gekozen gebeurtenis.
Webhook testen en controleren
Na het aanmaken van een webhook is het belangrijk te controleren of de gegevens correct aankomen. Plaats een testbestelling en bekijk vervolgens het ‘Webhook details’-scherm in WooCommerce. Daar zie je de verzonden payload, de HTTP-responscode en eventuele foutmeldingen. Een responscode 200 betekent dat het externe systeem het verzoek succesvol heeft ontvangen; codes als 400 of 500 wijzen op een probleem aan de ontvangende kant of een onjuiste URL.
Gebruik je een eigen script als ontvanger, log dan de binnenkomende data tijdelijk weg zodat je de structuur van de payload kunt bekijken. Dit voorkomt dat je blind moet gokken naar veldnamen. In Plesk vind je onder ‘Logs’ de serverlogs van je webshop terug, wat handig is als je wilt controleren of verzoeken de server daadwerkelijk bereiken.
Veelgemaakte fouten en oplossingen
De meest voorkomende oorzaak van falende webhooks is een onbereikbare of verkeerd gespelde URL. Controleer altijd of het endpoint publiek toegankelijk is en geen inlogverplichting heeft. Ook een verlopen SSL-certificaat aan de ontvangende kant kan verzoeken blokkeren; zorg dat beide kanten over een geldig, gratis SSL-certificaat beschikken.
Een andere veelvoorkomende fout is timeouts door trage verwerking bij het externe systeem. Zorg dat de ontvangende server snel reageert, bijvoorbeeld door de zware verwerking op de achtergrond uit te voeren en direct een bevestiging terug te sturen. Draait je webshop op een server met NVMe-opslag en LiteSpeed, dan merk je dat WooCommerce zelf sneller reageert, wat de kans op timeouts aan jouw kant verkleint.
Let ook op dubbele webhooks: als dezelfde topic meerdere keren is ingesteld, ontvangt het externe systeem dubbele meldingen. Controleer dit overzicht regelmatig en verwijder overbodige webhooks. Werk je met gevoelige ordergegevens, overweeg dan ook e-mailnotificaties via een betrouwbare /nl/email-hosting/ oplossing, zodat meldingen over mislukte webhooks je altijd bereiken.
Veelgestelde vragen
Werkt een WooCommerce webhook ook zonder plugin?
Ja, WooCommerce heeft standaard ingebouwde webhook-functionaliteit onder Geavanceerd > Webhooks, je hebt hiervoor geen extra plugin nodig.
Wat gebeurt er als een webhook mislukt?
WooCommerce probeert het verzoek enkele keren opnieuw te versturen. Blijft dit mislukken, dan zie je dit terug in de webhook-logs met de bijbehorende foutcode.
Kan ik meerdere webhooks tegelijk instellen?
Ja, je kunt zoveel webhooks aanmaken als nodig, bijvoorbeeld apart voor orders, klanten en producten, elk met een eigen bestemming.
Heeft mijn hosting invloed op webhooks?
Ja, de snelheid en stabiliteit van je /nl/webhosting/ bepalen hoe snel WooCommerce verzoeken verwerkt en verstuurt, vooral bij veel gelijktijdige bestellingen.
Is een geheime sleutel verplicht?
Niet verplicht, maar wel sterk aanbevolen om te controleren dat binnenkomende data daadwerkelijk van jouw webshop afkomstig is.
Conclusie
Een WooCommerce webhook instellen is binnen enkele minuten gedaan via de ingebouwde instellingen van WooCommerce. Zorg voor een bereikbare URL, een geldig SSL-certificaat en een snelle hostingomgeving om foutmeldingen en timeouts te voorkomen. Twijfel je over de prestaties van je huidige server, bekijk dan de mogelijkheden om /nl/overstappen/ naar een snellere omgeving.