Journal et debugging des webhooks
Journal et debugging des webhooks
Consultez, inspectez, testez et copiez les événements envoyés par webhooks — avec chargement paginé et nettoyage des payloads
Accédez au journal des webhooks, visualisez les payloads lisibles, testez vos endpoints et récupérez rapidement les données nécessaires au debug.
Ce que couvre cette page
Chargement paginé
Parcourez les événements par lots et chargez « plus » pour remonter dans le temps sans surcharger l’interface.
Visualisation des payloads
Affichez les payloads formatés et lisibles — avec traitement automatique des JSON imbriqués pour une lecture facilitée.
Copie & tests
Copiez un payload ou un message d’erreur en 1 clic et testez votre URL de réception en envoyant des événements de test.
Nettoyage JSON
Utilisez l’option de “nettoyage” (cleanJson) qui parse les chaînes JSON imbriquées pour montrer la structure réelle.
Couleurs de statut
Repérez instantanément les réponses : 2xx = vert, 3xx = bleu, 4xx = jaune, 5xx = rouge.
Regroupement temporel
Les événements sont groupés par “Aujourd’hui”, “Hier” et dates, pour une navigation rapide.
Commencez par filtrer par période
Si vous avez beaucoup d’événements, utilisez le regroupement temporel (Aujourd’hui / Hier / date) pour repérer rapidement les incidents récents avant d’explorer l’historique.
Introduction
Ce guide explique pas à pas comment utiliser le journal des webhooks pour :
- charger et parcourir les événements (pagination),
- ouvrir un événement pour voir le payload formaté,
- nettoyer les payloads qui contiennent du JSON encodé en chaîne,
- tester votre URL de réception et vérifier les réponses (codes HTTP),
- copier le payload ou un message d’erreur pour le transmettre à votre équipe de développement ou support.
Utilisez les sections “Étapes” ci-dessous pour chaque tâche courante.
Parcourir le journal et charger plus d’événements
Ouvrir la page Journal des webhooks
Rendez-vous dans la section “Clés API & Webhooks” puis sélectionnez “Journal” (ou l’équivalent “Événements”). La liste affiche les événements récents groupés par date.
Comprendre la présentation
Chaque ligne montre : type d’événement, horodatage, statut de la livraison (code HTTP) et un bref résumé. Les couleurs indiquent l’état (vert 2xx, bleu 3xx, jaune 4xx, rouge 5xx).
Charger plus d’événements (pagination)
Descendez en bas de la liste et cliquez sur “Charger plus” ou “Voir plus” pour récupérer le lot suivant. Les événements plus anciens sont ajoutés à la liste sans recharger la page.
Recherche et tri
Si l’interface propose une recherche ou un tri, filtrez par type d’événement ou période pour isoler les cas pertinents (erreurs, échecs récurrents, etc.).
Visualiser un événement et son payload
Sélectionner l’événement
Cliquez sur la ligne de l’événement pour ouvrir le détail. Le panneau montrera l’horodatage, le code HTTP de la dernière tentative et le payload brut ou formaté.
Lire le payload formaté
Le payload s’affiche en JSON indenté pour faciliter la lecture. Si certains champs contiennent du JSON encodé sous forme de chaîne, une option (ex. “Nettoyer / cleanJson”) permet d’afficher ces champs comme des objets imbriqués.
Inspecter les en-têtes et le message d’erreur
Consultez le message d’erreur retourné par le serveur receveur (s’il y en a) et les en-têtes de réponse pour trouver des indices (ex. 4xx = problème côté receveur ; 5xx = problème serveur).
Nettoyer un payload (cleanJson) — pourquoi et comment
Pourquoi nettoyer ?
Certaines applications envoient, dans un même champ, une chaîne qui contient elle-même du JSON. Le nettoyage convertit ces chaînes en objets JSON pour une lecture et un debug plus simples.
Activer l’affichage nettoyé
Dans le détail de l’événement, utilisez le bouton souvent appelé “Nettoyer”, “Format” ou “cleanJson”. Le panneau remplace les chaînes JSON imbriquées par leurs structures objets affichées de façon indentée.
Vérifier le résultat
Comparez l’affichage avant/après : vous devez voir des objets imbriqués lisibles au lieu d’une chaîne échappée. Si le nettoyage échoue, l’interface laissera le contenu d’origine (la chaîne).
Avant nettoyage — champ encapsulé en chaîne :
{
"event": "invoice.paid",
"data": "{\"invoice_id\":\"inv_123\",\"amount\":1500}"
}
Après cleanJson — champs convertis :
{
"event": "invoice.paid",
"data": {
"invoice_id": "inv_123",
"amount": 1500
}
}
Copier un payload ou un message d’erreur pour le debug
Ouvrir l’événement
Affichez le détail de l’événement contenant le payload ou le message d’erreur que vous voulez copier.
Cliquer sur 'Copier le payload' ou 'Copier le message d’erreur'
Utilisez le bouton prévu : le contenu est copié dans le presse-papiers. L’interface doit confirmer la copie (notification).
Coller dans votre outil de debug
Collez le payload dans votre ticket, chat d’assistance, document partagé ou outil de test. Si besoin, supprimez ou masquez les champs sensibles avant envoi.
En cas d’échec de la copie
Si la copie échoue (message d’erreur du navigateur), sélectionnez manuellement le texte et copiez-le. Vérifiez que votre navigateur autorise l’accès au presse-papiers.
Tester votre URL de réception (simulateur d’envoi) — checklist pratique
Préparer un événement de test
Prenez un payload représentatif — idéalement un petit exemple qui reproduit l’erreur (même structure). Nettoyez-le si des champs contiennent du JSON encodé.
Envoyer un test depuis l’interface
Si l’application propose un bouton “Envoyer un test” ou “Rejouer l’événement”, utilisez-le pour déclencher une nouvelle tentative de livraison vers votre URL.
Analyser la réponse
Après l’envoi, contrôlez le code HTTP retourné et le message d’erreur éventuel. Un code 200–299 signifie généralement une livraison réussie.
Reproduire côté receveur
Si l’envoi échoue côté applicatif, reproduisez le même payload côté serveur receveur avec votre outil de développement pour inspecter logs et erreurs.
Répéter avec variations
Testez différentes tailles et structures (ex : champs nuls, tableaux vides, chaînes longues) pour vérifier la robustesse du traitement côté receveur.
Ce que vous voyez : pastille verte, message indiquant “Succès”.
Action recommandée : aucune action nécessaire, validez que le receveur traite bien le contenu (ex. crée une facture, enregistre un paiement). Conservez un échantillon d’événements réussis pour référence.
Gardez un historique pour le support
Lorsqu’un incident survient, copiez au minimum : l’ID de l’événement, la date/heure, le payload nettoyé et le message d’erreur. Ces éléments réduisent les aller-retours avec le support.
Frequently Asked Questions
Checklist rapide avant d’ouvrir un incident
- Avez-vous copié le payload nettoyé ?
- Avez-vous noté l’ID et l’horodatage de l’événement ?
- Avez-vous inclus le code HTTP et le message d’erreur ?
- Avez-vous masqué les données sensibles ?
- Avez-vous tenté d’envoyer un test reproduisant l’erreur ?
Besoin d’aide pour analyser un webhook ?
Si vous avez rassemblé le payload, l’ID d’événement et le message d’erreur, notre équipe peut vous aider à diagnostiquer plus rapidement. Incluez ces éléments dans votre demande.