【Python対応】Discord Webhookの使い方｜Botとの違い・設定方法・通知を送るサンプルコード

Raspberry Piやパソコン
        │
        │ HTTP POST
        ▼
Discord Webhook URL
        │
        ▼
指定したDiscordチャンネル

Webhook URL ＝ 通知先の住所
POSTデータ  ＝ 送る荷物
Discord     ＝ 荷物を受け取って表示する場所

{
  "content": "Raspberry Piからの通知です"
}

プログラム
   │
   │ データをください
   ▼
サービスのAPI

サービスでイベント発生
   │
   │ 自動通知
   ▼
登録されたWebhook URL

import requests
import os

class DiscordSendMessage:
    __default_token: str = '****.*********'  #トークン
    __default_channel_id: str = '*********'  #チャンネルID

    def __init__(self, token: str = __default_token, channel_id: str = __default_channel_id):
        self.__token = token
        self.__channel_id = channel_id

    def send_discord_message(self, file_path: str = None, message: str = ""):
        url = f"https://discord.com/api/v10/channels/{self.__channel_id}/messages"
        headers = {
            "Authorization": f"Bot {self.__token}"
        }

        # ファイルが指定されていない or 存在しない場合は、メッセージのみ送信
        if not file_path or not os.path.isfile(file_path):
            headers["Content-Type"] = "application/json"
            data = {
                "content": message
            }
            response = requests.post(url, headers=headers, json=data)
            if response.status_code == 200:
                print("メッセージのみ送信完了")
            else:
                print(f"メッセージ送信失敗: {response.status_code}, {response.text}")
            return

        # ファイルが存在する場合は、ファイル + メッセージを送信
        try:
            with open(file_path, 'rb') as file:
                files = {
                    'file': (os.path.basename(file_path), file)
                }
                data = {
                    "content": message
                }
                response = requests.post(url, headers=headers, data=data, files=files)

            if response.status_code == 200:
                print(f"ファイル送信完了: {file_path}")
            else:
                print(f"ファイル送信失敗: {response.status_code}, {response.text}")
        except Exception as e:
            print(f"ファイル送信中にエラーが発生しました: {e}")
            # 送信失敗しても、メッセージだけ送る
            self.send_file(file_path=None, message=message)

if __name__ == "__main__":
    discord_bot = DiscordSendMessage()
    file_path = r'C:\Users\***\***.jpg'
    message = 'abcdefg'
    discord_bot.send_discord_message(file_path=file_path,message=message)

import requests
import os

import discord_send_message

discord_bot = discord_send_message.DiscordSendMessage()　# インスタンス化
file_path = 'C:\***\***\***\***.jpg' # 送信したいファイルパス
message = 'abcdef' # 送信したい文字列
discord_bot.send_discord_message(file_path=file_path,message=message)

discord_bot.send_discord_message(file_path=url_images_data+"kaime.jpg", message=f'<@{******}>'+comment)