Webhooks

Les webhooks permettent à Scrollengine de notifier vos systèmes externes en temps réel lorsque des événements se produisent. Utilisez les webhooks pour créer des intégrations personnalisées, automatiser des workflows ou synchroniser des données avec d'autres outils.

Qu'est-ce qu'un webhook

Un webhook est une requête HTTP POST envoyée à une URL que vous spécifiez chaque fois qu'un événement spécifique se produit dans Scrollengine. Votre serveur reçoit les données de l'événement et peut agir en conséquence.

Événements webhook disponibles

Événement	Déclencheur
order.created	Une nouvelle commande de livraison est passée
order.updated	Les détails ou le statut de la commande sont modifiés
order.delivered	La commande est marquée comme livrée
order.cancelled	La commande est annulée
route.created	Un nouvel itinéraire est créé
route.started	Le livreur démarre un itinéraire
route.completed	Tous les arrêts d'un itinéraire sont terminés
driver.assigned	Un livreur est assigné à une commande ou un itinéraire

Configurer un webhook

1. Allez dans Paramètres > Intégrations > Webhooks
2. Cliquez sur Ajouter un Webhook
3. Saisissez :
   • URL — Le point de terminaison sur votre serveur qui recevra le webhook
   • Événements — Sélectionnez les événements auxquels vous souhaitez vous abonner
   • Secret — Un secret partagé pour vérifier l'authenticité du webhook
4. Cliquez sur Enregistrer

Contenu du webhook

Les webhooks sont envoyés sous forme de requêtes HTTP POST avec un corps JSON :

{
  "event": "order.delivered",
  "timestamp": "2026-03-13T14:30:00Z",
  "data": {
    "order_id": "12345",
    "shopify_order_id": "98765",
    "delivery_method": "local_delivery",
    "status": "delivered",
    "driver": {
      "id": "d-001",
      "name": "John Driver"
    }
  }
}

Vérifier les webhooks

Chaque webhook inclut un en-tête de signature pour la vérification :

1. Scrollengine signe le contenu en utilisant votre secret partagé
2. La signature est incluse dans l'en-tête X-Scrollengine-Signature
3. Votre serveur doit vérifier la signature avant le traitement

Politique de réessai

Si votre point de terminaison renvoie un code de statut non-2xx :

• Scrollengine réessaie jusqu'à 3 fois
• Les réessais utilisent un backoff exponentiel (1 min, 5 min, 30 min)
• Après 3 échecs, le webhook est marqué comme défaillant
• Vous recevrez une notification pour réparer votre point de terminaison

Cas d'utilisation

• Synchronisation ERP — Envoyer les données de livraison à votre système de gestion des stocks ou de comptabilité
• Notifications personnalisées — Déclencher des SMS, Slack ou d'autres alertes
• Analytique — Alimenter les événements de livraison dans votre plateforme d'analyse
• Logistique tierce — Notifier les transporteurs ou partenaires externes