Chaque point de terminaison conserve un journal des requêtes qui lui sont adressées (Notiondesk). Ce journal vous permet de voir ce que votre serveur a reçu, pourquoi une requête a échoué et quand elle sera réessayée.
Consultez les dernières livraisons
- Accédez à Paramètres > Développeurs > Webhooks .
- Cliquez sur le point de terminaison.
- Défilez jusqu'aux livraisons récentes .

Cette liste présente les 100 dernières interventions effectuées au cours des 14 derniers jours. Chaque ligne indique l'événement, le centre d'aide (ou l'espace de travail ) d'origine, le résultat et l'heure.
| Icône | Statut | Ce que cela signifie |
|---|---|---|
| Coche verte | Livré | Votre serveur a répondu avec le code d'état 2xx |
| Horloge orange | En attente | Message non envoyé ou en attente d'une nouvelle tentative. En cas d'échec, le résultat s'affiche, suivi de la mention « Nouvelle tentative » (par exemple : 503, nouvelle tentative). |
| Croix Rouge | Échoué | Chaque tentative a échoué. La ligne affiche le dernier résultat. |
| Gris moins | Annulé | Message non envoyé car le point de terminaison était suspendu ou désactivé, ou son centre d'aide ne pouvait plus recevoir d'événements, avant la prochaine tentative. |
Ouvrir une livraison
Cliquez sur une ligne pour l'ouvrir :
- ID de livraison : la même valeur que l’en-tête
X-ND-Delivery, vous permettant ainsi de retrouver la requête dans les journaux de votre serveur.
- Réponse : le code d’état ou la raison de l’échec, le temps de réponse du serveur et le nombre de tentatives effectuées.
- Corps de la requête : le JSON exact qui a été envoyé. Cliquez sur Copier pour le copier.

Les corps des réponses ne sont pas conservés. Pour les événements contenant des données personnelles, comme les messages de contact, les commentaires, les demandes d'adhésion à une équipe ou les demandes de participation, le corps de la requête est supprimé une fois la transmission terminée.
Tentatives
Une livraison échoue lorsque votre serveur répond avec un code d'état autre que 2xx, effectue une redirection, ne commence pas à répondre dans les 5 secondes ou prend plus de 10 secondes au total. Notiondesk tente alors une nouvelle livraison.
| Essayer | Quand |
|---|---|
| 1 | Tout de suite |
| 2 | 1 minute après le premier essai |
| 3 | 10 minutes après le deuxième essai |
| 4 | 1 heure après la troisième tentative |
| 5 | 6 heures après la quatrième tentative |
Après 5 tentatives infructueuses, la livraison est marquée comme ayant échoué . Les événements de test et les livraisons marquées comme ayant échoué à la signature ne sont pas retentés.
Lors de multiples événements simultanés, par exemple une synchronisation importante, les livraisons peuvent attendre avant d'être envoyées : généralement quelques minutes, et jusqu'à une heure si votre serveur est lent à répondre. Elles restent en attente et ne sont pas abandonnées.
Lorsqu'un point de terminaison est mis en pause
Notiondesk suspend un point de terminaison lorsque 10 envois consécutifs échouent après toutes leurs tentatives, et que le premier de ces échecs remonte à au moins 24 heures. Les événements de test ne sont pas pris en compte.
Lorsqu'un point de terminaison est mis en pause :
- L'état « En pause » s'affiche et la réception des événements est interrompue. Les tentatives déjà planifiées sont annulées.
- Le propriétaire de l'espace de travail et les administrateurs reçoivent un seul e-mail, intitulé « Point de terminaison Webhook suspendu », contenant le nom du point de terminaison, son hôte et un lien vers vos paramètres Webhook.
- Les événements survenus pendant la période de suspension ne sont pas envoyés ultérieurement.

Pour résumer :
- Réparez votre serveur. Les raisons de l'échec, indiquées dans la section « Livraisons récentes », vous expliquent ce qui s'est mal passé.
- Cliquez sur Envoyer l'événement de test et vérifiez qu'il apparaît comme Livré .
- Cliquez sur Reprendre .
Le point de terminaison recommence à recevoir de nouveaux événements et son compteur d'échecs est remis à zéro.
Si votre point de terminaison est toujours actif mais que les livraisons continuent d'échouer, la page du point de terminaison affiche « Échec depuis » avec la date du premier échec, à titre d'avertissement avant sa suspension.
Résoudre les problèmes de livraison.
Lorsque votre serveur a répondu, la ligne affiche son code d'état. Sinon, elle affiche la raison.
| Raison | Ce que vous voyez | Ce qui s'est passé | Comment le réparer |
|---|---|---|---|
| État d'erreur | Le code d'état, comme 500 ou 401 | Votre serveur a répondu par une erreur | Consultez les journaux de votre serveur pour cette période. Assurez-vous que le point de terminaison accepte les requêtes POST et que votre vérification de signature utilise le secret approprié. |
| Redirection refusée | Un code de redirection, comme 301 ou 302 | Votre serveur a redirigé la requête | Saisissez l'URL finale dans les paramètres du point de terminaison |
| Adresse bloquée | Adresse bloquée | Votre domaine pointe vers une adresse privée ou interne | Orienter le domaine vers un serveur public |
| Échec de la connexion | Échec de la connexion | Notiondesk n'a pas pu joindre votre serveur | Vérifiez que le domaine est résolu, que le certificat TLS est valide et que le port 443 ou 8443 est ouvert. |
| Délai d'attente dépassé | Délai d'attente dépassé | Votre serveur n'a pas commencé à répondre dans les 5 secondes, ou a mis plus de 10 secondes. | Répondez d'abord avec 200, puis effectuez le travail en arrière-plan. |
| La signature a échoué. | La signature a échoué. | Notiondesk n'a pas pu signer la demande | Ce problème vient de notre côté et n'est pas retenté. Veuillez envoyer un événement de test et nous contacter s'il se reproduit. |
Envoyer un événement de test
Cliquez sur « Envoyer un événement de test » sur la page du point de terminaison pour envoyer un événement ping à ce point de terminaison. Il apparaît en haut de la liste des livraisons récentes .
- Un événement de test est envoyé une seule fois, sans nouvelle tentative.
- Vous pouvez l'envoyer pendant que le point de terminaison est en pause, afin de vérifier votre correction avant de reprendre.
- Chaque espace de travail peut envoyer jusqu'à 20 événements de test par heure. Au-delà, le message « Trop d'événements de test. Veuillez réessayer plus tard. » s'affiche.
Questions fréquentes
Puis-je renvoyer un envoi qui a échoué ?
Non. Ouvrez le colis et cliquez sur Copier pour obtenir le corps de la demande si vous devez la traiter vous-même.
Pourquoi le corps de la requête de livraison est-il manquant ?
L'événement contenait des données personnelles, son contenu a donc été supprimé une fois la livraison terminée.
Combien de temps les livraisons sont-elles conservées ?
14 jours. Les livraisons récentes affichent les 100 dernières.
Un événement de test réussi permet-il de reprendre un point de terminaison mis en pause ?
Non. Cela vérifie uniquement votre serveur. Cliquez sur Reprendre pour recommencer à recevoir les événements.
Que deviennent les événements mis en file d'attente si je supprime un point de terminaison ?
Elles ne sont pas envoyées, et le journal de livraison du point de terminaison est supprimé en même temps.