ゲームの更新をDiscordに自動で流す|ウェブフックの手順と制限
ウェブフックは、自動メッセージやデータの更新情報をサーバー内のテキストチャンネルに送る機能です。作る場所は、サーバー設定の「連携サービス」で、「ウェブフックを作成」を押します。
ウェブフックを作る設定
ウェブフックを作る設定
| 項目 | 内容 |
|---|---|
| 作る場所 | 「サーバー設定」を開き、「連携サービス」タブを開く。「ウェブフックを作成」ボタンをクリックして、ウェブフックを新規作成する |
| 決める項目 | アバターを編集する(左上にある名前横のアバターをクリックする)。ウェブフックが通知するチャンネルを選択する(ドロップダウンメニューで通知先のテキストチャンネルを選択する)。ウェブフックへの名前付けをする |
| URL | 「ウェブフック URL をコピー」ボタンで URL を取る。「サーバーにウェブフックのエンドポイントを作成すると、ウェブフック URL が生成される」 |
| つなぐ先の例 | 使用可能:GitHub・CircleCI・DataDog。使用不可:Twitch / YouTube・Facebook・ハムスターの Nelly |
送るときの決まり(Execute Webhook)
送るときの決まり(Execute Webhook)
| 項目 | 内容 |
|---|---|
| 送り方 | POST で /webhooks/{id}/{token} に送る |
| 中身 | content・embeds・components・file・poll のうち少なくとも1つに値が要る |
| content の長さ | 2000字まで |
| embeds | 10個まで |
| 名前の上書き | username で、ウェブフックの既定の名前を上書きできる |
| フォーラム・メディアのチャンネル | thread_id か thread_name が要る。thread_id は、ウェブフックのチャンネル内の指定したスレッドにメッセージを送る。thread_name は、作るスレッドの名前で、ウェブフックのチャンネルがフォーラムかメディアのチャンネルであることが要る |
| 戻り値 | wait の指定で、メッセージか 204 No Content が返る |
GitHub と組み合わせる例
GitHub と組み合わせる例
| 手順 | 内容 |
|---|---|
| Discord 側 | 「ウェブフック URL をコピー」ボタンで、このチャンネルの URL をコピーする |
| GitHub 側 | 更新情報を受け取りたいリポジトリを選び、「設定」>「ウェブフック」メニューに移動する。「ウェブフックを追加」ボタンをクリックし、「Payload URL」欄に Discord が生成した URL を入力する |
| 正しく表示させる設定 | Payload URL には、ウェブフック URL の末尾に「/github」を付けた URL を入れる。コンテンツの種類は application/json を指定する。Discord のウェブフック形式は JSON が標準。どのイベントでウェブフックのメッセージを連動させるかを設定できる。イベント通知の設定オプションの下にある「ウェブフックを追加」ボタンをクリックして、完了 |
つながりを図で見る
更新が Discord のチャンネルに出るまで
自分で描いた図です(2026-11-06)。
手順
- Discord のサーバー設定の『連携サービス』を開く
- 『ウェブフックを作成』で新しいウェブフックを作る
- アバター・通知するチャンネル・名前を決める
- 『ウェブフック URL をコピー』で URL を取る
- つなぐ先のサービスに URL を貼る
- 自分のコードから送るなら、開発者向けのページの Execute Webhook の決まり(content の2000字まで・embeds は10個まで)に沿って POST する
- 更新を流して、チャンネルに出るのを確かめる
失敗を避ける注意
- URL に token が入る。
- ウェブフックは単独では動かず、通知先のサービスが要る。
- Twitch・YouTube は使用不可の一覧に入っている。
- content は2000字まで。
- フォーラムかメディアのチャンネルは thread_id か thread_name が要る。
次に読む
情報源
- ウェブフックのご紹介(Discord ヘルプ・更新日 2026年05月15日)https://support.discord.com/hc/ja/articles/228383668-%E3%82%A6%E3%82%A7%E3%83%96%E3%83%95%E3%83%83%E3%82%AF%E3%81%AE%E3%81%94%E7%B4%B9%E4%BB%8B確認日 2026-11-06
- Webhook Resource(Discord の公式ドキュメント)https://docs.discord.com/developers/resources/webhook確認日 2026-11-06
- Creating webhooks(GitHub Docs)https://docs.github.com/en/webhooks/using-webhooks/creating-webhooks確認日 2026-11-06