Enviando Mensagens para Canais do Discord via Webhooks em Python
Enviando Mensagens para Canais do Discord via Webhooks em Python
A integração com webhooks do Discord é a forma mais prática de notificar equipes sobre alertas de infraestrutura, relatórios de deploys ou falhas em sistemas. Utilizando a biblioteca
requests, este snippet dispara requisições HTTP POST enviando um payload formatado em JSON diretamente para o canal configurado.Python
import requests
def enviar_notificacao_discord(url_webhook: str, mensagem: str, nome_bot: str = "StatusBot") -> bool:
"""Envia uma mensagem de texto simples para um canal do Discord via Webhook."""
payload = {
"content": mensagem,
"username": nome_bot
}
try:
# Realiza o envio via POST com o payload serializado em JSON
resposta = requests.post(url_webhook, json=payload, timeout=5)
# O Discord retorna status 204 No Content para envios bem-sucedidos
if resposta.status_code == 204:
print("Notificação enviada com sucesso ao Discord!")
return True
else:
print(f"Falha no envio: HTTP {resposta.status_code} - {resposta.text}")
return False
except requests.exceptions.RequestException as e:
print(f"Erro de conexao ao disparar webhook: {e}")
return False
# --- Exemplo de Uso Prático ---
if __name__ == "__main__":
# Substitua pela URL real do Webhook do seu servidor Discord
URL_WEBHOOK_DISCORD = "https://discord.com/api/webhooks/123456789/SUA_CHAVE_AQUI"
texto_alerta = "🚨 **Alerta de Deploy**: A nova versao da API v2 foi implantada no ambiente de producao."
enviar_notificacao_discord(
url_webhook=URL_WEBHOOK_DISCORD,
mensagem=texto_alerta,
nome_bot="Deploy Sentinel"
)
Pontos-chave:
- Código de Status 204: A API do Discord retorna o status HTTP
204 No Contentquando a mensagem é aceita e processada com sucesso sem retornar corpo de resposta. - Parâmetro
jsondorequests: Utilizarjson=payloaddefine automaticamente os cabeçalhosContent-Type: application/jsone serializa o dicionário Python de forma transparente. - Suporte a Markdown: O campo
contentaceita a sintaxe padrão do Discord (como**negrito**,`código`ou emojis), facilitando a legibilidade dos alertas. - Estruturas Avançadas (Embeds): Para incluir cartões visuais com cores, links e campos separados, substitua o campo
contentpela chaveembedsno JSON de envio.

Comentários
Postar um comentário