Referência
Webhooks de canal
Publicar mensagens num canal de chat a partir de um serviço externo.
Atualizado:
Esta tradução é fornecida para conveniência. Em caso de qualquer discrepância, prevalece a versão inglesa.
Um webhook é um URL que converte um pedido HTTP POST numa mensagem num único canal. É utilizado para entregar alertas, resultados de compilação e saída de monitorização no Chat.
Criar um webhook
Abrir o canal → Definições → Webhooks → Adicionar. O nome atribuído é apresentado como autor de cada mensagem publicada através dele.
A criação devolve um URL que contém um token. O token constitui a autorização para o canal e deve ser tratado como uma credencial. Um token comprometido pode ser eliminado.
Publicar uma mensagem
Um corpo em JSON com um campo de texto.
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 ritmo
O endpoint tem limite de ritmo por endereço de origem, uma vez que é alcançável sem autenticação. Os volumes normais de alertas não são afetados.