跳转到主要内容
EchoAuth Tickets 为你托管 Discord 工单机器人。你用许可证密钥创建账号,在浏览器中设置机器人,然后一键部署。你不需要服务器,也不需要任何编程。
开始之前,请准备好以下内容:
  • SellAuth 发票上的许可证密钥(格式类似 ECHO-XXXXX-XXXXX-XXXXX-XXXXX)
  • 你的 Discord 服务器的管理员权限
  • 一个可以在 Discord Developer Portal 中创建应用程序的 Discord 账号

1. 创建账号

1

打开注册页面

打开 EchoAuth Tickets 面板,点击登录表单下方的 Create an account。如果你使用的是发票中的链接,许可证密钥已自动填好。
2

输入许可证密钥和登录信息

粘贴你的许可证密钥,选择用户名(3 到 32 个字符:字母、数字、.、_ 和 -)以及至少 8 个字符的密码,然后点击 Create account。
带有许可证密钥、用户名和密码字段的 Create your account 表单

使用 SellAuth 发票上的许可证密钥注册

3

查看控制面板

你会进入控制面板。它显示许可证剩余天数、机器人状态以及 Getting started 清单。清单中的每一项都会打开对应的设置。
显示有效许可证、尚未部署的机器人和入门清单的控制面板

注册后的控制面板。设置进度为 0/6

2. 创建你的 Discord 机器人

你的工单机器人运行在你自己的 Discord 应用程序上。你只需在 Discord Developer Portal 中创建一次。
1

创建应用程序

前往 Discord Developer Portal,点击 New Application,为它命名(例如你的店铺名称)并创建。
2

启用特权 intents

打开 Bot 标签页。在 Privileged Gateway Intents 下,打开全部三项:
  • Presence Intent
  • Server Members Intent
  • Message Content Intent
点击 Save Changes。
如果这些 intents 处于关闭状态,机器人将无法启动,或无法读取工单中的消息。
3

复制机器人令牌

仍在 Bot 标签页,点击 Reset Token 并复制令牌。你将在下一节把它粘贴到面板中。
机器人令牌相当于密码。不要分享,也不要发布到任何地方。如果泄露,请在这里重置,并将新令牌粘贴到面板中。
4

邀请机器人加入你的服务器

打开 OAuth2 → URL Generator。选择 bot 和 applications.commands 作用域,然后选择 Administrator 权限。打开生成的 URL,将机器人添加到你的服务器。
5

在 Discord 中开启开发者模式

在 Discord 中前往 User Settings → Advanced,打开 Developer Mode。现在你可以右键点击服务器、频道、分类和身份组,并选择 Copy ID。接下来的步骤需要用到这些 ID。

3. 配置你的机器人

点击侧边栏中的 Configuration。设置按标签页分组。右侧的 Live preview 会在你输入时显示消息在 Discord 中的样子。 每当你更改内容,页面底部都会出现一个栏。点击 Save 保留更改,或点击 Save & Deploy 保存并立即用新设置重启机器人。
1

General:添加令牌和服务器 ID

在 General 标签页中填写:
  • Bot Token:来自 Developer Portal 的令牌
  • Server ID:右键点击服务器图标并选择 Copy Server ID
  • Owner User ID(可选):你自己的 Discord 用户 ID。该用户始终可以使用 SellAuth 管理命令。
  • Owner Role ID(可选):可以使用 /refund、/remove_password、/add_customer_balance、/redo_delivery 和 /replace 的身份组
已填写机器人令牌、服务器 ID 和 owner user ID 的 General 配置标签页,以及未保存更改栏

已填写令牌和服务器 ID 的 General 标签页。保存栏出现在底部

2

Ticket Behavior:选择日志频道

在 Ticket Behavior 标签页中设置 Logs channel ID。机器人会在这里发布工单日志,没有它 /panel 无法工作。在 Discord 中右键点击该频道并选择 Copy Channel ID。你还可以设置每位用户可同时打开多少个工单、冷却时间、是否仅限工作人员关闭工单,以及关闭的工单是归档而不是删除。
已填写日志频道 ID 的 Ticket Behavior 标签页

