Désactivation automatique des webhooks

MeSomb désactive automatiquement un webhook lorsque les échecs de livraison indiquent un endpoint indisponible, mal configuré ou dangereux. Les règles ci-dessous s’appliquent indépendamment en production et dans le sandbox.

Tentatives de livraison

Toute réponse HTTP 2xx confirme la réception, y compris 200 et 204. Confirmez la réception uniquement après avoir enregistré durablement l’événement ou terminé son traitement.

Les réponses HTTP 408, HTTP 429, HTTP 5xx et les erreurs réseau temporaires entraînent une nouvelle tentative. Les autres réponses HTTP 4xx terminent la livraison de cet événement sans relance automatique. Les redirections sont refusées : configurez directement l’URL HTTPS finale.

Chaque événement dispose de 6 tentatives automatiques au maximum : la tentative initiale et 5 relances. Les délais sont de 30, 60, 120, 240 et 480 secondes, auxquels s’ajoute à chaque fois un délai aléatoire allant jusqu’à 10 secondes. Ces délais de planification ne constituent pas une garantie de livraison à une heure précise.

Règles de désactivation

  • HTTP 410 : le webhook est immédiatement désactivé car l’endpoint n’est plus disponible. Motif : endpoint_gone.

  • Destination dangereuse : le webhook est immédiatement désactivé si les contrôles de sécurité refusent l’URL, le port, l’adresse résolue ou une redirection. Les adresses privées et internes sont interdites. Motif : unsafe_destination.

  • HTTP 401 ou 403 : le webhook est désactivé après 3 événements distincts consécutifs terminés par l’une de ces erreurs d’authentification. Motif : authentication_failures.

  • Échecs temporaires répétés : le webhook est désactivé lorsqu’au moins 5 événements distincts consécutifs épuisent leurs tentatives automatiques et qu’au moins 30 minutes se sont écoulées depuis le premier événement ayant épuisé ses tentatives dans cette série. Les deux conditions doivent être réunies lors de la fin en échec d’un événement. Motif : repeated_delivery_failures.

Les seuils comptent les événements en échec, et non les tentatives HTTP individuelles. Rejouer le même événement en échec ne le compte pas une seconde fois. Une livraison réussie remet les deux compteurs à zéro. Un échec définitif hors d’une catégorie interrompt la série de cette catégorie. Une réussite ne réactive jamais automatiquement un webhook désactivé.

Par exemple, 5 événements épuisant leurs tentatives en 10 minutes ne désactivent pas immédiatement le webhook. Le seuil de 30 minutes est évalué lors d’un nouvel échec définitif ; aucun minuteur ne désactive le webhook au seul motif que 30 minutes se sont écoulées.

Comportement pendant la désactivation

La désactivation automatique arrête les nouveaux envois. Les livraisons déjà en cours peuvent encore se terminer. Les événements en attente sont conservés et les nouveaux événements du webhook automatiquement désactivé continuent d’être enregistrés pour une livraison ultérieure. L’attente ne consomme pas de tentative supplémentaire.

La conservation des nouveaux événements concerne la désactivation automatique. La désactivation manuelle ou la suppression d’un webhook n’offre pas le même comportement.

Procédure de reprise

  1. Ouvrez la page Webhooks du tableau de bord MeSomb dans l’environnement concerné et consultez le motif de désactivation ainsi que l’historique des livraisons.

  2. Corrigez l’endpoint : rétablissez sa disponibilité, corrigez l’authentification ou la vérification de signature, ou configurez une URL HTTPS publique sans redirection.

  3. Réactivez explicitement le webhook. Les propriétaires, administrateurs et développeurs ayant accès à l’application peuvent effectuer cette action. Modifier uniquement l’URL ne le réactive pas.

  4. La réactivation efface le motif de désactivation et remet les compteurs à zéro, puis reprend les événements en attente. Les événements déjà marqués FAILURE ne sont pas rejoués automatiquement : rejouez-les explicitement depuis l’historique après avoir corrigé le problème.

Relance manuelle et protection contre les doublons

La relance manuelle nécessite un webhook actif et un événement en échec dont le contenu a été enregistré. Chaque événement autorise au maximum 3 relances manuelles, chacune disposant de 6 tentatives supplémentaires. Les anciens événements sans contenu enregistré ne peuvent pas être rejoués.

Les relances automatiques utilisent l’URL de destination initiale. La relance manuelle utilise l’URL actuelle du webhook. Les deux conservent l’identifiant et le contenu de l’événement ; chaque livraison utilise un nouvel horodatage de signature et le secret de signature actuel.

Utilisez X-MeSomb-Webhook-Event-Id pour détecter les livraisons en double ; dans les contenus de version 2, le champ id contient ce même identifiant. Enregistrez cet identifiant de manière atomique avec votre traitement métier et confirmez les doublons sans répéter l’opération.