Discord

Discord 是一個用你自己的 Discord 機械人運作的連接器。你在 Discord Developer Portal 建立機械人，把它加入你的伺服器，再把它的權杖儲存到 MeDo。之後應用程式的伺服器函數會用這個權杖呼叫 Discord：發訊息到頻道、讀取頻道的近期訊息，以及列出機械人已加入的伺服器和頻道。訊息會以你的機械人名稱顯示。機械人只看得到你把它加入的伺服器，也只能在它有 Send Messages 權限的頻道發訊息。

#可以建立什麼

• 訂單和預約通知。 每有新訂單或新預約，就把訂單編號、商品和總額，或預約詳情發到團隊頻道。
• 表單轉交到頻道。 把每份聯絡或支援表單發到頻道，由團隊跟進。
• 公告板。 在公開頁面顯示公告頻道的最新訊息。
• 私人更新發佈工具。 在你自己的登入機制之後撰寫更新、預覽，再發到你選定的頻道。

其他機械人操作——編輯機械人自己的訊息、加表情回應、置頂、開訊息串、建立頻道——可以按需建立，其中部分需要額外的機械人權限，見限制。

#建立範例

把以下其中一段複製到提示詞輸入框。第一段是最小而實用的起點。

Use @Discord to build a public contact form web page that posts each submission to our #support channel with the visitor's name, email, and message.

Use @Discord to build a store checkout page that posts the order number, items, and total to our #orders channel when a customer places an order.

Use @Discord to build a private web dashboard that only I can sign in to, showing my server's channels and the latest messages from the channel I pick.

Use @Discord to build a private release notes web app that only I can sign in to, where I write an update, preview it, and post it to #announcements.

#準備與連接

你需要一個可以管理目標伺服器的 Discord 帳戶。設定只需幾分鐘，每個機械人做一次即可。

1. 開啟 Discord Developer Portal，點擊 New Application 並命名。伺服器成員會在應用程式發出的每則訊息上看到這個名稱。
2. 開啟 Bot，點擊 Reset Token 並複製權杖。Discord 只會顯示一次。請把權杖當作密碼保管：任何人拿到它都可以用你的機械人發訊息。如果應用程式要顯示或讀取頻道訊息，請在同一頁開啟 Message Content Intent 並儲存；不開的話，Discord 回傳的成員訊息內容會是空白。
3. 開啟 OAuth2 → URL Generator，勾選 bot 範圍，以及 View Channels、Send Messages、Read Message History 權限。開啟產生的連結，把機械人加入你的伺服器。應用程式要用的每個伺服器都重複一次。
4. 在 MeDo 中，把權杖儲存到 Discord 設定。設定卡片通常就在 MeDo 回覆下方；你也可以在編輯器左側欄開啟 Skill（技能） 分頁，找到 Discord 並在那裡設定。

MeDo 會在儲存前向 Discord 驗證權杖。如果驗證失敗，請到 Bot 頁面複製新的權杖再儲存。權杖只為這個應用程式儲存，再次顯示時會遮蔽；切勿把它貼到頁面內容裏，也不要叫 MeDo 把它寫進程式碼。每個應用程式只用一個機械人；要換機械人，在同一位置儲存另一個機械人的權杖，新權杖會取代舊的。你可以在儲存權杖前就開始建立——在權杖儲存前，應用程式會顯示設定指引。

#在應用程式中使用

• 應用程式以你的機械人身份，在你的伺服器發訊息。 訪客不會登入 Discord，也不能選擇頻道。頻道會固定在應用程式的函數中，或由應用程式管理員在設定頁選擇。
• @everyone 和 @here 永遠不會通知任何人。 由訪客輸入組成的訊息不能通知整個伺服器。只有應用程式自己組成的提及，才能提及特定用戶或身份組。
• 私人應用程式只限管理員使用。 對於私人、內部或個人用途的應用程式，MeDo 會加入登入機制，只有應用程式管理員可以使用 Discord 功能。之後註冊的帳戶沒有存取權。
• 提交內容保留在你的應用程式中。 公開表單會先把每個預約或訊息存到應用程式自己的資料庫，再發出摘要。訪客可以提交，但不能讀取其他人的提交內容。
• 每筆記錄只發一次。 應用程式會記住哪些記錄已發到 Discord，所以重試的請求不會重複發佈。

#限制與排障

應用程式顯示 Discord 未設定。 把機械人權杖儲存到 Discord 設定，然後重新載入頁面。

應用程式顯示權杖無效。 權杖已被重設或複製不完整。請在 Bot 頁面再重設一次並儲存新的權杖。

應用程式顯示機械人缺少權限。 把機械人加入伺服器，或為該頻道給予缺少的權限，然後重試。

訊息顯示為空白。 在 Bot 頁面開啟 Message Content Intent 並儲存。

沒有列出任何伺服器或頻道。 機械人還未加入伺服器。開啟第 3 步的邀請連結並把它加入。

#相關內容

• 連接器目錄——其他連接器及其用途。
• 金鑰與資料安全——機械人權杖等應用程式密鑰如何儲存。