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 Content quando a mensagem é aceita e processada com sucesso sem retornar corpo de resposta.

  • Parâmetro json do requests: Utilizar json=payload define automaticamente os cabeçalhos Content-Type: application/json e serializa o dicionário Python de forma transparente.

  • Suporte a Markdown: O campo content aceita 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 content pela chave embeds no JSON de envio.

Comentários

Postagens mais visitadas deste blog

Gerando Relatórios em PDF com Python (ReportLab e FPDF)

Python para Computação Quântica: Introdução com Qiskit

C# e Banco de Dados: Como Conectar e Realizar Operações com SQL Server