🔗 Guide de l'utilisateur : Webhooks

Notre plateforme vous permet de configurer des webhooks pour recevoir des mises à jour automatiques sur les événements clés liés à vos commandes et incidents.

📌 Que sont les webhooks ?

Par exemple, lorsque le statut d'une commande ou d'un incident change, Dropea peut automatiquement envoyer cette information à votre système afin que vous puissiez réagir immédiatement.

🔑 Configuration initiale

Pour commencer à utiliser les webhooks, suivez ces étapes :

1. Se connecter à Mon compte → Jeton d'accès .
2. Créez une clé API disposant des autorisations nécessaires sur vos commandes et incidents.
3. Configurez deux points de terminaison ou URL publiques :
   • 📦 Un pour recevoir les mises à jour sur l'état des commandes.
   • 🛠️ Un autre pour recevoir des mises à jour sur l'état des incidents.

✅ Sécurité : Signatures HMAC

Pour valider l'authenticité des événements reçus, chaque webhook peut inclure une signature numérique dans son en-tête.

Cela vous permet de vérifier que la requête provient bien de dropea et n'a pas été modifiée.

🛍️ Mise à jour du statut de la commande

Lorsque le statut d'une commande est mis à jour, Dropea envoie une notification au webhook configuré avec la structure d'événement.

❌ Exemple 1 : une commande passe de confirmée à annulée

 {"topic":"order:status_update","order_id":265494,"prev_status":"confirmed","new_status":"cancelled","updated_at":"2025-05-29 14:14:58"}

✅ Exemple 2 : une commande passe du statut « en attente » à « confirmée ».

 {"topic":"order:status_update","order_id":265494,"prev_status":"pending","new_status":"confirmed","updated_at":"2025-05-29 14:14:58"}

🔁 Exemple 3 : une commande passe de l’état « erreur » à l’état « en attente ».

 {"topic": "order:status_update",
 "order_id":265496,"prev_status":"error","new_status":"pending","updated_at":"2025-05-29 14:38:05"}

🛠️ Mise à jour concernant l'incident

Lorsque le statut d'un incident est mis à jour, Dropea envoie une notification au webhook configuré pour les incidents.

📌 Exemple 1 : L’incident passe de l’état « en attente » à l’état « traité par le client ».

 {
 "topic": "incidence:status_update",
 "incidence_id": 189044,
 "prev_status": "pending",
 "new_status": "client_managed",
 "updated_at": "2025-02-13 14:23:56"
 }

🔄 Exemple 2 : L’incident passe de la prise en charge par le client à l’envoi d’une solution

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "client_managed",
 "new_status": "solution_send",
 "updated_at": "2025-05-29 16:10:45"
 }

✅ Exemple 3 : Changements d’incident : « Solution envoyée » → « Résolu »

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "solution_send",
 "new_status": "resolved",
 "updated_at": "2025-05-29 17:42:30"
 }

📋 Détails par champ