【PythonでDiscord自動通知】Webhookを使って、プログラムからメッセージを送る方法を徹底解説！🤖

7月 23, 2025

「長時間かかる処理の終了を、外出先からでも知りたい…」
「株価分析スクリプトで買いシグナルが出たら、すぐにDiscordに通知が欲しい！」
「PythonからDiscordにメッセージを送るのって、Botを作らないとダメ？難しそう…」

こんにちは！ Pythonプログラミング探検隊、隊長のPythonistaです！これまで私たちは、データ分析やファイル操作など、PC内で完結する様々なツールを作ってきましたね。今回は、その一歩先へ進み、あなたのPythonプログラムを外部のコミュニケーションツールと連携させる、非常に実用的でエキサイティングなプロジェクトに挑戦します。

テーマは、「PythonからDiscordへ自動でメッセージを送信する」です！複雑なBotの設定は一切不要。「Webhook（ウェブフック）」という仕組みを使うことで、驚くほど簡単に実現できます。この記事を読めば、あなたの作ったプログラムが、まるで生きているかのようにDiscordの特定のチャンネルに状況を報告してくれるようになります。さあ、あなたのプログラムに「話す力」を与えてあげましょう！

1. 魔法のURL「Webhook」とは？

今回のプロジェクトの鍵となるのが、Webhook（ウェブフック）です。難しく考える必要はありません。これは、

「特定のDiscordチャンネル専用の、メッセージ投稿用URL」

だと考えてください。このURLさえ知っていれば、誰でも（どのプログラムでも）そのチャンネルにメッセージを投稿できます。Botのようにサーバーに常駐させたり、複雑な権限設定をしたりする必要がないため、単純な通知目的であれば非常に手軽で強力な方法です。

2. ステップ1：DiscordでWebhook URLを取得しよう

まずは、メッセージを投稿したいDiscordチャンネルで、この魔法のURLを取得します。この作業は数分で完了します。

2.1. サーバーとチャンネルを選択

通知を送りたいDiscordサーバーとチャンネルを開いてください。（テスト用に、自分だけのサーバーやチャンネルを作っておくと安心です。）

2.2. 連携サービスの設定画面を開く

チャンネル名の横にある歯車アイコン⚙️（チャンネルの編集）をクリックし、「連携サービス」タブを選択します。

2.3. 新しいWebhookを作成

「ウェブフックを作成」というボタンをクリックします。すると、「キャプテンフック」のような名前で新しいWebhookが自動的に作成されます。

2.4. WebhookをカスタマイズしてURLをコピー

作成されたWebhookをクリックすると、名前やアイコンを自由に変更できます。例えば、通知ボットらしい名前にしてみましょう。設定が終わったら、一番下にある**「ウェブフックURLをコピー」**ボタンをクリックします。これで、あなたのクリップボードに魔法のURLがコピーされました。

【重要】このURLはパスワードと同じです！
このWebhook URLを知っている人は誰でも、このチャンネルにメッセージを投稿できてしまいます。絶対に他人に教えたり、GitHubのような公開リポジトリに直接書き込んだりしないでください。

これで準備は完了です！

3. ステップ2：Pythonスクリプトでメッセージを送信する

次に、取得したWebhook URLを使って、Pythonからメッセージを送信するスクリプトを作成します。

3.1. 必要なライブラリの準備

Webにリクエストを送るための`requests`ライブラリが必要です。まだインストールしていない場合は、ターミナルでインストールしてください。

pip install requests

3.2. スクリプトの全体像（完成コード）

以下のコードをdiscord_sender.pyなどの名前で保存してください。

import requests
import json

# ▼▼▼ ステップ1でコピーしたあなたのWebhook URLをここに貼り付けてください ▼▼▼
WEBHOOK_URL = "ここにあなたのWebhook URLを貼り付けてください"

# 送信するメッセージの内容
message_content = "こんにちは！ Pythonスクリプトからのテスト送信です。成功！"

