概覽
TicketWave 的 OAuth 工單步驟如何驗證 Steam、CFX、GitHub、Roblox、Twitch、Battle.net 和 Epic Games 帳號。
驗證步驟
驗證步驟會要求成員使用外部帳號登入。TicketWave 絕不會要求密碼——成員會被導向該服務提供者自己的登入頁面，而只有已驗證的帳號名稱與 ID會回傳。
為什麼這比在聊天中詢問更好
問「你的 Steam 名稱是什麼？」只會得到成員自己輸入的一串文字。驗證步驟則會提供一個成員已證明擁有的帳號。
| 在聊天中詢問 | 驗證步驟 |
|---|---|
| 拼字錯誤與 ID 錯誤 | 來自提供者的精確帳號 ID |
| 冒充非常容易 | 成員必須真的登入 |
| 工作人員得手動複製貼上並查找 | 名稱與 ID 會自動進入工單 |
| 需要幾則訊息 | 只要點一下 |
對遊戲與開發社群來說，這是 TicketWave 省時最多的一項功能——你的工作人員在每張工單一開始就已經知道自己在跟誰對話。
支援的服務
| 服務 | 步驟類型 | 指南 |
|---|---|---|
| CFX / FiveM | CFX Authentication | Click here |
| Steam | Steam Authentication | Click here |
| GitHub | GitHub Authentication | Click here |
| Roblox | Roblox Authentication | Click here |
| Twitch | Twitch Authentication | Click here |
| Battle.net | Battle.net Authentication | Click here |
| Epic Games | Epic Games Authentication | Click here |
每一種驗證步驟類型都是進階功能。所有設定都已經由我們這邊完成——你不需要註冊開發者應用程式、建立 API 金鑰或自行架設任何東西。
運作方式
步驟會出現在工單中，並附上 Login 按鈕與服務圖示。
成員點擊 Login。 這個按鈕是一個帶有一次性 token 的連結。
提供者會要求同意。 成員會在提供者自己的網站上登入——例如 Steam、GitHub、Twitch 等。TicketWave 不會看到任何憑證。
提供者把成員帶回來。 TicketWave 會驗證回應，讀取帳號名稱與 ID，並將它們儲存為該步驟的答案。
確認頁面會開啟 在 TicketWave 網站上："Account Successfully Linked"，並顯示工單 ID、伺服器與已連結的帳號。
工單會繼續進行 下一個步驟——如果這是最後一步，則會解鎖。
一次性 Token
每個 Login 按鈕都包含一個有效期為 10 分鐘 的 token。
這樣設計是有原因的：連結會貼在頻道中，而一個永遠有效的連結也就代表它可以被重複使用。10 分鐘後，這個 token 就會被丟棄。
如果成員花太久，看到的就會是這個頁面：
重新產生 Token
每個驗證步驟在 Login 按鈕旁邊都有一個 🔁 Renew Token 按鈕。
回到 Discord 的工單頻道。
在步驟訊息中點擊 🔁 Renew Token。
再次點擊 Login——這次按鈕會帶有新的 10 分鐘 token。
重新產生不會遺失任何東西。它只是用新的 token 重新建立步驟訊息。
TicketWave 會儲存什麼
每次成功驗證時，工單中只會儲存兩個值：
- 提供者的帳號 ID
- 提供者的顯示名稱 / 使用者名稱
就這樣。交換完成後，不會保留密碼、電子郵件或存取 token。存取 token 只會被使用一次來讀取公開個人資料，之後會與請求一起被丟棄。
答案會像這樣顯示在工單摘要中：
> Steam Verification: 🎮 `PlayerOne` (`76561198000000000`)
新增驗證步驟
開啟你的伺服器儀表板 → Settings → Ticket Steps → Configure。
點擊 Add Step。
為它設定一個 Step Title（例如 Verify your Steam account）以及簡短的 Step Description。
在 Step Type 下選擇服務。
決定這個步驟是否為 Required——可選步驟會多一個 ⏭️ Skip 按鈕。
你也可以選擇將步驟限制在某個 category 或 subcategory，讓只有需要它的工單才會詢問。
點擊 Create Step，然後開啟一張測試工單。
驗證步驟不使用步驟選項。Login 和 Renew Token 按鈕是由 TicketWave 自動產生的——你只需要設定標題、描述與限制條件。
疑難排解
步驟完全沒有顯示。
驗證步驟需要進階方案。沒有啟用進階方案時，該步驟會被跳過。請查看你伺服器儀表板中的 Premium 頁面。
"Your ticket authentication token is invalid or has expired."
10 分鐘的時間已經過了。請在工單中使用 🔁 Renew Token，然後再次點擊 Login。
有人點了按鈕。
只有工單擁有者可以回答步驟。其他人都會收到錯誤訊息，且不會儲存任何內容。
登入後沒有任何反應。
當成員返回時，工單必須仍然是開啟狀態，而且該步驟必須仍然是未回答狀態。如果工單在這段時間內已被關閉，就無法儲存答案——請開一張新工單。
下一步
選擇你想設定的服務：
How is this guide?