Enviando mensagens para o Discord

Introdução

Esse pequeno artigo servirá para nos ajudar a enviar mensagens para um canal de texto do Discord. Mas para qual finalidade? Algumas empresas utilizam o Discord para trabalho no dia a dia, criando seus canais para diversas discussões e nesse momento podemos ter um canal de alertas para que nossos servidores GNU/Linux possam enviar algum alerta específico, para nos avisar de que algo está errado. A velocidade de comunicação pode nos salvar de muitos problemas evitando que algo se torne mais grave.

Por isso resolvi fazer esse doc bem simples para mostrar como é fácil e deixar registrado aqui como fonte de consulta futura.

Preparando o ambiente

Usaremos como de costume nosso bom Debian GNU/Linux mas você pode adaptar essa documentação para o seu ambiente. Nesse momento instalaremos o python3-pip e dependências:

# apt install python3-pip
# pip install requests discord discord-webhook

Configurando o canal no Discord

Nesse momento assumirei que você já tem seu servidor e sabe como criar um canal. Vamos supor que você tenha o canal de texto #alertas já criado e vamos usá-lo para receber nossas notificações dos servidores.

Você vai clicar na engrenagem do canal de texto, que nesse exemplo, é o #alertas para iniciarmos a configuração.

Na sequência você vai clicar em Integrações conforme acima.

1) Vamos usar um webhook para nos permitir enviar mensagens para o nosso canal de texto.

2) Aqui daremos um nome para ele.

3) Selecionamos o canal de texto para onde serão enviadas as nossas notificações. Nesse caso já estará selecionado nosso canal #alertas.

4) Clique ali para copiar a URL que usaremos em nosso script em Python, para enviar as notificações. Não esqueça de salvar esse webhook que acabamos de alterar.

Script em Python para envio das notificações

O script é bem simples: você precisa colar a URL do webhook que você copiou, na variável url_webhook e além dessa variável temos nome_bot e link_icone para exibirmos o nome do bot e o ícone do bot. O script pode ser rodado em linha de comando e passando apenas 2 parâmetros: o título da notificação e a mensagem da notificação que você quer enviar. O script pode ser baixado do Github: https://github.com/gondimcodes/envia_notificacao_discord

Testando nosso script

Abaixo vamos executar o nosso script em python e verificar se chega a mensagem no nosso canal de texto, lá no Discord.

# chmod +x envia_notificacao_discord.py
# ./envia_notificacao_discord.py "ALERTA RJO-DC01-DNS-RECURSIVO01" "Falha no sistema de arquivos."

Finalizando

Um artigo bem simples mas que pode ser útil em monitoramento de sistemas e onde você pode integrar com diversas soluções para disparar alertas para um servidor seu no Discord.

Como referência da função que usei: https://pypi.org/project/discord-webhook/

Essa documentação foi útil? Compartilhe, divulgue e ajude outras pessoas. Meus contatos podem ser vistos aqui.