Doel: Leer hoe je webhook feedback kunt inschakelen in Sendcloud en dit configureert voor je specifieke integraties.
Wat is Webhook Feedback?
Webhook feedback stelt je applicatie in staat om real-time updates van Sendcloud te ontvangen wanneer een belangrijk evenement, zoals een wijziging in de pakketstatus, plaatsvindt. In plaats van handmatig of periodiek data op te vragen, stuurt Sendcloud deze updates automatisch door naar je applicatie.
API vs. Webhook:
- API: Je applicatie stuurt regelmatig verzoeken om data op te halen, zelfs als er geen nieuwe updates beschikbaar zijn.
- Webhook: Sendcloud stuurt automatisch data naar je applicatie zodra er een gebeurtenis plaatsvindt (bijv. een wijziging in de pakketstatus).
Voorbeeld: Tracking updates via Webhooks
- API: Je applicatie stuurt op vaste intervallen verzoeken om tracking data op te halen van Sendcloud, ongeacht of er nieuwe data beschikbaar is.
- Webhook: Sendcloud stuurt tracking updates direct naar je applicatie zodra er nieuwe informatie beschikbaar is, waardoor je klanten real-time tracking kunt aanbieden.
Wil je meer weten, bekijk dan ons artikel: Wat zijn webhooks en hoe stel je ze in Sendcloud in?
Hoe stel je Webhooks in Sendcloud in
1. Maak een API Endpoint
Om webhook updates te ontvangen, heb je een API endpoint nodig die inkomende verzoeken van Sendcloud kan verwerken.
2. Webhook Feedback configureren in Sendcloud:
- Ga naar je Sendcloud panel en navigeer naar Instellingen > Integraties > Configureren.
- Vink het vakje aan voor Webhook feedback ingeschakeld.
3. Voer de Webhook URL in:
- Kopieer je Webhook URL vanuit je applicatie en plak deze in het Webhook URL-veld in Sendcloud.
4. Stel indien aanwezig een Webhook Signature Key in:
Dit is een wachtwoord dat wordt gebruikt om alle Sendcloud webhook verzoeken te ondertekenen. De sleutel moet:
- Minstens 16 tekens lang zijn.
- Minstens één cijfer, één hoofdletter, één kleine letter en één speciaal teken bevatten.
5. Test je Webhook:
Klik op de knop Test API Webhook om je configuratie te verifiëren. Als je webhook goed werkt, zou je payloads moeten ontvangen in je applicatie.
6. Opslaan:
Klik op Opslaan om de configuratie af te ronden.
Ondersteunde Webhook Events in Sendcloud
Er zijn twee categorieën integraties die worden ondersteund door Sendcloud webhooks:
1. Voor API-integraties:
Sendcloud ondersteunt de volgende drie webhook events:
- Webhook Pakket Status Gewijzigd Event: Wordt getriggerd wanneer de status van een pakket verandert.
- Webhook Integratie Event: Wordt getriggerd wanneer een nieuwe API-integratie wordt gekoppeld, verwijderd of bijgewerkt in Sendcloud.
- Webhook Terugbetaling Aangevraagd Event: Wordt getriggerd wanneer een terugbetaling wordt aangevraagd voor een pakket.
2. Voor de volgende integraties:
Sendcloud ondersteunt alleen het Webhook Pakket Status Gewijzigd Event, dat updates verstuurt wanneer er een wijziging is in de pakketstatus:
- Amazon v2
- Bol
- CCVshop v2
- Ebay v2
- Epages
- Etsy v2
- Lightspeed v2
- Magento v2
- Mijnwebwebshop
- Prestashop
- Prestashop v2
- Shopify
- Shopify v2
- Woocommerce
- Woocommerce v2
Voor deze integraties stuurt Sendcloud pakketstatuswijzigingen rechtstreeks naar je applicatie, wat zorgt voor automatische updates in je webshopsysteem.
Testen en Problemen Oplossen
Zodra je webhook is geconfigureerd, is het belangrijk om deze te testen door op de knop Test API Webhook te klikken in het Sendcloud panel. Dit bevestigt dat je configuratie goed werkt en dat je endpoint succesvol updates ontvangt.