Alertas
Discord

Alertas no Discord

Receba notificações de queda e recuperação diretamente em um canal do seu servidor Discord.

⚠️

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

Como funciona

O TheAlert usa Webhooks nativos do Discord para enviar mensagens em canais específicos. Não é necessário criar um bot — o webhook é suficiente.

Passo 1: Criar o Webhook no Discord

  1. Abra o Discord e acesse o servidor onde deseja receber os alertas
  2. Clique com o botão direito no canal desejado (ou no ícone de engrenagem ao lado do canal)
  3. Selecione "Editar Canal"
  4. Vá na aba "Integrações"
  5. Clique em "Webhooks" → "Novo Webhook"
  6. Configure:
    • Nome: TheAlert (aparecerá como nome do remetente no canal)
    • Canal: confirme o canal correto
    • Opcionalmente, adicione uma foto de perfil para o bot
  7. Clique em "Copiar URL do Webhook"

A URL tem o formato:

https://discord.com/api/webhooks/000000000000000000/xxxxxxxxxxxxxxxxxxxx

Crie um canal específico para alertas, como #infra-alertas ou #monitoramento. Isso evita que as notificações se misturem com conversas da equipe.

Passo 2: Configurar no TheAlert

  1. No TheAlert, acesse "Integrações"
  2. Clique em "+ Nova Integração" → Discord
  3. Preencha:
    • Nome: identificação (ex: Discord — #infra-alertas)
    • Webhook URL: cole a URL copiada do Discord
  4. Clique em "Salvar"
  5. Clique em "Testar" para verificar que a mensagem aparece no canal

O que aparece no Discord

O TheAlert envia mensagens formatadas com embeds do Discord:

Alerta de queda:

🔴 Monitor DOWN
━━━━━━━━━━━━━━━━━━
Monitor:  API de Pagamentos
URL:      https://api.pagamentos.com.br
Erro:     connect ETIMEDOUT
Horário:  15:32:10 BRT

Alerta de recuperação:

🟢 Monitor RECOVERED
━━━━━━━━━━━━━━━━━━
Monitor:  API de Pagamentos
Duração:  8 minutos
Horário:  15:40:22 BRT

Permissões necessárias

Para criar um webhook em um canal, você precisa ter a permissão "Gerenciar Webhooks" no servidor Discord. Se não tiver essa permissão, peça ao administrador do servidor.

Múltiplos servidores ou canais

Você pode criar múltiplas integrações Discord, cada uma com um webhook diferente:

  • Um webhook por servidor (ex: servidor da equipe de infra, servidor da equipe de produto)
  • Um webhook por canal com diferentes sets de monitores

Planos

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

Solução de problemas

Mensagem de teste não apareceu no canal

  • Confirme que a URL do webhook está correta (sem espaços ou caracteres extras)
  • Verifique se o webhook ainda existe: Discord → Canal → Integrações → Webhooks
  • Webhooks podem ser deletados acidentalmente. Crie um novo se necessário.

Mensagens chegando em canal errado

  • Verifique o canal selecionado ao criar o webhook
  • Crie um novo webhook no canal correto e atualize a URL no TheAlert

Próximos passos

SlackTelegram