Alertas
Slack

Alertas no Slack

Integre o TheAlert com o Slack para receber notificações de queda e recuperação diretamente nos canais da sua equipe.

⚠️

A integração com Slack requer o plano PRO ou superior.

Como funciona

O TheAlert usa Incoming Webhooks do Slack — uma URL especial que permite enviar mensagens para um canal específico sem precisar de um bot completo. A configuração leva menos de 5 minutos.

Passo 1: Criar o Incoming Webhook no Slack

  1. Acesse api.slack.com/apps (opens in a new tab)
  2. Clique em "Create New App""From scratch"
  3. Dê um nome ao app (ex: TheAlert) e selecione o Workspace
  4. Na tela do app, clique em "Incoming Webhooks"
  5. Ative a opção "Activate Incoming Webhooks"
  6. Clique em "Add New Webhook to Workspace"
  7. Selecione o canal que receberá os alertas (ex: #incidents, #infra-alerts)
  8. Clique em "Allow"
  9. Copie a Webhook URL gerada — ela tem o formato:
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Crie um canal dedicado para alertas, como #thealert-incidents ou #infra-alerts. Isso mantém as notificações organizadas e separadas das conversas da equipe.

Passo 2: Configurar no TheAlert

  1. No TheAlert, acesse "Integrações"
  2. Clique em "+ Nova Integração"Slack
  3. Preencha:
    • Nome: identificação (ex: Slack — #infra-alerts)
    • Webhook URL: cole a URL copiada do Slack
  4. Clique em "Salvar"
  5. Clique em "Testar" para enviar uma mensagem de teste ao canal

O que aparece no Slack

Alerta de queda

🔴 Monitor DOWN

API de Pagamentos está DOWN
https://api.pagamentos.com.br

Erro: connect ETIMEDOUT
Horário: 15:32:10 (BRT)

Alerta de recuperação

🟢 Monitor RECOVERED

API de Pagamentos voltou ao normal
Duração do incidente: 8 minutos
Horário: 15:40:22 (BRT)

Múltiplos canais

Você pode criar múltiplas integrações Slack, cada uma apontando para um canal diferente:

  • #infra-critical — monitores de infraestrutura
  • #produto-alertas — monitores da aplicação
  • #on-call — canal do plantão

Depois, vincule cada integração aos monitores correspondentes nas configurações de cada monitor.

Dica: canal por severidade

Crie dois canais e duas integrações:

Canal SlackMonitores
#alertas-criticosBanco de dados, API de pagamento, autenticação
#alertas-geraisSites, landing pages, métricas secundárias

Assim, o #alertas-criticos recebe atenção imediata enquanto #alertas-gerais pode ser verificado periodicamente.

Planos

PlanoSlack disponível
FREENão
STARTERNão
PROSim
BUSINESSSim

Solução de problemas

Mensagem de teste não chegou no Slack

  • Verifique se a Webhook URL está correta (sem espaços extras)
  • Confirme que o Incoming Webhook está ativo nas configurações do app no Slack
  • Verifique se o app ainda tem acesso ao workspace

App Slack foi removido do workspace Se o app for removido, a Webhook URL para de funcionar. Você precisará criar um novo app e atualizar a URL no TheAlert.

Próximos passos