🔐 Authentication
Twitch
使用 Twitch Authentication 步骤，在工单中验证成员的 Twitch 账号。
Twitch Authentication 步骤
Twitch Authentication 步骤会将 Discord 成员连接到其已验证的 Twitch 账号——非常适合创作者社区、订阅者福利和主播团队。
此步骤类型属于 premium 功能。你这边不需要 Twitch 开发者应用。
适用对象
- 发放订阅者或 VIP 福利的创作者服务器
- 审核申请的主播团队和网络
- 进行抽奖活动、且 Twitch 账号很重要的社区
- 经常遇到知名主播冒充尝试的服务器
存储内容
| Field | Example | Description |
|---|---|---|
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 模块
服务器控制台 → Settings → Ticket Steps → Configure。
创建步骤
| Field | Suggestion |
|---|---|
| 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 来设置。
测试它
打开一个工单并完成登录流程。
故障排查
| Problem | Cause | Fix |
|---|---|---|
| 该步骤未显示 | Premium 未启用，或该步骤超出免费限制 | 检查 Premium 页面和你的步骤顺序 |
| "Token invalid or expired" | 已经过了 10 分钟以上 | 🔁 Renew Token，然后再次 Login |
| Twitch 跳过了同意页面 | TicketWave 之前已被授权 | 正常——只是登录更快而已 |
| 关联了错误的 Twitch 账号 | 浏览器登录的是另一个账号 | 在 twitch.tv 退出登录，刷新令牌后重试 |
下一步
- Authentication Overview
- Button Steps（询问工单是关于哪种福利）
- Ticket Feedback & Ratings
How is this guide?