Discord Webhook 測試工具

幾秒鐘測試你的 Discord Webhook。貼上網址、驗證它，再傳送一則測試訊息，確認一切正常。

什麼是 Discord Webhook？

Discord Webhook 是一組獨一無二的網址，讓你不必用機器人也能把訊息送到特定的 Discord 頻道。Webhook 常用於 GitHub 通知、伺服器監控警報、CI/CD 流程更新以及自訂整合。每個 Webhook 都有自己的名稱與頭像，並綁定到一個特定頻道。

如何建立 Discord Webhook

1. 開啟你的 Discord 伺服器，進入伺服器設定
2. 依序進入整合 > Webhook
3. 點擊新增 Webhook
4. 設定名稱並選擇目標頻道
5. 點擊複製 Webhook 網址
6. 把網址貼到上方的測試工具，確認它可以使用

這個測試工具如何運作

貼上你的 Webhook 網址，然後點「檢查」。工具會向 Discord API 驗證該網址，並顯示 Webhook 的名稱、頭像與綁定的頻道。如果有效，你可以輸入自訂訊息並透過 Webhook 送出，確認它能正常運作。基於安全考量，你的 Webhook 網址會經由我們的伺服器轉送（瀏覽器因為 CORS 無法直接呼叫 Discord API），但絕不會被儲存或記錄。

常見的 Discord Webhook 錯誤碼

當 Webhook 請求失敗時，Discord 會回傳一個 HTTP 狀態碼，回應內容是包含數字 code 與 message 的 JSON。你真正會遇到的是這幾種：

• 400 Bad Request - JSON 內容格式錯誤、嵌入內容總長超過 6,000 個字元，或某個欄位超出長度上限。傳送前先在本機驗證你的酬載。
• 401 Unauthorized - Webhook 權杖錯誤或已重新產生。在伺服器設定中重新產生 Webhook 會立刻讓舊網址失效。
• 404 Not Found - Webhook 被刪除、頻道被刪除，或網址有拼字錯誤。請從「伺服器設定 > 整合」重新複製一次網址。
• 429 Too Many Requests - 你碰到了速率限制。Discord 會回傳 retry_after 欄位（單位為秒），告訴你何時重試。請照著做。
• Code 50027 (Invalid Webhook Token) - 與 401 根本原因相同，當網址中的權杖片段損毀或被截斷時回傳。
• Code 50006 (Cannot send empty message) - 你的酬載裡沒有 content、沒有 embeds，也沒有 files。至少要有其中一項。
• Code 50035 (Invalid Form Body) - 最常見的原因是把 embed.color 當成十六進位字串傳送，而不是十進位整數。傳送前把 #9B59B6 換算成 10181046。

Discord Webhook 的速率限制

Discord 會針對每個 Webhook 與每個頻道套用速率限制，而桶子的確切大小由伺服器端決定並透過回應標頭提供，不是一個固定數字。每個成功的回應都會包含 X-RateLimit-Limit、X-RateLimit-Remaining 與 X-RateLimit-Reset-After - 讀取這些值來安排下一次請求，不要把固定速率寫死在程式碼裡。429 的回應內容也會帶上 retry_after 值（單位為秒）。對於高流量的整合（建置流程、日誌彙整），把多個事件合併成一則訊息：一次 Webhook 呼叫最多可帶 10 個嵌入內容，每個嵌入內容合計最多 6,000 個字元，通常足以把一連串事件收斂成一次請求。

Webhook 安全最佳做法

Webhook 網址是一種持有即可用的憑證。任何拿到完整網址的人，都能以 Webhook 機器人的身分在你的頻道發文，不需要任何額外驗證。請把它當成密碼看待：

• 絕對不要把 Webhook 網址提交到公開的 Git 儲存庫。GitHub 的祕密掃描會自動偵測並撤銷外洩的 Discord Webhook，但那也是在它已經曝光之後。
• 把 Webhook 網址存放在環境變數或祕密管理工具裡，不要放進原始碼或納入版本控制的設定檔。
• 如果 Webhook 曝光了，請立刻到伺服器設定 > 整合 > Webhook 把它刪除。重新建立會產生新的權杖，舊網址隨即失效。
• 若要在客戶端使用（瀏覽器應用程式向 Discord 發文），請透過你自己的後端轉送呼叫，讓網址永遠不會到達使用者的瀏覽器。從瀏覽器應用程式外洩的網址就是破壞行為的磁鐵。
• 除非 allowed_mentions 明確允許，否則 Discord Webhook 會忽略 @everyone 與 @here 標註。如果你不需要標註提醒，把 "parse": [] 設定上去就能全部關閉。

用 curl 手動測試 Webhook

如果你比較習慣從終端機測試，最小的酬載就是一個 content 欄位。POST 成功會回傳 HTTP 204 與空的內容；如果在網址後面加上 ?wait=true，則會回傳 HTTP 200 與新建訊息的 JSON。當你需要取回訊息 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 主題下預覽身分組顏色

由 Pigona 提供技術支援 - 為 Discord 打造的免費翻譯