Discord Webhook テスター

Discord の Webhook を数秒でテストできます。URL を貼り付けて検証し、テストメッセージを送って動作を確認してください。

Discord の Webhook とは

Discord の Webhook は、ボットを使わずに特定の Discord チャンネルへメッセージを送信できる固有の URL です。GitHub の通知、サーバー監視のアラート、CI/CD パイプラインの更新、独自の連携などによく使われます。Webhook にはそれぞれ名前とアバターがあり、特定のチャンネルに紐づいています。

Discord の Webhook を作成する手順

1. Discord サーバーを開き、サーバー設定 を開きます
2. 連携サービス > ウェブフック に移動します
3. 新しいウェブフック をクリックします
4. 名前を付けて、投稿先のチャンネルを選びます
5. ウェブフック URL をコピー をクリックします
6. 上のテスターに URL を貼り付けて、動作を確認します

このテスターの仕組み

Webhook の URL を貼り付けて「チェック」をクリックします。ツールが Discord API に対して URL を検証し、Webhook の名前、アバター、紐づくチャンネルを表示します。有効であれば、任意のメッセージを入力して Webhook 経由で送信し、動作を確認できます。Webhook の URL はセキュリティ上の理由で当社サーバーを経由しますが (ブラウザは CORS のため Discord API を直接呼び出せません)、保存もログ記録もされません。

Discord Webhook のよくあるエラーコード

Webhook のリクエストが失敗すると、Discord は数値の code と message を含む JSON ボディとともに HTTP ステータスを返します。実際に遭遇するのは次のものです。

• 400 Bad Request - JSON ボディが不正、埋め込みが合計 6,000 文字を超えている、またはフィールドの長さが上限を超えています。送信前にペイロードをローカルで検証してください。
• 401 Unauthorized - Webhook のトークンが誤っているか、再生成されています。サーバー設定で Webhook を再生成すると、古い URL は即座に無効になります。
• 404 Not Found - Webhook が削除された、チャンネルが削除された、または URL に打ち間違いがあります。サーバー設定 > 連携サービス から URL をコピーし直してください。
• 429 Too Many Requests - レート制限にかかりました。Discord は再試行のタイミングを示す retry_after フィールド (秒) を返します。必ず従ってください。
• Code 50027 (Invalid Webhook Token) - 401 と同じ原因で、URL のトークン部分が壊れているか切り詰められている場合に返ります。
• Code 50006 (Cannot send empty message) - ペイロードに content も embeds も files もありません。少なくとも 1 つは必要です。
• Code 50035 (Invalid Form Body) - 最も多い原因は、embed.color を 10 進数の整数ではなく 16 進数の文字列で送っていることです。送信前に #9B59B6 を 10181046 に変換してください。

Discord Webhook のレート制限

Discord は Webhook 単位とチャンネル単位でレート制限を適用します。バケットの正確な大きさは固定値ではなくサーバー側で決まり、レスポンスヘッダーで示されます。成功したレスポンスには必ず X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset-After が含まれます。次のリクエストの計画にはこれらを読み取り、固定のレートをハードコードしないでください。429 のレスポンスボディには retry_after の値 (秒) も含まれます。大量に送信する連携 (ビルドパイプライン、ログ集約) では、複数のイベントを 1 通のメッセージにまとめてください。Webhook 1 回の呼び出しで最大 10 個の埋め込みを、埋め込みあたり合計 6,000 文字まで送れるため、たいていはイベントの集中を 1 リクエストに収められます。

Webhook のセキュリティ対策

Webhook の URL はベアラー資格情報です。完全な URL を持っている人は誰でも、追加の認証なしに Webhook のボットとしてチャンネルに投稿できます。パスワードと同じように扱ってください。

• Webhook の URL を公開 Git リポジトリにコミットしないでください。GitHub のシークレットスキャンは漏えいした Discord の Webhook を自動的に検出して無効化しますが、それは公開されてしまった後の話です。
• Webhook の URL は環境変数やシークレットマネージャーに保存し、ソースコードやバージョン管理下の設定ファイルには置かないでください。
• Webhook が漏えいした場合は、サーバー設定 > 連携サービス > ウェブフック からすぐに削除してください。作り直すと新しいトークンが発行され、古い URL は使えなくなります。
• クライアント側で使う場合 (ブラウザアプリから Discord に投稿する場合) は、自前のバックエンド経由で呼び出し、URL がユーザーのブラウザに渡らないようにしてください。ブラウザアプリから漏れた URL は荒らしを呼び込みます。
• Discord の Webhook は、allowed_mentions で明示的に許可しない限り @everyone と @here のメンションを無視します。メンションの通知が不要なら "parse": [] を設定してください。

curl による手動の Webhook テスト

ターミナルからテストしたい場合、最小のペイロードは content フィールド 1 つだけです。POST に成功すると空のボディで HTTP 204 が返り、URL に ?wait=true を付けると作成されたメッセージの JSON とともに HTTP 200 が返ります。メッセージ ID が必要なときは ?wait=true を使ってください (たとえば後から /webhooks/<id>/<token>/messages/<message_id> エンドポイントでメッセージを編集・削除する場合です)。

無料の Discord ツールをもっと見る

• Snowflake Checker - Discord アカウントの作成時期を調べる
• Colored Text Generator - ANSI コードで色付きメッセージを作る
• Message Length Counter - メッセージが Discord の上限に収まるか確認する
• Color Role Previewer - すべての Discord テーマでロールの色をプレビューする

Powered by Pigona - Discord 向けの無料翻訳