Recevoir les alertes par webhook

1. Préparez un point d'accès

N'importe quelle URL https qui accepte un POST et répond avec un statut 2xx en moins de 8 secondes : votre propre service, une fonction serverless, ou un « catch hook » dans un outil no-code (nœud Webhook de n8n, Webhooks by Zapier → Catch Hook dans Zapier, Webhooks → Custom webhook dans Make).

Elle doit être joignable depuis Internet : Mortemain refuse les adresses privées et internes, et ne suit pas les redirections, donnez-lui donc l'URL finale.

2. Ajoutez la cible dans Mortemain

Dans votre tableau de bord Mortemain, ajoutez une cible de notification :

• Type → Webhook
• Nom → ce que vous voulez, par ex. Pont incidents
• URL → votre point d'accès

Enregistrez, puis reliez-la aux checks qui vous intéressent.

3. Ce que Mortemain envoie

À chaque changement d'état d'un check relié, un POST avec Content-Type: application/json et un en-tête Idempotency-Key :

{
  "check": "Sauvegarde nocturne",
  "check_id": "6f1c2b9e-0d4a-4e8b-9a51-2c7f3e1d8b40",
  "transition": "down",
  "title": "🔴 Sauvegarde nocturne · HORS SERVICE",
  "body": "Mortemain : « Sauvegarde nocturne » est HORS SERVICE (ping attendu manqué) le 2026-10-19 02:30 GMT+2.",
  "at": "2026-10-19T00:30:00.000Z",
  "at_local": "2026-10-19 02:30 GMT+2",
  "idempotency_key": "4812:1"
}

• transition : ce qui s'est passé, sous forme de code stable jamais traduit. C'est sur lui qu'il faut aiguiller. down (ping manqué, délai de grâce écoulé), late (en retard, encore dans le délai de grâce), fail (la tâche a signalé un échec), up (rétablie), flapping (alterne sans cesse entre état sain et retard ou panne), auth_reject (un check-in a été refusé ; seulement si vous avez activé cette alerte sur le check).
• check et check_id : le nom du check et son identifiant stable (celui de l'URL du check dans le tableau de bord).
• title et body : un texte prêt à afficher, dans la langue du propriétaire du projet.
• at : le moment de l'événement, en ISO 8601 UTC. at_local : le même instant dans le fuseau horaire du propriétaire du projet.
• idempotency_key : la même valeur que l'en-tête.

4. Livraison et nouvelles tentatives

Toute réponse 2xx compte comme livrée. Tout le reste, un dépassement de délai ou une redirection compte comme un échec et est retenté avec un délai croissant (30 secondes, puis doublé, au plus une heure d'écart), jusqu'à 8 tentatives. Une cible qui échoue sans cesse affiche un compteur d'alertes non livrées dans votre tableau de bord.

Chaque tentative porte sa propre Idempotency-Key : recevoir deux fois la même clé signifie que la même tentative est arrivée deux fois, ignorez donc le doublon. Répondez vite et faites le vrai travail ensuite, pour qu'une réponse lente ne se transforme jamais en nouvelle tentative.

Testez

Cliquez sur Tester sur la cible. Votre point d'accès reçoit une alerte d'exemple pour un check nommé Mortemain test alert, avec la transition up. Si elle n'arrive pas, la cible affiche l'erreur renvoyée par votre point d'accès.