Surveiller les intégrations externes
Dernière mise à jour : 6 juillet 2026
La boutique de vêtements en ligne « La Penderie Douillette » a configuré un Webhook (une intégration qui envoie une notification à un programme externe lorsqu'un contenu change) pour signaler automatiquement chaque nouveau produit à son bot de notification interne. Mais un jour, la personne responsable signale que « les alertes de nouveaux produits n'arrivent plus vraiment ces derniers temps ». Il faut d'abord déterminer si les alertes ne sont réellement pas parties, ou si elles sont bien parties mais que le bot les a manquées.
Une fois créé, un Webhook fonctionne tout seul : au quotidien, vous n'avez pas à vous en occuper. Mais le programme externe qui reçoit les notifications se trouve hors de votre portée, et un jour viendra où il ne répondra pas ou renverra une erreur. Cette page explique comment vérifier que les Webhook que vous avez configurés partent bien, comment repérer les appels en échec et comment y réagir selon la cause, à travers des recettes adaptées à chaque situation.
Ce qu'est un Webhook et comment le créer, l'activer, le désactiver ou le modifier est traité dans Webhook. Ici, l'accent est mis sur l'exploitation et la surveillance d'un Webhook déjà créé.
Ce que consigne l'historique des appels
Chaque fois qu'un Webhook envoie une requête à un programme externe, chacun de ces appels est consigné dans l'historique des appels. Chaque enregistrement contient les éléments suivants.
- Quand l'appel a été envoyé, et le temps qu'a pris le traitement
- Quel changement a déclenché l'envoi (par exemple, l'enregistrement d'un produit)
- À quelle adresse l'appel a été envoyé
- Le code de réponse renvoyé par le programme externe (le numéro de résultat qui indique comment la requête a été traitée)
- Si l'appel a réussi ou échoué
L'historique des appels comporte deux niveaux. Il y a d'abord une liste qui parcourt les appels par ordre chronologique ; en ouvrant un élément de la liste, vous accédez au détail de cet appel. Dans le détail, vous pouvez voir tels quels la requête que vous avez réellement envoyée et la réponse renvoyée par le programme externe.
Dans la liste des Webhook, cliquez sur un nom pour ouvrir l'écran de détail ; cette liste apparaît dans l'onglet Appels Webhook en haut. Voici les enregistrements envoyés par le Bot d'alerte nouveaux produits de « La Penderie Douillette » à chaque enregistrement d'un produit.
La liste n'affiche brièvement que les colonnes Webhook appelé le et Résultat de l'appel ; le reste des informations, comme l'adresse de destination et la raison de l'envoi, ne s'affiche qu'en cliquant sur une ligne pour ouvrir le détail. Si la liste vous semble ancienne, vous pouvez la recharger avec le bouton Actualiser Les Appels en haut à droite.
La réussite ou l'échec se décide selon le code de réponse. Si le code de réponse est dans la plage normale (généralement les séries 200 et 300), l'appel est enregistré comme réussi ; pour tout autre numéro, il est enregistré comme échoué. Si le programme externe n'a pas répondu du tout, ou si la réponse renvoyée est trop volumineuse, l'appel est lui aussi consigné comme un échec.
Vérifier que les alertes partent bien
Pour vérifier si la personne responsable a raison, regardez d'abord le pourcentage d'appels réussis parmi tous ceux que ce Webhook a envoyés jusqu'ici. Le taux de réussite des appels s'affiche directement dans la liste des Webhook.
- Dans les paramètres du Space de la boutique, ouvrez l'écran Webhook.
- Dans la liste, vérifiez la colonne Appels réussis (%) de la ligne
Bot d'alerte nouveaux produits.
Par exemple, ce taux s'affiche comme « 66,67% ». À 100%, tous les appels envoyés jusqu'ici ont réussi ; dans ce cas, c'est du côté du bot que quelque chose a été manqué. En dessous de 100%, cela signifie que l'alerte elle-même a déjà été bloquée en cours d'envoi : la section suivante vous aide à en trouver la cause.
Si aucun appel n'a été envoyé jusqu'ici, l'alerte n'a pas échoué : elle n'a pas été envoyée. Cela arrive lorsque le Webhook est désactivé (INACTIVE), ou lorsqu'aucun changement correspondant aux conditions définies ne s'est produit entre-temps. Dans ce cas, vérifiez dans Webhook s'il est bien activé et à quels changements vous l'avez configuré pour réagir.
Trouver la cause d'un appel en échec
Si vous constatez un échec, ouvrez cet appel pour voir ce qui n'a pas fonctionné. Le détail présente ensemble la requête que vous avez envoyée et la réponse renvoyée par le programme externe.
- Dans l'onglet Appels Webhook du
Bot d'alerte nouveaux produits, cliquez sur une ligne dont le résultat est un échec. L'écran Détail de l'appel Webhook s'ouvre. - Dans Requête, vérifiez à quelle adresse et avec quel contenu l'envoi a été fait.
- Dans Réponse, vérifiez le code de réponse et le contenu renvoyé par le programme externe.
Le code de réponse et le contenu renvoyé vous indiquent la cause. Si le code de réponse est dans la plage d'échec, c'est que le programme externe a bien reçu la requête mais a échoué pendant son traitement ; dans ce cas, la cause est souvent décrite dans le contenu renvoyé. S'il n'y a aucune réponse ou si l'adresse est introuvable, il se peut que l'adresse de destination ait changé ou que le programme soit hors service.
Si vous voulez transmettre cet appel tel quel à la personne responsable du programme externe, le bouton Copier le cURL en haut à droite vous permet de le copier sous une forme qui reproduit l'appel, puis de l'envoyer.
La requête envoyée contient aussi les en-têtes que vous avez joints. Parmi eux, ceux que vous avez désignés comme valeurs secrètes (par exemple la valeur de clé utilisée pour se connecter au programme externe) apparaissent masqués par des astérisques à l'écran. La valeur d'origine n'est jamais exposée : vous pouvez consulter le détail en toute tranquillité.
Si ce Webhook utilise aussi le WriteBack, qui remplit des valeurs à partir de la réponse renvoyée, vous pouvez également voir si chacune de ces opérations a réussi ou échoué dans l'onglet WriteBack Résultats du même détail. La signification de chaque élément est traitée dans Webhook.
Réagir en cas d'échec
Il y a d'abord une chose à savoir. Un appel en échec n'est pas renvoyé automatiquement. Une alerte qui a échoué reste dans l'historique ; le Webhook ne la renvoie pas de lui-même. La réaction se divise donc en deux volets : corriger la cause pour que les prochaines alertes partent normalement, et prendre en charge vous-même le cas déjà échoué que le bot a manqué.
Selon ce que vous avez vu dans le détail, voici les causes à examiner et les réactions correspondantes.
| Ce qui s'affiche dans le détail | Cause à examiner | Réaction |
|---|---|---|
| Un code de réponse de la plage d'échec et un contenu d'erreur | Le programme externe a échoué en traitant la requête | Transmettez le contenu de la réponse renvoyée tel quel à la personne responsable du programme externe pour qu'elle le corrige de son côté |
| Aucune réponse ou adresse introuvable | L'adresse de destination a changé ou le programme est hors service | Vérifiez que l'adresse est correcte et, si elle a changé, modifiez le Webhook |
| Aucun appel n'est enregistré | Le Webhook est désactivé (INACTIVE) | Réactivez le Webhook |
| Enregistré comme échec avec une réponse renvoyée très volumineuse | Le contenu renvoyé par le programme externe est trop volumineux | Ajustez le programme externe pour qu'il réduise le contenu renvoyé |
La façon de corriger l'adresse ou de réactiver un Webhook est traitée dans Webhook.
Même après avoir corrigé la cause, les alertes qui ont échoué entre-temps ne repartent pas d'elles-mêmes. Vous pouvez vérifier à quel enregistrement de produit correspond chaque appel en échec dans le contenu envoyé du détail de l'appel ; pour ces produits, prévenez directement la personne responsable du bot afin de rattraper les traitements manquants.
Que faire ensuite
- Webhook : ce qu'est un Webhook, et comment en créer un ou l'activer, le désactiver et modifier son adresse et ses conditions.
- Webhook : lorsque vous utilisez le WriteBack qui remplit des valeurs à partir de la réponse renvoyée, comment vérifier dans le détail de l'appel le résultat de chaque opération.