Webhook

Sur cette page

Envoyez les notifications Onagre vers n'importe quel point de terminaison HTTP vous appartenant — un outil de gestion des incidents, une plateforme d'automatisation, un bot interne. Nécessite une offre payante.

Dans Onagre#

Integrations → Add integration → Webhook :

Champ	Valeur
Name	Au moins 3 caractères, par exemple `Incident bridge`.
Webhook URL	Votre point de terminaison, par exemple `https://incidents.corvane.example/hooks/onagre`. Il doit être joignable depuis Internet.

Ajoutez ensuite l'intégration à l'alerting de vos sondes.

La requête#

Onagre envoie une requête HTTP POST avec un corps JSON lorsqu'un incident s'ouvre et lorsqu'il est résolu :

JSON

{
  "sensor": {
    "code": "7c0b0a7ea1",
    "name": "Notifications — SMS gateway",
    "url": "https://app.onagre.io/sensors/json/7c0b0a7ea1",
    "isUp": false
  },
  "poll": {
    "universalDateTime": "2026-10-12T09:23:00",
    "ellapsedTime": null,
    "httpCode": "Unexpected value at $.component.status: \"degraded_performance\""
  }
}

Champ	Signification
`sensor.code`, `sensor.name`	La sonde.
`sensor.url`	Sa page dans Onagre.
`sensor.isUp`	`false` lorsque l'incident s'ouvre, `true` lorsqu'il est résolu.
`poll.universalDateTime`	Heure du contrôle, dans le fuseau horaire de votre organisation.
`poll.ellapsedTime`	À la résolution, la durée d'indisponibilité en secondes ; `null` lorsque l'incident s'ouvre.
`poll.httpCode`	L'erreur remontée par le contrôle (malgré son nom, un message plutôt qu'un code HTTP).

Bon à savoir#

La requête ne comporte ni signature ni en-tête d'authentification. Utilisez une URL difficile à deviner, et vérifiez sensor.code de votre côté.
Votre point de terminaison doit répondre en moins de 10 secondes. Les redirections ne sont pas suivies, et les adresses privées ou locales sont refusées.
Un envoi en échec n'est pas retenté ; il est enregistré comme Failed dans les notifications de l'incident.