Référence
Webhooks de canal
Publier des messages dans un canal de discussion depuis un service externe.
Mis à jour:
Cette traduction est fournie pour votre commodité. En cas de divergence, la version anglaise prévaut.
Un webhook est une URL qui convertit une requête HTTP POST en message dans un canal unique. Il sert à acheminer vers Chat des alertes, des résultats de compilation et des sorties de supervision.
Création d'un webhook
Ouvrir le canal → Paramètres → Webhooks → Ajouter. Le nom attribué est affiché comme auteur de chaque message publié par ce biais.
La création renvoie une URL contenant un jeton. Le jeton constitue l'autorisation d'accès au canal et doit être traité comme un identifiant de connexion. Un jeton compromis peut être supprimé.
Publication d'un message
Un corps JSON contenant un champ text.
curl -X POST https://app.beskos.com/api/public/chat/hook/<token> \
-H 'Content-Type: application/json' \
-d '{"text": "Deploy finished: build 1284 is live"}'Limites de débit
Le point de terminaison est soumis à une limite de débit par adresse source, car il est accessible sans authentification. Les volumes d'alertes habituels ne sont pas concernés.