Exibir código-fonte para Enviando mensagens para o Discord

__TOC__
[[Arquivo:Discord.png|nenhum|commoldura]]

== 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.
[[Arquivo:Discord1.png|nenhum|commoldura]]
Você vai clicar na engrenagem do '''canal de texto''', que nesse exemplo, é o '''#alertas''' para iniciarmos a configuração.
[[Arquivo:Discord2.png|nenhum|commoldura]]
Na sequência você vai clicar em '''Integrações''' conforme acima.
[[Arquivo:Discord3.png|nenhum|commoldura]]
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 abaixo é 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."
[[Arquivo:Discord4.png|nenhum|commoldura]]

==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 [[Sobre mim|aqui]].
[[Categoria:Artigos Técnicos]]