INDIE INDEX

レベル:実践

ゲームの更新をDiscordに自動で流す|ウェブフックの手順と制限

公開 2026-11-06更新 2026-11-06

ウェブフックは、自動メッセージやデータの更新情報をサーバー内のテキストチャンネルに送る機能です。作る場所は、サーバー設定の「連携サービス」で、「ウェブフックを作成」を押します。

このページの目次
  1. ウェブフックを作る設定
  2. 送るときの決まり(Execute Webhook)
  3. GitHub と組み合わせる例
  4. つながりを図で見る
  5. 手順
  6. 失敗を避ける注意
  7. 次に読む
  8. 情報源

ウェブフックを作る設定

ウェブフックを作る設定

項目内容
作る場所「サーバー設定」を開き、「連携サービス」タブを開く。「ウェブフックを作成」ボタンをクリックして、ウェブフックを新規作成する
決める項目アバターを編集する(左上にある名前横のアバターをクリックする)。ウェブフックが通知するチャンネルを選択する(ドロップダウンメニューで通知先のテキストチャンネルを選択する)。ウェブフックへの名前付けをする
URL「ウェブフック URL をコピー」ボタンで URL を取る。「サーバーにウェブフックのエンドポイントを作成すると、ウェブフック URL が生成される」
つなぐ先の例使用可能:GitHub・CircleCI・DataDog。使用不可:Twitch / YouTube・Facebook・ハムスターの Nelly
表1

送るときの決まり(Execute Webhook)

送るときの決まり(Execute Webhook)

項目内容
送り方POST で /webhooks/{id}/{token} に送る
中身content・embeds・components・file・poll のうち少なくとも1つに値が要る
content の長さ2000字まで
embeds10個まで
名前の上書きusername で、ウェブフックの既定の名前を上書きできる
フォーラム・メディアのチャンネルthread_id か thread_name が要る。thread_id は、ウェブフックのチャンネル内の指定したスレッドにメッセージを送る。thread_name は、作るスレッドの名前で、ウェブフックのチャンネルがフォーラムかメディアのチャンネルであることが要る
戻り値wait の指定で、メッセージか 204 No Content が返る
表2

GitHub と組み合わせる例

GitHub と組み合わせる例

手順内容
Discord 側「ウェブフック URL をコピー」ボタンで、このチャンネルの URL をコピーする
GitHub 側更新情報を受け取りたいリポジトリを選び、「設定」>「ウェブフック」メニューに移動する。「ウェブフックを追加」ボタンをクリックし、「Payload URL」欄に Discord が生成した URL を入力する
正しく表示させる設定Payload URL には、ウェブフック URL の末尾に「/github」を付けた URL を入れる。コンテンツの種類は application/json を指定する。Discord のウェブフック形式は JSON が標準。どのイベントでウェブフックのメッセージを連動させるかを設定できる。イベント通知の設定オプションの下にある「ウェブフックを追加」ボタンをクリックして、完了
表3

つながりを図で見る

更新が Discord のチャンネルに出るまで

更新が Discord のチャンネルに出るまで1GitHub などの更新2ウェブフック URL3Discord のテキストチャンネル4URL に token が入る
図1

自分で描いた図です(2026-11-06)。

手順

  1. Discord のサーバー設定の『連携サービス』を開く
  2. 『ウェブフックを作成』で新しいウェブフックを作る
  3. アバター・通知するチャンネル・名前を決める
  4. 『ウェブフック URL をコピー』で URL を取る
  5. つなぐ先のサービスに URL を貼る
  6. 自分のコードから送るなら、開発者向けのページの Execute Webhook の決まり(content の2000字まで・embeds は10個まで)に沿って POST する
  7. 更新を流して、チャンネルに出るのを確かめる

失敗を避ける注意

  • URL に token が入る。
  • ウェブフックは単独では動かず、通知先のサービスが要る。
  • Twitch・YouTube は使用不可の一覧に入っている。
  • content は2000字まで。
  • フォーラムかメディアのチャンネルは thread_id か thread_name が要る。

次に読む

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。