教學 · 流程
如何免寫程式自動化 Discord(流程+Google 試算表)
用視覺化編輯器建立免寫程式的 Discord 自動化——把新成員記錄到 Google 試算表、關鍵字自動回覆與排程發文,一步步教你做。
流程提醒歡迎訊息
本頁目錄
大多數 Discord 的「自動化」,都是一堆各自為政的單一功能機器人,每個都有自己的控制台。流程讓你在同一個視覺化編輯器裡,免寫程式就能自動化 Discord:選一個觸發條件(成員加入、收到訊息、排程時間到),加入邏輯(If、Switch、Filter、Loop),再串接動作(發送訊息、給予身分組、寫入 Google 試算表、呼叫網路 API)。這篇教學會先說明基本元件,再帶你做三個可以直接照抄的實用流程。
事前準備
- 你的伺服器已經加入 BotGG(https://discord.com/oauth2/authorize?client_id=1553367772451446804&scope=bot%20applications.commands&permissions=282970448981207),而且你有管理伺服器權限。
- 網頁控制台 https://console.botgg.app → 你的伺服器 → 流程。流程沒有斜線指令,所有設定都在控制台中完成。
- 要做 Google 試算表的範例,需要一個 Google 帳號,並花幾分鐘在 Google Cloud 上設定。Google 試算表與 MySQL 節點,以及 Webhook 觸發條件,屬於 Pro 方案。Discord 觸發條件、邏輯、Discord 動作、排程與 HTTP 請求,在免費方案中就能使用(5 個流程)。
基本元件
每個流程都剛好只有一個觸發條件,以及任意數量在畫布上用線連起來的節點。
| 分類 | 節點 |
|---|---|
| 觸發條件 | 成員加入、成員離開、新訊息、新增表情反應、成員身分組變更、語音活動、按鈕被點擊、排程、Webhook、手動觸發 |
| 邏輯 | If(真/假)、Switch(多條路徑+預設路徑)、Filter(條件為假就停止)、Loop、Wait、Stop |
| 資料 | 設定欄位、日期與時間、文字(範本、正規表示式)、JSON |
| Discord 動作 | 發送訊息(含嵌入訊息編輯器與按鈕)、發送私訊、回覆訊息、新增表情反應、新增/移除身分組、禁言、踢出、停權、建立討論串、編輯頻道、取得成員 |
| 整合 | HTTP 請求、Google 試算表、MySQL |
運算式:用 {{ }} 插入資料
任何文字欄位都可以放入以雙大括號包起來的運算式。節點面板中的變數選擇器會幫你插入,所以你很少需要手動輸入:
{{ $trigger.user.username }}:來自觸發條件的資料(這裡是加入的人)。{{ $trigger.message.content | lower }}:訊息文字,用過濾器轉成小寫。{{ $node["Google Sheets"].updatedRows }}:前面某個節點的輸出,依節點名稱取得。{{ $now | date('YYYY-MM-DD HH:mm', 'Europe/London') }}:目前時間,依時區格式化(省略時區就是 UTC)。{{ $guild.name }}、{{ $vars.counter }}、{{ $json.field }}:伺服器、流程變數、目前處理的項目。
過濾器用 | 串接:upper、lower、trim、default('none')、replace(a,b)、split、join、round(2)、date(format) 等等。這裡不會執行任何程式碼——運算式只讀取資料,比較條件由 If、Filter 與 Switch 負責。
範例 1:把新成員記錄到 Google 試算表
建立一份附加入日期、可以排序、篩選並與團隊共用的成員名單。
1. 在 Google Cloud 建立服務帳戶。 在 Google Cloud 控制台建立(或選擇)一個專案,啟用 Google Sheets API,接著前往 IAM 與管理 → 服務帳戶 → 建立一個。開啟它 → 金鑰 → 新增金鑰 → JSON,就會下載一個 JSON 金鑰檔。
2. 在 BotGG 新增憑證。 在流程中開啟憑證 → 新增憑證,選擇 Google 服務帳戶類型,貼上整份 JSON 金鑰,再按儲存並測試。金鑰會加密儲存,也不會再回傳到瀏覽器。
3. 共用試算表。 建立一份 Google 試算表,然後以「編輯者」身分分享給服務帳戶的電子郵件——也就是 JSON 裡 client_email 的值,結尾是 iam.gserviceaccount.com。這是大家最常忘記的一步。
4. 建立流程。 建立一個流程(或從將訊息記錄到 Google 試算表範本開始,再換掉觸發條件):
- 觸發條件:成員加入,並開啟「忽略機器人」。
- 動作:Google 試算表 → 操作選附加,貼上試算表網址,工作表名稱填
Sheet1,值模式選欄位。 - 對應欄位(標題 → 值): -
Username→{{ $trigger.user.username }}-User ID→{{ $trigger.user.id }}-Joined→{{ $now | date('YYYY-MM-DD HH:mm', 'Europe/London') }}-Account created→{{ $trigger.user.createdAt | date('YYYY-MM-DD') }}
欄位名稱與標題列比對時不分大小寫;如果試算表是空的,第一次附加時會自動幫你寫入標題列。按下測試流程用範例資料跑一次,確認新增了一列之後,再開啟流程並儲存。
也想記錄離開的成員嗎?複製這個流程,把觸發條件改成成員離開,並使用更新操作,以查詢欄位 User ID 去填寫「Left」欄,而不是新增一列。
範例 2:在求助頻道用關鍵字自動回覆
不用再打字,就能回答第一百次出現的同一個問題。
- 觸發條件:新訊息,頻道選
#help,開啟「忽略機器人」,比對方式選包含,樣式填server ip。 - 動作:回覆訊息,內容放答案——例如
Hi {{ $trigger.user.displayName }}, the IP is play.example.net. Rules are in #rules.
需要回答好幾種問題?把觸發條件保持在任何訊息,再加一個值為 {{ $trigger.message.content | lower }} 的 Switch 節點。加入幾條路徑,例如包含 ip、包含 apply、包含 rules,各自連到一個回覆訊息節點,並讓預設路徑保持不連接,這樣其他訊息就會被忽略。若要略過管理員,請在 Switch 前面放一個 Filter:{{ $trigger.member.roles }} 不包含你的管理員身分組 ID。
範例 3:每週排程訊息
- 觸發條件:排程 → 類型選 Cron,運算式填
0 18 * * 5(每週五 18:00)。排程使用控制台設定中的伺服器時區;編輯器會顯示接下來幾次執行時間,方便你確認。 - 選用:對公開 API 發出 HTTP 請求(GET)——例如你的遊戲伺服器狀態端點——並在訊息中使用
{{ $node["HTTP request"].body.players }}。 - 動作:用嵌入訊息編輯器對
#announcements發送訊息:標題填Weekend raid night,說明填Raid night for the week of {{ $now | date('D MMMM') }}: sign-ups are open.,如果希望點一下就啟動另一個流程,還可以加一個按鈕,搭配按鈕被點擊觸發條件使用。
如果只是單純的一次性提醒,或不需要邏輯的定期公告,提醒比較快;當貼文需要資料、條件或後續動作時,再使用流程。
建議做法
| 小秘訣 | 原因 |
|---|---|
| 為節點取清楚的名稱(「Log join」、「Help reply」) | 運算式是用節點名稱來引用節點 |
| 先停用 Discord 動作再測試 | 測試執行會真的發送訊息、變更身分組 |
| HTTP/試算表節點開啟「失敗時繼續」或重試 | 速度慢的 API 不會讓整個流程中斷 |
| 儘早使用 Filter | 在流程做多餘的工作之前就先停下來 |
| 每次修改後檢查執行紀錄 | 每次執行都會顯示各節點的輸入、輸出與錯誤 |
疑難排解
- 流程完全沒有執行。 流程本身和流程功能都必須啟用。儲存後的變更大約一分鐘內會傳到 Discord 觸發條件。
- 關鍵字過濾永遠不符合。 文字比對取決於機器人是否有 Discord 的訊息內容存取權;沒有的話,訊息文字會是空的。
- Google 試算表回傳 403 或「找不到」。 試算表沒有分享給服務帳戶的電子郵件,或是該 Cloud 專案沒有啟用 Google Sheets API。
- 時間差了幾個小時。
date過濾器預設以 UTC 格式化,除非你把時區放在第二個參數,例如date('HH:mm', 'America/New_York')。 - 「新增身分組」失敗。 BotGG 的身分組必須高於它要給予的身分組,而且動作只對這個伺服器的頻道、身分組與成員有效。
- 流程對自己發的訊息有反應。 不會——BotGG 自己的訊息與表情反應永遠不會觸發流程,所以不可能意外形成無限迴圈。
等你的流程都跑起來之後,可以看看歡迎訊息與驗證教學,這些是不用自己重做的內建功能;其他功能請看指令列表。
常見問題
流程像 Discord 版的 Zapier 或 n8n 嗎?
是的,理念相同:有觸發條件、邏輯與動作的視覺化畫布——但它內建在 Discord 機器人裡,所以 Discord 的事件與動作不需要 Webhook 或 API 金鑰就能使用。
我需要會寫程式嗎?
不需要。節點都是透過表單與選擇器設定,運算式也是從變數選擇器插入。這裡完全沒有程式碼節點。
免費方案的流程可以寫入 Google 試算表嗎?
Google 試算表與 MySQL 節點,以及 Webhook 觸發條件,屬於 Pro 功能。Discord 動作、邏輯、排程與 HTTP 請求則是免費的。請見方案價格。
可以把網站或表單的資料傳進 Discord 嗎?
可以,使用 Webhook 觸發條件(Pro):每個流程都有自己的私密網址,你 POST 到該網址的任何內容,都能用 {{ $trigger.body }} 取得。