> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 工单机器人设置指南

> 约 10 分钟，从许可证密钥到上线运行的 Discord 工单机器人。

EchoAuth Tickets 为你托管 Discord 工单机器人。你用许可证密钥创建账号，在浏览器中设置机器人，然后一键部署。你不需要服务器，也不需要任何编程。

> [!NOTE]
>
> **开始之前，请准备好以下内容：**
>
> * SellAuth 发票上的许可证密钥（格式类似 `ECHO-XXXXX-XXXXX-XXXXX-XXXXX`）
> * 你的 Discord 服务器的管理员权限
> * 一个可以在 [Discord Developer Portal](https://discord.com/developers/applications) 中创建应用程序的 Discord 账号

## 1. 创建账号

**1. 打开注册页面**

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

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

粘贴你的**许可证密钥**，选择**用户名**（3 到 32 个字符：字母、数字、`.`、`_` 和 `-`）以及至少 8 个字符的**密码**，然后点击 **Create account**。

![带有许可证密钥、用户名和密码字段的 Create your account 表单](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/register.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=963b556456e896df44c36bf5111ac365)

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

**3. 查看控制面板**

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

![显示有效许可证、尚未部署的机器人和入门清单的控制面板](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=afdb4921c1fac548a8e7ea01642dcfdb)

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

## 2. 创建你的 Discord 机器人

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

**1. 创建应用程序**

前往 [Discord Developer Portal](https://discord.com/developers/applications)，点击 **New Application**，为它命名（例如你的店铺名称）并创建。

**2. 启用特权 intents**

打开 **Bot** 标签页。在 **Privileged Gateway Intents** 下，打开全部三项：

* **Presence Intent**
* **Server Members Intent**
* **Message Content Intent**

点击 **Save Changes**。

> [!WARNING]
>
> 如果这些 intents 处于关闭状态，机器人将无法启动，或无法读取工单中的消息。

**3. 复制机器人令牌**

仍在 **Bot** 标签页，点击 **Reset Token** 并复制令牌。你将在下一节把它粘贴到面板中。

> [!WARNING]
>
> 机器人令牌相当于密码。不要分享，也不要发布到任何地方。如果泄露，请在这里重置，并将新令牌粘贴到面板中。

**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 配置标签页，以及未保存更改栏](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/general.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=c550d06ff7725d8856d3712e44097982)

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

**2. Ticket Behavior：选择日志频道**

在 **Ticket Behavior** 标签页中设置 **Logs channel ID**。机器人会在这里发布工单日志，没有它 `/panel` 无法工作。在 Discord 中右键点击该频道并选择 **Copy Channel ID**。

你还可以设置每位用户可同时打开多少个工单、冷却时间、是否仅限工作人员关闭工单，以及关闭的工单是归档而不是删除。

![已填写日志频道 ID 的 Ticket Behavior 标签页](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-behavior.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=b73fdb6598b4fd49b20c56671d6b65ca)

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 标签页，旁边是工单消息预览](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/categories.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=82fa0f8f57ffe9b5cd68eaf5b5c1b4d3)

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

> [!TIP]
>
> 将表单字段的 **Function** 设置为 **SellAuth invoice lookup**，当客户输入发票 ID 时，机器人会自动查询订单。

**4. Ticket Panel：设计成员点击的消息**

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

![Ticket Panel 标签页，旁边是带有分类下拉菜单的 Support Center 面板 Discord 预览](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/ticket-panel.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=8eb97253931ed5ad11efb96f41c8cbba)

带有 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 集成标签页](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/sellauth.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=27f8ddc2f4a8db61dabb08029b3130cb)

SellAuth 标签页

## 4. 部署你的机器人

回到 **Dashboard**。当清单前五项都打上对勾后，点击 **Deploy**。你的机器人会在几秒内启动并在你的服务器中上线。

![六个设置步骤已完成五个、并带有 Deploy 按钮的控制面板](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/dashboard-ready.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=e7426998aad99958eb32136d3d4b948f)

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

首次部署之后，使用 Configuration 页面上的 **Save & Deploy** 来应用后续更改。

> [!NOTE]
>
> 如果部署失败，请打开侧边栏中的 **Logs**。最常见的原因是机器人令牌错误，或 Developer Portal 中的 intents 被关闭。

## 5. 在 Discord 中发布工单面板

在你的 Discord 服务器中，前往成员应打开工单的频道并运行：

```text theme={null}
/panel
```

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

## 续订或延长你的许可证

打开侧边栏中的 **License & Account**。在 **Redeem a license key** 下粘贴新密钥并点击 **Redeem**。时间会叠加在当前到期日期之上，因此你可以提前延长而不会损失天数。你也可以在此页面更改密码。

![带有许可证密钥兑换表单、修改密码表单和许可证历史的 License and Account 页面](https://mintcdn.com/echoauth/b3ZMlCVQ6TV3E0yE/images/ticket-bot/account.png?fit=max\&auto=format\&n=b3ZMlCVQ6TV3E0yE\&q=85\&s=ae5f1857dd2f29e1320e152fe5a2ff17)

License & Account 页面

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

## 故障排除

> [accordion] 机器人在线，但斜杠命令没有出现
>
> 确认你邀请机器人时使用了 `applications.commands` 作用域，并且 **Configuration → General → Commands** 中的 **Slash commands** 已开启。Discord 可能需要几分钟才会显示新命令。重启 Discord 通常有帮助。

> [accordion] /panel 没有任何反应
>
> 检查 **Ticket Behavior** 标签页中的 **Logs channel ID** 是否指向你服务器中存在的频道，并确认你拥有 Administrator 权限。

> [accordion] 工单在错误的位置打开，或工作人员看不到
>
> 在 **Categories** 标签页中检查该分类的 **Discord category ID** 和 **Support roles**。每个分类都有各自的设置。确认机器人的身份组有权管理该分类中的频道。

> [accordion] 我无法用我的密钥创建账号
>
> 请按发票上显示的内容原样复制密钥。每个密钥只能使用一次。如果你已有账号，请登录，并在 **License & Account** 中兑换该密钥。

仍然无法解决？请在我们的[支持服务器](https://discord.echoauth.dev)中创建工单。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.