Chaque message qu’Illizeo envoie à un webhook est une livraison, tracée de la première tentative au résultat final. Cet article explique comment lire la page d’un webhook, ce que signifient les statuts, comment fonctionnent les relances automatiques et la désactivation après échecs, et comment relancer une livraison à la main. Il s’adresse aux administrateurs qui suivent les intégrations.
Avant de commencer #
- Le droit « Voir les webhooks et leurs livraisons » suffit pour lire la page d’un webhook et ses livraisons, dans Paramètres › Gérer Illizeo › Webhooks.
- Relancer une livraison, envoyer un test ou réactiver un webhook demandent le droit « Créer / modifier / supprimer un webhook » au palier Exécuter (voir Créer et gérer un webhook).
La page d’un webhook #
Dans la liste, cliquez sur le nom d’un webhook ou sur l’icône Voir. L’en-tête rappelle son état (Actif ou Inactif), son Adresse de réception, le début de son Secret de signature, ses Événements, sa date de création et son créateur, et, s’il échoue, la date du premier échec sous En échec depuis. Les boutons Envoyer un test, Renouveler le secret et Modifier y sont réservés au palier Exécuter.
Quatre compteurs résument les 30 derniers jours, tests exclus : Livrées (30 j), En relance, Échouées (30 j) et En attente.
Le tableau des livraisons #
Le tableau Livraisons liste les envois du plus récent au plus ancien, vingt par page, avec un filtre par statut (Tous les statuts par défaut) :
- Date et Événement (son code, par exemple
absence.approved, oupingpour un test) ; - Statut et Tentatives (le nombre d’essais déjà faits) ;
- Réponse : le code HTTP renvoyé par le récepteur et le temps de réponse, avec la raison de l’échec en rouge ;
- Prochaine relance : la date de l’essai suivant, s’il y en a un.
Au bout de la ligne, Voir la charge déplie le message JSON envoyé, et Relancer maintenant apparaît pour une livraison en relance ou échouée.
Les statuts #
| Statut | Sens |
|---|---|
| En attente | La livraison est dans la file d’envoi ; elle part dans les secondes qui suivent. |
| Livrée | Le récepteur a répondu par un code 2xx. |
| En relance | La dernière tentative a échoué ; une autre est programmée à la date de la colonne Prochaine relance. |
| Échouée | Toutes les tentatives ont échoué, ou la livraison a été arrêtée (voir les raisons ci-dessous) ; plus aucune relance automatique. |
Les relances automatiques #
Une tentative échoue quand le récepteur ne répond pas par un code 2xx en moins de 10 secondes ; une redirection compte aussi comme un échec. Illizeo relance alors la livraison 1 minute, 5 minutes, 30 minutes, 2 heures puis 12 heures après l’échec précédent : six tentatives en tout. Après la sixième, la livraison passe en Échouée.
Toutes les tentatives d’une même livraison portent le même identifiant d’événement, ce qui permet au récepteur d’écarter un doublon.
Relancer à la main #
Relancer maintenant fait une tentative immédiate. Le résultat s’affiche aussitôt : « Livrée », ou « Toujours en échec » avec la raison. Une relance à la main n’est jamais suivie de relances automatiques : si elle échoue sur une livraison en relance, les essais qui restaient prévus sont abandonnés et la livraison passe en Échouée. Elle reste possible quand le webhook est désactivé : c’est le moyen de renvoyer une livraison manquée une fois le récepteur réparé.
La désactivation après échecs #
Quand un webhook échoue sans interruption pendant trois jours, sans aucune livraison réussie entre-temps, Illizeo le désactive :
- la liste affiche Désactivé après échecs et la page du webhook un bandeau rouge ;
- son créateur reçoit un avis dans la cloche et par e-mail, s’il a toujours les droits de voir et de gérer les webhooks ;
- plus aucun événement ne lui est envoyé, et ceux qui surviennent pendant la désactivation ne sont pas mis de côté.
Pour repartir : réparez le récepteur, cliquez sur Envoyer un test pour le vérifier, puis réactivez le webhook avec l’interrupteur de la liste. Relancez au besoin les livraisons échouées qui comptent.
Les raisons d’un échec #
| Raison affichée | Sens |
|---|---|
http_ suivi d’un code (par exemple http_500) |
Le récepteur a répondu, mais par une erreur ou une redirection. |
| Un message de connexion (délai dépassé, nom introuvable…) | Le récepteur n’a pas répondu dans les 10 secondes, ou n’est pas joignable. |
abonnement_desactive |
Le webhook a été désactivé avant la tentative suivante. |
destination_refusee suivi d’un motif |
L’adresse n’est plus acceptée (elle mène à un réseau interne ou n’est plus en https). |
plafond_de_consommation |
Le plafond de sécurité de la consommation est atteint : les livraisons s’arrêtent jusqu’à la période suivante. |
À savoir #
- Chaque nuit, les livraisons livrées ou échouées de plus de 30 jours sont effacées. Supprimer un webhook efface aussi tout son journal.
- Chaque livraison réussie compte une unité dans la consommation de la plateforme API ; les tests et les relances ne comptent pas en plus. La consommation se lit sur la carte Plateforme API de la page des jetons (voir Suivre l’utilisation d’un jeton et le dépanner).
- Un test réussi ne remet pas à zéro une série d’échecs : seule une vraie livraison réussie, ou la réactivation, le fait.
Questions fréquentes #
Le récepteur dit avoir reçu le message, mais la livraison est « En relance ». #
Il a sans doute répondu trop tard (plus de 10 secondes) ou par un autre code que 2xx. Il doit répondre tout de suite et traiter le message ensuite.
La colonne Dernière livraison de la liste dit « Jamais » alors que j’ai envoyé un test. #
Les tests n’y sont pas pris en compte, ni dans les compteurs. Ils figurent seulement dans le tableau des livraisons.
