Ticket Panel
使用可视化嵌入创建器构建你的工单面板嵌入，并将其发送到你的支持频道。
你的工单面板指南
工单面板 是成员点击后用来打开工单的消息。它是他们从你的支持中看到的第一样东西——也是 TicketWave 在你的服务器中唯一公开的部分。
在哪里创建
服务器仪表板 → Settings → Ticket Message → Configure。
这个模块是一个 Embed Creator：你在左侧编辑，右侧的 Live Preview 会准确显示 Discord 的渲染效果。
- Embed 选项卡 — 消息的外观
- Components 选项卡 — 按钮或下拉菜单
- Live Preview
- Reset / Save
Embed 选项卡
| Section | Fields |
|---|---|
| Basic | Title, Description, Color |
| Author | Author Name, Author Icon URL |
| Fields | Any number of name/value fields, each optionally inline |
| Images | Image URL, Thumbnail URL |
| Footer | Footer Text, Footer Icon URL, Show Timestamp |
保持所有内容为空，TicketWave 就会使用你的 branding 颜色作为默认面板嵌入。
Components 选项卡
面板使用 按钮 或 下拉菜单 其中一种——在 Component Type 下选择一个。
按钮
| Field | Description |
|---|---|
| Label | 按钮上的文字。必填。 |
| Style | Primary（蓝色）、Secondary（灰色）、Success（绿色）或 Danger（红色） |
| Emoji | 按钮上的可选表情符号 |
| Link to Category | 直接在此分类中打开工单 |
| Link to Subcategory | 直接在此子分类中打开工单 |
下拉菜单
| Field | Description |
|---|---|
| Placeholder Text | 成员选择之前显示的灰色文字 |
| Label | 选项名称。必填。 |
| Description | 标签下方的一行简短说明。必填。 |
| Emoji | 选项上的可选表情符号 |
| Link to Category / Subcategory | 与按钮相同 |
将按钮或菜单选项直接链接到某个分类，会 跳过工单内的分类问题。只需点击一次，成员就已经到达正确的位置。
顺序
将你的按钮或菜单项拖到合适的位置，然后点击 Save Sequence。创建器中的顺序就是 Discord 中的顺序。
将面板发送到频道
在嵌入创建器中保存你的更改。
前往应该显示面板的 Discord 频道。
运行 /ticket panel。
/ticket panel/ticket panel 需要 Administrator 权限。完整详情请见 command page。
该命令会 发送一条新消息。它不会更新旧面板——每次运行都会创建一个全新的面板。重新设计后，请发送新的面板并删除旧消息。
限制
| Item | Free | Premium |
|---|---|---|
| Custom embed (title, description, color, fields, images, footer) | ✅ | ✅ |
| Buttons | 3 | Unlimited |
| Menu options | 3 | Unlimited |
| Custom server emojis | ❌ | ✅ |
Discord 本身将一个 action row 限制为 5 个按钮。TicketWave 会按照你保存的顺序填充这一行。
未配置时成员会看到什么
如果你没有配置任何按钮或菜单选项，TicketWave 会显示一个默认组件：
- Button mode — 一个 🎫 按钮，用于打开工单
- Menu mode — 一个 🎫 选项，用于打开工单
这就是为什么一个全新的服务器可以在 /admin setup 之后立即接收工单。
设计建议
面板是路标，不是说明书。
- 最多三到五个选项。 选择越多，选错的可能性也越大。
- 命名结果，而不是部门。 “报告漏洞” 比 “二级支持” 更好。
- 在描述中说明接下来会发生什么："会打开一个私密频道，我们的团队会在 24 小时内回复。"
- 当你需要提供说明时使用下拉菜单， 当标签本身已经足够清楚时使用 按钮。
- 设定预期——如果你只在工作日回复，就把它写在面板里，而不是每个周末都被问一遍。
故障排查
| Problem | Fix |
|---|---|
/ticket panel 报告缺少权限 | 机器人需要在目标频道中拥有 View Channel 和 Send Messages |
| 面板看起来像默认样式 | Ticket Message 模块从未保存——打开它并点击 Save |
| 某个按钮不见了 | 你已经超过免费版 3 个的限制，或者该按钮没有标签 |
| 表情符号没有显示 | 自定义服务器表情需要高级版，而且该表情必须存在于你的服务器中 |
下一步
- Ticket Categories & Subcategories（按钮应该链接到哪里）
- Branding & Appearance（让每个嵌入都属于你）
- Limits, Cooldowns & Captcha（保护面板免受垃圾信息影响）
How is this guide?