Guide d'utilisation : webhooks

Guide d'utilisation : webhooks

🔐 Introduction à l'utilisation des Webhooks

Notre plateforme vous permet de configurer des webhooks pour recevoir automatiquement des mises à jour sur les événements clés liés à vos commandes et incidents. Cela vous permet de synchroniser vos systèmes sans avoir à effectuer de requêtes manuelles.

📌 Que sont les Webhooks ?

Un webhook est un appel automatique que notre système effectue vers une URL que vous configurez dès qu'un événement pertinent se produit (comme un changement de statut de commande ou un incident). Ainsi, votre système peut réagir immédiatement à ces changements.

🔑 Configuration initiale

Pour commencer à utiliser les webhooks :
  1. Accédez à la section Mon compte > Jeton d’accès .
  2. Créez une clé API avec des autorisations sur vos commandes et problèmes.
  3. Configurer deux points de terminaison (URL publiques) :
  4. Un pour recevoir les mises à jour du statut de la commande .
  5. Un autre pour recevoir des mises à jour sur l'état des incidents .

✅ Sécurité : Signatures HMAC (facultatives pour le moment)

Pour valider l'authenticité des événements que vous recevez, chaque webhook peut inclure une signature numérique dans l'en-tête :
  1. En-tête : X-Dropea-Hmac-Sha256
  2. Contenu : un hachage SHA256 généré à l'aide du corps POST (charge utile) et de votre clé API correspondante comme clé secrète.
Cela vous permet de vérifier que la demande provient réellement de notre système et n'a pas été modifiée, de la même manière que Shopify le fait avec son système de webhooks .

⚠️ Important : la validation de la signature est actuellement facultative, mais sa mise en œuvre est recommandée pour renforcer la sécurité.

🛍️ Mise à jour du statut de la commande

Lorsque le statut d'une commande est mis à jour, le système envoie une notification au webhook configuré avec la structure d'événement suivante :

❌ Exemple 1 : La commande passe de Confirmée à Annulée (Charge utile à Recevoir)
  1. {"topic":"commande : mise à jour du statut","commande_id":265494,"prev_status":"confirmé","new_status":"annulé","updated_at":"2025-05-29 14:14:58"}

✅ Exemple 2 : La commande passe de « En attente » à « Confirmée » (charge utile à recevoir)
  1. {"topic":"commande : mise à jour du statut","commande_id":265494,"prev_status":"en attente","new_status":"confirmé","updated_at":"2025-05-29 14:14:58"}

🔁 Exemple 3 : La commande passe de l'état d'erreur à l'état d'attente (de la charge utile à la réception)
  1. {"topic":"commande:mise_à_jour_du_statut",
  2. "order_id":265496,"prev_status":"erreur","new_status":"en attente","updated_at":"2025-05-29 14:38:05"}

🛠️ Mise à jour sur l'incidence

📌 Exemple : L'incident passe de « En attente » à « Géré par le client » (charge utile à recevoir)
  1. {
  2. "topic": "incidence:status_update",
  3. "new_status": "géré par le client",
  4. "updated_at": "2025-02-13 14:23:56",
  5. "prev_status": "en attente",
  6. « incidence_id » : 189 044
  7. }

🔄 Exemple 2 : L'incident passe de « En attente » à « Solution envoyée »
  1. {
  2. "topic": "incidence:status_update",
  3. "incidence_id": 265494,
  4. "prev_status": "client_managed",
  5. "new_status": "resolution_send",
  6. "updated_at": "2025-05-29 16:10:45"
  7. }

✅ Exemple 3 : L'incident passe de Solution envoyée à Résolu (Charge utile à Recevoir)
  1. {
  2. "topic": "incidence:status_update",
  3. "incidence_id": 265494,
  4. "prev_status": "solution_send",
  5. "new_status": "résolu",
  6. "updated_at": "2025-05-29 17:42:30"
  7. }

📌 Détails par domaine


Champ
Gars Description
sujet
chaîne
Il peut s'agir de « order:status_update » ou de « incidence:status_update » , selon la source de l'événement.
identifiant de commande
entier
ID de la commande concernée. Présent uniquement si le sujet est order:status_update.
incidence_id
entier
ID du problème concerné. Présent uniquement si le sujet est « incidence : status_update ».
statut_précédent
chaîne
État précédent de l'objet. Par exemple : « en attente », « confirmé », « erreur ».
nouveau_statut
chaîne
Nouvel état après changement.
mis à jour à
date
Date et heure de la modification. Ce champ correspond au fuseau horaire Europe/Madrid , soit :
— UTC+2 en été (heure d'été)
— UTC+1 en hiver (heure standard)



    • Related Articles

    • Guide de l'utilisateur : API GraphQL de Dropea avec Apollo

      ? Générer une clé API dans dropea 1️⃣ Accédez à Mon compte → Jetons d'accès 2️⃣ Donnez un nom à votre clé API ✏️ 3️⃣ En option, vous pouvez ajouter une date d'expiration. ⏳ (Si vous n'en définissez pas, la clé API sera permanente.) 4️⃣ Sélectionnez ...

    • Où puis-je trouver un guide pour commencer à configurer mon compte Dropea ?

      Une fois connecté à votre compte dropshipper, vous trouverez un guide avec les premières étapes dans la section Tableau de bord du panneau, dans le menu de gauche (c'est le premier qui apparaît). Chaque étape est accompagnée de ses propres ...

    • Comment confirmer et demander l’exécution d’une commande directement depuis Shopify ?

      Configurer la branche drop dans le produit Dropea met automatiquement à jour et ajoute le suivi des commandes à votre tableau de bord Shopify, à condition que la branche Dropea soit définie comme unique au sein du produit dans Shopify. Vous pouvez ...

    • Je souhaite envoyer mes produits vers vos entrepôts satellites

      Réalisé par dropea 1. Pour envoyer vos produits dans nos entrepôts, vous devez demander à votre gestionnaire de compte que le service logistique vous contacte pour compléter la procédure. 2. Vous devez avoir vos informations d'expédition prêtes : a) ...

    • Comment gérer le retour d'une commande ?

      Lorsque vous effectuez une vente via Dropea, il s’agit d’une transaction en gros. Dans le cas où le produit ne répond pas aux attentes de votre client, la responsabilité de fournir un support vous incombe et, par conséquent, la décision d'accepter un ...