O que é
Incoming webhook. Relatório chega como mensagem com o resumo; alerta leva severidade, origem e link de volta para o console.
Configurar
Cerca de 3 minutos até um canal funcionando.
- 01Crie um app no Slack com Incoming Webhooks. Abra api.slack.com/apps → Create New App → From scratch. No app, abra Incoming Webhooks, ligue, e clique em “Add New Webhook to Workspace”. O Slack pergunta em qual canal ele pode postar.
- 02Copie a URL do webhook. Ela tem a forma https://hooks.slack.com/services/T…/B…/… . Cole aqui. Testar posta uma mensagem curta nesse canal — se ela chegar, todo o resto chega.
- 03Ligue a um relatório ou a uma rota de alerta. Relatório → Destinos → Canal manda o resumo do resultado. Monitoramento → Rotas de alerta → adicione este canal como etapa: monitor caído, host offline e falha de qualidade chegam com severidade e link.
- 04Opcional: anexar o arquivo do resultado. Webhook não sobe arquivo. Se quiser o CSV ou XLSX no Slack, dê ao app o escopo files:write, instale, cole o bot token (xoxb-…) e ponha o id do canal no Target da rota.
- 05Silencie o que não quer ouvir. Relatório que manda toda hora num canal cheio vira mudo para todo mundo. Use regras de relatório (pular quando vazio, entregar só acima de N linhas) para o Slack só ouvir o que vale a leitura.
Campos
| Campo | Obrigatório | O que é |
|---|---|---|
| URL do webhook | Sim | Da página Incoming Webhooks do app. Presa a um canal; tratada como segredo. (https://hooks.slack.com/services/T000/B000/XXXX) |
| Bot token (opcional) | Não | Só para subir arquivo. Precisa do escopo files:write e do app instalado no workspace. (xoxb-…) |
O que vai em Target
Opcional. Um incoming webhook fica preso a um canal do Slack na hora em que é criado, então o Target é ignorado para mensagens. Com bot token, o Target é o id do canal (C0123…) para onde o arquivo do resultado é enviado.
Target é opcional neste canal. — id do canal para anexar arquivo (opcional)
Testar
Cada canal tem o botão Testar na lista de canais (Configurações → Canais). O resultado fica guardado — data, status e o erro do provedor quando houve — e um canal nunca testado aparece marcado na lista.
Testar posta "DataRunner channel test ✅" no canal ao qual o webhook está preso. Se a mensagem chegar, todo o resto chega.
Conferir de ponta a ponta
- 01Relatório: abra um relatório, adicione este canal em Destinos (com o Target, se o canal pede), clique em Executar agora e abra a execução. O log diz por qual canal cada destinatário foi e o que o provedor respondeu.
- 02Alerta: em Monitoramento → Rotas de alerta, crie uma rota com este canal como passo de escalação. A rota casa por severidade e origem; a primeira que casar vence.
- 03Para disparar um alerta sem derrubar nada: crie um monitor HTTP apontando para uma URL que responde erro (por exemplo https://httpstat.us/500) com intervalo curto. Quando ele cair, o alerta sai pela rota; apague o monitor depois. A mensagem traz um link de reconhecimento — clique nele e a escalação para.
- 04Regras de relatório (linhas novas, valor fora da faixa) chegam pela mesma rota, com origem "regra de relatório".
O que mais costuma dar errado
Um webhook posta em exatamente um canal do Slack — o escolhido quando o webhook foi criado. Para alcançar #alertas e #relatorios, crie dois canais aqui, cada um com a própria URL. A URL é segredo: quem a tiver posta em seu nome.