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

1

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.

2

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).

3

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.

4

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

1

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é.

2

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.

3

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

1

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.

2

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.

3

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).

4

Avant nettoyage — champ encapsulé en chaîne :

{
  "event": "invoice.paid",
  "data": "{\"invoice_id\":\"inv_123\",\"amount\":1500}"
}
5

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

1

Ouvrir l’événement

Affichez le détail de l’événement contenant le payload ou le message d’erreur que vous voulez copier.

2

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).

3

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.

4

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

1

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é.

2

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.

3

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.

4

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.

5

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.

Ce que vous voyez : pastille bleue.
Action recommandée : vérifier la configuration de l’URL (redirections temporaires/permanentes). Une redirection peut être acceptable ou indésirable selon votre architecture.

Ce que vous voyez : pastille jaune + message d’erreur (ex. 400, 401, 404).
Action recommandée : vérifier que le payload respecte le schéma attendu, que les autorisations (tokens/clefs) sont correctes, et que l’URL est correcte. Copier le message d’erreur et le transmettre au responsable du receveur.

Ce que vous voyez : pastille rouge + message d’erreur serveur.
Action recommandée : reproduire le payload côté receveur pour extraire la trace d’erreur. Informez l’équipe qui gère le serveur cible et partagez le payload + horodatage + code d’erreur.

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.

Sinao

Le logiciel de comptabilité simple et puissant. Prenez la main sur vos finances, votre trésorerie et documents pour piloter votre entreprise.

Powered by DeployIt

© 2026 Sinao