Journal des requêtes webhook

Principe

Chaque envoi de webhook est enregistré dans un journal (Journal de la demande de Webhook). Ce journal conserve le payload envoyé ainsi que le statut de la livraison. Lorsqu'une livraison échoue et que les tentatives automatiques sont épuisées, le journal contient la seule copie de la requête.

Statuts de livraison

Le journal indique l'état de chaque tentative :

• Livré : la requête a été livrée avec succès ;
• Échec : la livraison a échoué, des tentatives automatiques restent programmées ;
• Épuisé : toutes les tentatives automatiques ont échoué.

Retenter une livraison échouée

Vous pouvez renvoyer manuellement une requête dont la livraison a échoué ou est épuisée :

1. Ouvrez le Journal de la demande de Webhook concerné.
2. Cliquez sur le bouton Recommencer dans l'en-tête du formulaire.
3. Un message (« Nouvelle tentative en file d'attente. Rechargez pour voir le résultat. ») confirme que la tentative est en file d'attente.
4. Rechargez la page pour voir le résultat.

Le bouton Recommencer est visible uniquement lorsque le statut du journal est Échec ou Épuisé et que vous disposez des droits d'écriture sur le Webhook associé.

Conditions de refus

La tentative est refusée avec un message d'erreur si :

• la requête a déjà été livrée entre-temps ;
• le webhook est désactivé : réactivez-le avant de retenter ;
• une tentative pour ce journal est déjà en file d'attente.

Résultat d'une tentative

La tentative manuelle utilise le même traitement que les tentatives automatiques programmées : la requête enregistrée est renvoyée vers l'URL du webhook, avec le même payload.

• Si la livraison réussit, le journal passe au statut Livré et le compteur de tentatives est incrémenté.
• Si la livraison échoue, le compteur de tentatives augmente. Le journal reste au statut Échec avec une nouvelle date de Prochaine tentative s'il reste des renvois, sinon il passe au statut Épuisé.

Pour le calendrier des renvois automatiques, consultez Configurer les tentatives de renvoi pour les Webhooks.

Le retentement ne rejoue pas l'événement sur le document : il renvoie uniquement la requête telle qu'enregistrée dans le journal.