def send_discord_message(webhook_url, content):
    """
    指定されたWebhook URLにメッセージを送信します。
    """
    # Webhook URLが空でないか、正しい形式か簡単なチェック
    if not webhook_url or "discord.com/api/webhooks/" not in webhook_url:
        print("エラー: Webhook URLの形式が正しくないようです。")
        print("URLが 'https://...discord.com/api/webhooks/...' の形式か確認してください。")
        return

    # Discordに送信するデータ（ペイロード）を辞書で作成
    payload = {
        "content": content
    }

    # データをJSON形式で送信することを伝えるためのヘッダー
    headers = {
        "Content-Type": "application/json"
    }

    try:
        # requests.postを使って、Webhook URLにJSON形式でデータを送信
        response = requests.post(webhook_url, data=json.dumps(payload), headers=headers)

        # 応答のステータスコードを確認 (204 No Content は成功)
        if 200 <= response.status_code < 300:
            print("メッセージが正常に送信されました。")
        else:
            print(f"メッセージの送信に失敗しました。ステータスコード: {response.status_code}")
            print(f"応答内容: {response.text}")

    except requests.exceptions.RequestException as e:
        print(f"リクエスト中にエラーが発生しました: {e}")

if __name__ == "__main__":
    # WEBHOOK_URLとmessage_contentが空でないことを確認
    if WEBHOOK_URL != "ここにあなたのWebhook URLを貼り付けてください" and message_content:
        send_discord_message(WEBHOOK_URL, message_content)
    elif WEBHOOK_URL == "ここにあなたのWebhook URLを貼り付けてください":
         print("エラー: スクリプト内のWEBHOOK_URLをあなたのURLに書き換えてください。")
    else:
         print("メッセージ内容が空です。")

3.3. コードのポイント解説

payload = {"content": content}: DiscordのWebhookは、{"content": "メッセージ本文"}というキーと値のペアを持つJSON形式でデータを受け取るのが基本です。この辞書がその元になります。
headers = {"Content-Type": "application/json"}: 送信するデータがJSON形式であることを、サーバーに伝えるためのヘッダー情報です。
requests.post(...): Webページを取得する際はrequests.get()を使いましたが、今回はこちらからデータを送信するのでrequests.post()を使います。
json.dumps(payload): Pythonの辞書（payload）を、HTTPで送信可能なJSON形式の文字列に変換（シリアライズ）しています。
response.status_code: メッセージが正常に送信されると、Discordサーバーは「成功しました（中身は空です）」という意味の204 No Contentというステータスコードを返します。200番台は基本的に成功を意味します。

4. 実行してみよう！

上記のコードをdiscord_sender.pyとして保存します。
コード冒頭のWEBHOOK_URL = "..."の部分を、あなたがステップ1でコピーした**あなた自身のWebhook URL**に書き換えます。
ターミナルを開き、スクリプトを実行します。
python discord_sender.py
「メッセージが正常に送信されました。」と表示されれば成功です！

あなたのPythonプログラムが、Discordの世界と繋がった瞬間です！

5. 応用例と今後の発展

このsend_discord_message()関数は、様々なプログラムに組み込むことで真価を発揮します。

株価分析ツールとの連携: 買いシグナルや売りシグナルが検出されたら、その銘柄名とシグナルの種類をDiscordに通知する。
Webスクレイピングとの連携: 長時間かかるスクレイピング処理が完了した時や、監視しているサイトに更新があった時に通知する。
サーバー監視: Raspberry Piやサーバー上で動かしているプログラムでエラーが発生した際に、そのエラー内容をtry-exceptでキャッチしてDiscordに送信する。
リッチなメッセージ（埋め込み）: DiscordのWebhookは、単なるテキストだけでなく、色や画像、複数のフィールドを持つ「埋め込み(Embed)」というリッチなメッセージも送信できます。興味のある方は「Discord Webhook Documentation」などを参考に、payloadの構造をより複雑にしてみるのも面白い挑戦です。

まとめ

今回は、PythonからDiscordに自動でメッセージを送信する方法を学びました。複雑なBot開発は不要で、

DiscordでWebhook URLを取得する。
requestsライブラリを使って、そのURLにJSON形式でPOSTリクエストを送信する。

という、非常にシンプルな仕組みで実現できることがお分かりいただけたかと思います。この簡単な通知機能一つで、あなたの作るプログラムの実用性は格段に向上します。ぜひ、あなたの様々なプロジェクトに組み込んで、活用してみてください！

【Pythonスクリプト改善】Discord自動通知を強化！複数ドメインURLに対応する、より頑丈なコードの書き方 🛡️

その他の投稿はこちら

このブログを検索

0から始めるPython