Ticket Behavior 标签页。日志频道为必填项

3

Categories:设置工单在哪里打开以及谁可以回复

在 Categories 标签页中,选择左侧的一个分类(例如 General Support)并填写:
  • Discord category ID:新工单创建所在的频道分类。在 Discord 中右键点击该分类并选择 Copy Category ID。
  • Support roles:粘贴身份组 ID 并按 Enter。拥有这些身份组的成员可以查看并回复该分类中的工单。
对你使用的每个分类重复此操作。要使用更多分类,打开其中一个并开启 Enabled。按钮模式最多显示 5 个分类,下拉菜单模式最多 8 个。在 Form 下,你最多可以添加 5 个问题,用户需在工单打开前回答。
已填写 Discord 分类 ID 和支持身份组的 Categories 标签页,旁边是工单消息预览

分类 1,包含 Discord 分类 ID 和一个支持身份组

将表单字段的 Function 设置为 SellAuth invoice lookup,当客户输入发票 ID 时,机器人会自动查询订单。
4

Ticket Panel:设计成员点击的消息

在 Ticket Panel 标签页中,编辑面板的标题、消息、颜色、图片和页脚。开启 Use a dropdown menu 可用下拉菜单而不是按钮来显示分类。预览会随着你的输入实时更新。
Ticket Panel 标签页,旁边是带有分类下拉菜单的 Support Center 面板 Discord 预览

带有 Discord 实时预览的 Ticket Panel 标签页

5

SellAuth(可选):连接你的店铺

要使用 SellAuth 命令(/invoice、/refund、/replace 等)和发票查询,请打开 SellAuth 标签页,输入你的 API key(dash.sellauth.com → Account → Developers)、Shop ID、Shop currency 和 Shop domain。
带有 API 密钥、店铺 ID、货币和域名字段的 SellAuth 集成标签页

SellAuth 标签页

4. 部署你的机器人

回到 Dashboard。当清单前五项都打上对勾后,点击 Deploy。你的机器人会在几秒内启动并在你的服务器中上线。
六个设置步骤已完成五个、并带有 Deploy 按钮的控制面板

所有设置已完成。只剩部署这一步

首次部署之后,使用 Configuration 页面上的 Save & Deploy 来应用后续更改。
如果部署失败,请打开侧边栏中的 Logs。最常见的原因是机器人令牌错误,或 Developer Portal 中的 intents 被关闭。

5. 在 Discord 中发布工单面板

在你的 Discord 服务器中,前往成员应打开工单的频道并运行:
运行此命令需要 Administrator 权限。机器人会在该频道发布面板。成员现在可以选择分类、回答表单,然后会为他们和你的支持身份组打开一个私密的工单频道。

续订或延长你的许可证

打开侧边栏中的 License & Account。在 Redeem a license key 下粘贴新密钥并点击 Redeem。时间会叠加在当前到期日期之上,因此你可以提前延长而不会损失天数。你也可以在此页面更改密码。
带有许可证密钥兑换表单、修改密码表单和许可证历史的 License and Account 页面

License & Account 页面

许可证到期时,你的机器人会停止运行。你的配置和聊天记录会被保留。兑换新密钥并重新部署即可让机器人重新上线。

故障排除

确认你邀请机器人时使用了 applications.commands 作用域,并且 Configuration → General → Commands 中的 Slash commands 已开启。Discord 可能需要几分钟才会显示新命令。重启 Discord 通常有帮助。
检查 Ticket Behavior 标签页中的 Logs channel ID 是否指向你服务器中存在的频道,并确认你拥有 Administrator 权限。
在 Categories 标签页中检查该分类的 Discord category ID 和 Support roles。每个分类都有各自的设置。确认机器人的身份组有权管理该分类中的频道。
请按发票上显示的内容原样复制密钥。每个密钥只能使用一次。如果你已有账号,请登录,并在 License & Account 中兑换该密钥。
仍然无法解决?请在我们的支持服务器中创建工单。