Riferimento
Webhook dei canali
Pubblicare messaggi in un canale di chat da un servizio esterno.
Aggiornato:
La presente traduzione è fornita per comodità. In caso di discrepanza, fa fede la versione inglese.
Un webhook è un URL che converte una richiesta HTTP POST in un messaggio all'interno di un singolo canale. Viene utilizzato per recapitare in Chat avvisi, esiti di build e output di monitoraggio.
Creazione di un webhook
Aprire il canale → Impostazioni → Webhook → Aggiungi. Il nome assegnato viene visualizzato come autore di ogni messaggio pubblicato tramite il webhook.
La creazione restituisce un URL contenente un token. Il token costituisce l'autorizzazione per il canale e deve essere trattato come una credenziale. Un token compromesso può essere eliminato.
Pubblicazione di un messaggio
Un corpo JSON contenente un campo 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"}'Limiti di frequenza
L'endpoint è soggetto a un limite di frequenza per indirizzo di origine, in quanto è raggiungibile senza autenticazione. I volumi di avvisi consueti non ne sono interessati.