Webhooks

Configuration des Webhooks

Umbrella envoie des notifications Webhook à vos systèmes externes lorsque des événements liés aux garanties se produisent. Utilisez les Webhooks pour vous intégrer à votre CRM, à votre outil d’assistance, à vos outils d’analyse ou à vos services backend.

---

Types d’événements

Événements de police

Événement	Description
policy.created	Police de garantie créée (commande finalisée avec une garantie)
policy.activated	Police activée (paiement confirmé)
policy.expired	La police a atteint sa date de fin
policy.cancelled	Police annulée (remboursement ou annulation de la commande)
policy.updated	Police mise à jour (changement de statut ou de métadonnées)

Événements de réclamation

Événement	Description
claim.created	Nouvelle réclamation déposée
claim.updated	Statut de la réclamation modifié
claim.approved	Réclamation approuvée
claim.denied	Réclamation refusée
claim.resolved	Réclamation résolue (remplacement expédié ou remboursement émis)

Événements de commande

Événement	Description
order.warranty_attached	Garantie associée à une ligne de commande
order.warranty_removed	Garantie retirée d’une commande
order.post_purchase_completed	Vente additionnelle de garantie post-achat finalisée

Événements client

Événement	Description
customer.policy_assigned	Police attribuée à un client
customer.claim_filed	Le client a déposé une réclamation

---

Format de la charge utile

Toutes les charges utiles suivent cette structure :

{
  "id": "wh_evt_abc123def456",
  "event": "policy.created",
  "timestamp": "2026-03-17T14:30:00.000Z",
  "version": "1.0",
  "data": { ... },
  "metadata": {
    "orgId": "org_abc",
    "integrationPlatform": "shopify",
    "shopDomain": "my-store.myshopify.com"
  }
}

• id — ID unique de l’événement (à utiliser pour la déduplication)
• event — type d’événement
• data — charge utile propre à l’événement, avec les détails de la ressource
• metadata — contexte de l’organisation et de l’intégration

---

Vérification de la signature

Tous les Webhooks incluent un en-tête X-Umbrella-Signature (HMAC-SHA256 du corps de la requête). Vérifiez-le toujours avant de traiter la requête. Consultez la Référence des Webhooks pour des exemples de code de vérification.

---

Stratégie de nouvelles tentatives

Les livraisons échouées (réponse autre que 2xx ou délai dépassé) font l’objet de nouvelles tentatives avec un délai exponentiel :

Tentative	Délai
1re nouvelle tentative	30 secondes
2e nouvelle tentative	2 minutes
3e nouvelle tentative	10 minutes
4e nouvelle tentative	1 heure
5e nouvelle tentative	6 heures
Dernière tentative	24 heures

Votre endpoint doit répondre avec 200, 201 ou 202 dans un délai de 30 secondes. Répondez immédiatement et traitez la requête de manière asynchrone pour éviter les dépassements de délai.

---

Configurer un endpoint

1. Accédez à Tableau de bord → Paramètres → Webhooks
2. Cliquez sur Ajouter un endpoint
3. Saisissez l’URL HTTPS de votre endpoint et sélectionnez les événements
4. Copiez le secret de signature et conservez-le en lieu sûr (il n’est affiché qu’une seule fois)
5. Testez avec Envoyer un événement de test sur la page de détail de l’endpoint

---

Journaux des Webhooks

La page des journaux affiche l’historique des livraisons par endpoint : type d’événement, statut (réussi/échoué/relancé), code de réponse, temps de réponse, horodatage et nombre de tentatives.

---

Voir aussi

• Synchronisation des produits Shopify — Synchronisation par Webhooks Shopify
• Intégration Shopify — Connexion Shopify dans son ensemble
• Configuration du widget — Paramètres d’affichage du widget