Documentation · Chat

Publier dans un canal avec un webhook

Un webhook est une adresse secrète qui permet à un outil de publier dans un canal : une alerte de supervision, un déploiement terminé, un nouveau ticket.

Créer un webhook

1. Ouvrez l'espace, puis Gérer l'espace › Canaux, et la fiche du canal.
2. Section Webhooks du canal, touchez Nouveau.
3. Donnez-lui un nom (par exemple « CI » ou « Alertes prod ») : c'est le nom qui s'affichera comme auteur des messages. Touchez Créer.
4. Copier l'URL et collez-la dans votre outil.

La création est réservée aux admins de l'espace.

Publier un message

Envoyez une requête POST à l'URL du webhook, avec un corps JSON :

curl -X POST "https://app.lebigo.io/hooks/VOTRE-JETON" \
      -H "Content-Type: application/json" \
      -d '{"text": "*Déploiement terminé* sur la production"}'

• text (obligatoire) : le message, 4 000 caractères au plus. La mise en forme est la même que pour un humain (voir la mise en forme).

La réponse contient une référence : {"ok": true, "ref": "…"}.

Répondre dans le même fil

Pour que les messages suivants s'ajoutent sous le premier au lieu de créer un nouveau sujet, renvoyez la référence reçue dans le champ ref :

{"text": "Rollback effectué", "ref": "la-ref-reçue"}

Une référence ne vaut que pour le webhook qui l'a produite.

Codes de réponse