 |
摘要 | 从 Discourse 主题创建 Zendesk 工单。 |
 |
安装指南 | 此插件已随 Discourse 核心一起打包。无需单独安装该插件。 |
由于 Zendesk 将于 2027 年 4 月 30 日永久停用 API 令牌身份验证，现有安装需要 迁移到通过 OAuth 进行身份验证。
功能
创建 Zendesk 工单
此插件允许您从 Discourse 主题创建 Zendesk 工单。您可以通过配置插件，使某个分类中的所有主题自动生成 Zendesk 工单，或者通过点击每个主题下方显示给站点工作人员的“创建 Zendesk 工单”按钮，将单个主题推送到 Zendesk：
当工单创建后，主题第一帖的作者将被设置为 Zendesk 上的请求者（Requester）。他们还将被添加到您的 Zendesk 客户列表中。
在工单创建后，“创建 Zendesk 工单”按钮将更新为“在 Zendesk 中查看”。点击该按钮将带您前往关联的 Zendesk 工单：
将 Discourse 上创建的回复推送到 Zendesk
该插件允许您选择是否将 Discourse 主题的所有回复推送到 Zendesk 工单，或者仅推送由主题作者创建的回复。这两个功能都可以通过插件设置进行配置。
同步 Zendesk 评论与 Discourse
可以将 Zendesk 评论与工单来源的 Discourse 主题进行同步。
配置
可以从您的 Discourse 站点管理部分的“插件”页面访问 Discourse Zendesk 设置。在该页面上，点击“discourse-zendesk-plugin”条目对应的“设置”按钮。
配置 OAuth
首先，在 Zendesk 中创建一个 OAuth 客户端：
- 在 Zendesk 管理中心中，前往 应用和集成 > API > OAuth 客户端。
- 点击 添加 OAuth 客户端。
- 输入 名称、描述，并选择 Confidential 作为客户端类型。不需要重定向 URL。
- 配置 范围（Scopes） 为
tickets:read、tickets:write、users:read和users:write，以将 OAuth 客户端限制为仅插件所需的范围。 - 保存客户端。
- 复制客户端的 标识符（Identifier） 和 密钥（Secret）。Zendesk 仅显示一次完整的密钥。
配置以下 Discourse 设置：
zendesk oauth client id：输入 OAuth 客户端的 标识符。zendesk oauth client secret：输入 OAuth 客户端的 密钥。
其他设置
-
zendesk url：输入您的 Zendesk 账户 URL，后跟/api/v2。例如，https://example.zendesk.com/api/v2。 -
zendesk enabled：启用或禁用该插件。 -
zendesk jobs api token：已弃用。现有安装应迁移到 OAuth。 -
zendesk jobs email：已弃用。现有安装应迁移到 OAuth。 -
zendesk autogenerate all categories（原为zendesk enable all categories）：为每个分类中的主题自动创建 Zendesk 工单。此设置默认禁用。 -
zendesk autogenerate categories（原为zendesk enabled categories）：选择其新主题应自动创建 Zendesk 工单的 Discourse 分类。 -
zendesk job push all posts：将回复作为工单评论推送到 Zendesk。此设置默认启用。 -
zendesk job push only author posts：仅推送由原始主题作者编写的回复。当zendesk job push all posts启用时，此设置适用，且默认禁用。 -
sync comments from zendesk和zendesk incoming webhook token：将 Zendesk 评论同步到 Discourse。请参阅 如何启用 Zendesk 双向同步。 -
zendesk tags：一个可选的标签列表，用于添加到从 Discourse 创建的 Zendesk 工单中。