Objectif : Apprends à activer le feedback du webhook dans Sendcloud et à le configurer pour tes intégrations personnalisées.
Qu'est-ce que le Feedback du Webhook ?
Le feedback du webhook permet à ton application de recevoir des mises à jour en temps réel de Sendcloud chaque fois qu'un événement important se produit, comme un changement dans le statut d'une expédition. Au lieu d'envoyer des requêtes manuelles ou périodiques, Sendcloud envoie automatiquement ces mises à jour directement à ton application.
API vs. Webhook :
- API : Ton application envoie régulièrement des requêtes pour récupérer des données, même lorsqu'il n'y a pas de nouvelles mises à jour.
- Webhook : Sendcloud envoie automatiquement les données à ton application dès qu'un événement se produit (par exemple, un changement dans le statut d'une expédition).
Exemple : Mises à jour de suivi via Webhooks
- API : Ton application envoie des requêtes à intervalles réguliers pour obtenir les données de suivi de Sendcloud, même s'il n'y a pas de nouvelles mises à jour.
- Webhook : Sendcloud envoie immédiatement les mises à jour de suivi à ton application lorsque de nouvelles informations sont disponibles, te permettant d'offrir un suivi en temps réel à tes clients.
Si tu veux en savoir plus, consulte notre article : Qu'est-ce qu'un webhook et comment le configurer dans Sendcloud ?
Comment configurer les Webhooks dans Sendcloud
1. Crée un Endpoint API
Pour recevoir des mises à jour via webhook, tu as besoin d'un endpoint API capable de gérer les requêtes entrantes de Sendcloud.
2. Configure le feedback du Webhook dans Sendcloud :
- Accède à ton panneau Sendcloud et va dans Réglages > Boutiques connectées > Configurer:
- Coche la case pour activer le Feedback du webhook activé:
3. Saisis l'URL du Webhook :
- Copie l'URL du webhook depuis ton application et colle-la dans le champ URL du Webhook dans Sendcloud.
4. Si nécessaire, configure une Webhook Signature Key :
Il s'agit d'un mot de passe utilisé pour signer toutes les requêtes de webhook envoyées par Sendcloud. La clé doit :
- Contenir au moins 16 caractères.
- Contenir au moins un chiffre, une majuscule, une minuscule et un caractère spécial.
5. Teste ton Webhook :
Clique sur le bouton Test API Webhook pour vérifier ta configuration. Si le webhook fonctionne correctement, tu devrais commencer à recevoir des payloads dans ton application.
6. Sauvegarde :
Clique sur Enregistrer pour finaliser la configuration.
Webhook Events supportés par Sendcloud
Il existe deux catégories d'intégrations supportées par les webhooks de Sendcloud :
1. Pour les intégrations API :
Sendcloud supporte les événements webhook suivants :
- Webhook Parcel Status Changed Event : Activé chaque fois qu'un changement de statut d'une expédition se produit.
- Webhook Integration Event : Activé lorsqu'une nouvelle intégration API est connectée, supprimée ou mise à jour dans Sendcloud.
- Webhook Refund Requested Event : Activé lorsqu'un remboursement est demandé pour une expédition.
2. Pour les intégrations suivantes :
Sendcloud supporte uniquement l'Webhook Parcel Status Changed Event, qui envoie des mises à jour lorsqu'un changement de statut d'une expédition a lieu :
- Amazon v2
- Bol
- CCVshop v2
- Ebay v2
- Epages
- Etsy v2
- Lightspeed v2
- Magento v2
- Mijnwebwinkel
- Prestashop
- Prestashop v2
- Shopify
- Shopify v2
- Woocommerce
- Woocommerce v2
Pour ces intégrations, Sendcloud enverra automatiquement les mises à jour de statut des expéditions directement à ton application, permettant ainsi des mises à jour automatiques dans ton système e-commerce.
Tests et Dépannage
Une fois que tu as configuré le webhook, il est essentiel de le tester en cliquant sur le bouton Test API Webhook dans le panneau Sendcloud. Cela confirmera que ta configuration fonctionne correctement et que ton endpoint reçoit bien les mises à jour.