🔐 Authentication
Twitch
使用 Twitch Authentication 步驟,在工單內驗證成員的 Twitch 帳號。
Twitch 驗證步驟
Twitch Authentication 步驟會將 Discord 成員連結到他們已驗證的 Twitch 帳號——非常適合創作者社群、訂閱者福利和直播團隊。

這種步驟類型是 premium 功能。你這邊不需要 Twitch 開發者應用程式。
適合使用的人
- 發放訂閱者或 VIP 福利的創作者伺服器
- 審核申請的直播團隊與網路社群
- 舉辦抽獎活動、且 Twitch 帳號很重要的社群
- 經常遭遇知名實況主冒名申請的伺服器
會儲存哪些資料
| 欄位 | 範例 | 說明 |
|---|---|---|
twitch_id | 123456789 | 永久的 Twitch 使用者 ID |
twitch_username | PlayerOne | 驗證當下的 Twitch 顯示名稱 |
> Twitch Verification: `PlayerOne` (`123456789`)成員會如何體驗
這個步驟會顯示一個帶有 Twitch 標誌的 Login 按鈕。
Twitch 的授權頁面會開啟,並要求授權 TicketWave user:read:email 權限範圍。
成員完成授權後,Twitch 會將他們導回,TicketWave 會讀取公開的頻道個人資料。
確認頁面會出現,然後工單繼續進行。

user:read:email 是 Twitch 用於帳號識別的標準唯讀權限範圍。TicketWave 只會儲存 Twitch ID 和顯示名稱 —— 電子郵件地址不會隨工單一起保存。
設定此步驟
開啟 Ticket Steps 模組
Server dashboard → Settings → Ticket Steps → Configure。
建立步驟
| 欄位 | 建議 |
|---|---|
| Step Title | Connect your Twitch account |
| Step Description | We use your Twitch account to check your subscription and perks. |
| Step Type | Twitch Authentication |
| Required Step | 用於福利工單時啟用,一般問題則可選用 |
放在正確的分類底下
只在有需要的分類中要求它,例如 Sub Perks 或 Team Application。可使用 Limit to Category 來限制。
測試它
開啟一個工單並完成登入流程。
疑難排解
| 問題 | 原因 | 解決方法 |
|---|---|---|
| 步驟沒有出現 | Premium 未啟用,或步驟超過免費上限 | 檢查 Premium 頁面與你的步驟順序 |
| "Token invalid or expired" | 已經超過 10 分鐘 | 先按 🔁 Renew Token,再重新 Login |
| Twitch 跳過同意畫面 | TicketWave 之前已被授權 | 正常——登入只是變得更快了 |
| 連結到錯誤的 Twitch 帳號 | 瀏覽器目前登入的是另一個帳號 | 先在 twitch.tv 登出,更新 token 後再試一次 |
下一步
- Authentication Overview
- Button Steps(詢問這張工單是關於哪種福利)
- Ticket Feedback & Ratings
How is this guide?
