跳到主要内容
这些指南已翻译成简体中文。其余文档为英文。阅读此页的英文版
简体中文

添加机器人

添加机器人,然后运行 /setup 发布你的第一个工单面板。本页介绍 Discord 的授权页面、机器人请求的权限及其用途,以及机器人显示离线时该怎么办。

这是哪个 Ticket Tool?

这是 Ticket Tool(ticket-tool.app,控制台位于 dash.ticket-tool.app)。其他一些 Discord 机器人名称相近,因此其他地方教程中的命令和设置可能与本文档不符。与其他机器人对比

前提条件

需要管理权限

你需要在 Discord 服务器上拥有 管理员 或 管理服务器 权限才能添加机器人。

授权

点击邀请链接后,你会看到 Discord 的授权页面:

选择服务器
从列表中选择要让 Ticket Tool 加入的服务器。
查看权限
查看机器人请求的权限。
授权
点击“授权”以添加机器人。
完成人机验证
如果出现安全验证,请完成它。

所需权限

Ticket Tool 需要以下权限,按用途分组:

频道与身份组

  • 查看频道:查看工单频道
  • 管理频道:创建和删除工单频道
  • 管理身份组:设置工单频道的权限
  • 管理消息:管理工单中的消息

消息

  • 发送消息:在工单中发言
  • 嵌入链接:发送嵌入消息
  • 附加文件:发送聊天记录文件
  • 添加反应:对消息添加反应
  • 阅读消息历史记录:读取过往消息以生成聊天记录
  • 置顶消息:置顶自动化已暂停的提示;如果分类开启了该选项,还会置顶工单的第一条消息

Webhook

  • 管理 Webhook:以自定义名称发送消息

子区

  • 管理子区:管理每个工单的私密员工子区
  • 创建私密子区:开启私密员工子区
  • 创建公开子区:允许 Create Thread 流程节点开启公开子区
  • 在子区中发送消息:在工单子区中回复

工单以频道形式存在。子区只用于可选的私密员工子区,以及支持流程创建的子区。

机器人不会请求 提及 @everyone、@here 和所有身份组 权限。如果你希望 Tag Role 流程节点提及不可提及的身份组,请在服务器设置中授予机器人该权限:只有拥有该权限,Discord 才允许机器人提及这类身份组。

缺少权限

如果你没有授予所有请求的权限,部分功能可能无法正常工作。你之后可以在服务器设置中调整机器人的权限。

确认机器人已加入

授权完成后,Ticket Tool 应该会出现在服务器的成员列表中。机器人完全连接后即会显示为在线。

在成员列表中查找带有机器人标识的 Ticket Tool。

它还会在你的服务器中发布一条欢迎消息。点击其中的 Get Started 按钮会打开与 /setup 相同的设置向导。

故障排除

机器人没有出现?

如果几分钟后机器人仍未出现:

  • 检查是否误将它添加到了其他服务器
  • 确认你拥有管理员或管理服务器权限
  • 移除机器人,然后通过邀请链接重新添加

机器人显示离线?

机器人可能需要一分钟左右才能连接。如果它一直显示离线:

  • 等待几分钟,然后刷新 Discord
  • 在我们的状态页面查看机器人状态
  • 如果问题仍然存在,请联系客服

后续步骤

机器人已经加入你的服务器,接下来设置你的工单系统: