# Vos webhooks cessent d’être une boîte noire.

> Inspectez chaque appel webhook entrant dans Pocket Alert : en-têtes, payload, message généré et motif d’échec. Déboguez vos intégrations webhook grâce à un historique pouvant aller jusqu’à un an.

<!-- source: https://pocketalert.app/fr/features/webhook-history -->

Dernière mise à jour : 2026-08-11

Chaque appel entrant est enregistré avec ses en-têtes, sa charge utile, son message généré et son résultat. Lorsqu’une intégration affirme avoir envoyé la requête, vous pouvez le vérifier.

Documentation : https://info.pocketalert.app/api/webhooks/history.html

## Découvrez ce qui est réellement arrivé

1. **Pointez un service vers lui** — Créez un webhook et pointez votre service vers son URL, comme vous le feriez habituellement.
2. **Ouvrez l’historique** — Ouvrez le webhook dans votre tableau de bord et accédez à son historique.
3. **Dépliez l’appel** — Dépliez n’importe quel appel pour voir les en-têtes, le corps, le message généré et ce qui a échoué.

## Tout ce qu’un webhook en échec ne vous dira pas

Quand une alerte n’arrive pas, la question reste toujours la même : l’émetteur a-t-il réellement appelé, et si oui, qu’est-ce qui a échoué de notre côté ?

- **Un journal de chaque requête** — Chaque appel enregistré, du plus récent au plus ancien, se déplie directement. Méthode, adresse IP source, taille et type de contenu visibles d’un coup d’œil.
- **En-têtes et charge utile intégraux** — Les en-têtes complets et le corps brut tels qu’ils sont arrivés, pour comparer ce qu’un service affirme envoyer à ce qu’il a réellement envoyé.
- **Ce que votre modèle a produit** — Visualisez le message généré par votre modèle à partir de la charge utile, à côté de la charge utile elle-même. Les erreurs de modèle cessent d’être des suppositions.
- **Des raisons d’échec explicites** — Les échecs sont accompagnés d’une raison précise : JSON invalide, message vide dû à un %path% absent, ou webhook inactif.
- **Masqué et chiffré** — Les en-têtes Authorization, cookie et clé API sont masqués avant stockage, et les charges utiles sont chiffrées au repos avec votre clé.
- **Filtrer, paginer ou récupérer** — Filtrez par résultat et parcourez l’historique dans le tableau de bord, ou récupérez-le via l’API pour l’analyser vous-même.

## Fonctionnement de l’historique des webhooks

    
Chaque requête qui atteint l’une de vos URL de webhook est enregistrée avant d’être traitée, et son résultat est ajouté une fois le traitement terminé. Vous voyez donc les appels en échec aussi clairement que les appels réussis, y compris ceux adressés à un webhook que vous avez désactivé et oublié.

    
Ouvrez un webhook dans le tableau de bord et son historique s’affiche, du plus récent au plus ancien. Chaque ligne se déplie pour montrer la chaîne de requête, les en-têtes complets et le corps mis en forme en JSON. Les mêmes données sont accessibles depuis l’API REST, avec des filtres pour `success` et `error`.

    
## Déboguer un modèle

    
La panne la plus courante n’est pas un problème réseau : c’est un espace réservé `%path%` qui pointe vers un champ que l’émetteur n’envoie pas réellement. L’historique affiche côte à côte la charge utile brute et le message produit par votre modèle, ce qui rend généralement l’écart évident en quelques secondes.

    
## Confidentialité

    
Les charges utiles contiennent souvent des secrets : elles sont donc chiffrées au repos avec votre clé personnelle, et les en-têtes Authorization, cookie et clé API sont remplacés par `[redacted]` avant stockage. La conservation va de 7 jours avec l’offre gratuite à un an complet avec Large.

## FAQ

### Que consigne-t-on pour chaque appel de webhook ?

L’horodatage, la méthode HTTP, l’adresse IP source, le type de contenu, la chaîne de requête, la totalité des en-têtes, le corps brut, la taille de la charge utile, le message produit par votre modèle, la création ou non d’une alerte, la raison de l’échec le cas échéant, ainsi que la durée du traitement.

### Pendant combien de temps l’historique des webhooks est-il conservé ?

7 jours avec l’offre gratuite, 30 avec Starter, 90 avec Medium et 365 avec Large. Les anciens appels sont supprimés automatiquement, de même que les entrées les plus anciennes dès qu’un même webhook dépasse 1 000 appels enregistrés.

### La charge utile stockée est-elle sécurisée ?

Oui. Les charges utiles sont chiffrées au repos avec votre clé personnelle, comme le contenu des messages, et les en-têtes Authorization, cookie et clé API sont remplacés par [redacted] avant tout stockage.

### Un service affirme avoir envoyé le webhook mais rien n’est arrivé. Que faire ?

L’historique vous indique lequel. Si rien n’est enregistré, l’émetteur n’a jamais atteint nos serveurs. Si un appel est enregistré avec une erreur, vous obtenez la raison : JSON invalide, message vide dû à un %path% absent de la charge utile, ou webhook désactivé.

### Où consulter l’historique ?

Ouvrez le webhook dans votre tableau de bord : son historique s’affiche, du plus récent au plus ancien, et chaque appel se déplie. Une API REST est également disponible si vous préférez le récupérer par programmation, avec des filtres pour les succès et les erreurs.

### L’historique des webhooks fonctionne-t-il avec l’offre gratuite ?

Oui, avec une conservation de 7 jours. Si vous avez besoin de plus longtemps, c’est ce que proposent les offres payantes.
