---
title: Suivre les livraisons et les relances
description: "Lire la page d'un webhook et ses livraisons, comprendre les statuts, les relances automatiques et la désactivation après échecs, et relancer une livraison à la main."
url: "https://illizeo.com/centre-aide/webhooks-suivre-les-livraisons/"
updated: "2026-11-05"
category: Plateforme / Webhooks
---

# Suivre les livraisons et les relances

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](https://illizeo.com/centre-aide/webhooks-creer-et-gerer/)).

## 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**.

![Les quatre compteurs de la page d'un webhook sur 30 jours : Livrées (30 j), En relance, Échouées (30 j) et En attente](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/webhooks-suivre-les-livraisons-01.fr_-scaled.png?resize=800%2C54&quality=80&ssl=1)
Les compteurs de livraisons d'un webhook.

## 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`, ou `ping` pour 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.

![Le tableau Livraisons d'un webhook avec le filtre Tous les statuts : colonnes Date, Événement, Statut, Tentatives, Réponse avec le code HTTP et le temps de réponse, Prochaine relance, et les boutons Voir la charge et Relancer maintenant](https://i0.wp.com/illizeo.com/wp-content/uploads/2026/11/webhooks-suivre-les-livraisons-02.fr_.png?resize=800%2C99&quality=80&ssl=1)
Les livraisons d'un webhook et leurs statuts.

## 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](https://illizeo.com/centre-aide/api-suivre-et-depanner-un-jeton/)).
- 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.

### *Similaire*