Discourse Zendesk

自定义 插件
, ,
1
:discourse2: 摘要 从 Discourse 主题创建 Zendesk 工单。
:open_book: 安装指南 该插件已捆绑在 Discourse 核心中。无需单独安装该插件。

功能

创建 Zendesk 工单

此插件允许您从 Discourse 主题创建 Zendesk 工单。您可以通过配置插件来实现这一点，使类别中的所有主题自动创建 Zendesk 工单，或者通过单击每个主题下方显示的“创建 Zendesk 工单”按钮，将单个主题推送到 Zendesk（仅限站点工作人员可见）：

image
image967×453 34.3 KB

当工单创建后，主题首帖的作者将被设置为 Zendesk 上的请求者。他们也将被添加到您的 Zendesk 客户列表中。

工单创建后，“创建 Zendesk 工单”按钮将更新为“在 Zendesk 上查看”。单击该按钮将带您进入关联的 Zendesk 工单：

image
image889×456 33.6 KB

将 Discourse 上创建的回复推送到 Zendesk

该插件允许您选择将所有对 Discourse 主题的回复推送到 Zendesk 工单，或者仅推送到主题作者的回复。这两个功能均可通过插件设置进行配置。

同步 Zendesk 评论与 Discourse

Zendesk 评论可以与产生该工单的 Discourse 主题进行同步。

配置

Discourse Zendesk 设置可以从您 Discourse 站点管理部分的插件页面访问。单击该页面上“discourse-zendesk-plugin”条目的“设置”按钮以访问设置。

  • zendesk url ：输入您的 Zendesk 账户 URL，后跟 api/v2 。例如，https://example.zendesk.com/api/v2

  • zendesk enabled ：用于启用和禁用该插件。

  • zendesk jobs api token ：在 Zendesk 上生成 API 令牌的详细信息见此处：生成新的 API 令牌 – Zendesk 帮助。将该令牌复制到此 Discourse 设置中。

  • zendesk jobs email ：您 Zendesk 账户中也是您 Discourse 站点管理员的用户电子邮件地址。

  • zendesk autogenerate all categories (以前为 zendesk enable all categories) ：如果启用，您 Discourse 站点上的所有主题将自动创建 Zendesk 工单。此设置默认禁用。

  • zendesk autogenerate categories (以前为 zendesk enabled categories) ：将自动推送所有新主题到 Zendesk 的 Discourse 类别列表。

  • zendesk job push all posts 和 zendesk job push only author posts ：这两个设置默认禁用。如果您想推送所有回复或仅推送主题作者的回复到 Zendesk，请启用其中一个。

  • sync comments from zendesk 和 zendesk incoming webhook token ：这两个设置用于将 Zendesk 的评论同步到 Discourse。有关如何将 Zendesk 评论同步到 Discourse 的详细信息见此处：如何启用 Zendesk 双向同步

  • zendesk tags ：可选标签列表，将附加到所有源自您 Discourse 站点的 Zendesk 工单。

37 个赞
Integration Zendesk/Discourse
Migrating support tickets to a Discourse post
Integration Discourse <> JIRA/Zendesk
JIRA Service Desk integration?
Bundling more popular plugins with Discourse core
44

我很乐意为这个Zendesk集成提出功能请求：

将回复发送到Zendesk作为评论，以及从Zendesk拉取评论作为回复对我们来说都至关重要。然而，执行后者的唯一方法是让指定的Discourse类别主题自动创建Zendesk工单。

我更希望有一种方法可以让手动创建的Zendesk工单也能够将评论拉取为回复！这是因为我们有一个分类流程，其中只有一些客户创建的主题需要转发到Zendesk。我们不希望允许我们的最终用户在后台也创建Zendesk工单。

谢谢！

45

非常感谢您的插件，它对我们帮助很大！

我想寻求一些关于以下问题的帮助：

  • 在 Zendesk 中，当我们创建“内部备注”（私密备注）到工单时，这些内部备注不会产生 Discourse 的耳语。
  • 我在 Zendesk 中实现了一个 webhook，为每个内部备注创建一个耳语，但是，由于插件的正常工作，该耳语随后又被推送到 Zendesk。

所以，我的问题是：是否有办法阻止插件在创建耳语时在 Zendesk 中创建新评论，如上所述？

我知道我可以禁用所有帖子的同步，但目标是不只同步我通过 Discourse API 创建的那些耳语。

您知道是否有简单的解决方法吗？

1 个赞
46

嘿！

我不确定这里是否是报告错误的正确地方，所以如果我应该将此移至其他地方，请告诉我。

我们已经使用此插件几周了，总体而言效果很好。但是，我们发现了一个问题，即该插件似乎会双重同步评论。我认为发生的情况是：

  1. 用户在 Discourse 中发送帖子
  2. 它被同步到 Zendesk
  3. 同步插件在 Zendesk 中看到新评论，并将其同步回 Discourse

这是我们看到的视觉效果，其中 John（设置插件的管理员）有时会在没有他干预的情况下发送其他用户的消息的副本。这来自 discourse 同步插件：

image
image823×430 38.5 KB

在 Zendesk 端，我们没有看到任何重复的回复，只看到用户的回复（由于此论坛的限制，无法发布第二张截图）。

展开工单的历史记录视图在 Zendesk 上没有显示任何异常。

有什么关于可能出错的原因或如何调试此问题的想法吗？

谢谢！

6 个赞
48

嘿 Shane！我尝试测试了一下，看看是否能重现这个问题，但到目前为止我没有遇到同样的问题。

确认一下，听起来 ZD 只是自动将评论发送回 Discourse。John 没有引用或复制/粘贴评论？

在首次设置插件时，您是否在 ZD 上设置了任何 其他触发器？

3 个赞
49

感谢您的介入！是的，这是一个软件问题，John 不是自己发布这些消息的。

我会查看我们的触发器，并尝试禁用它们，然后再重新启用。不幸的是，我还没有发现这些消息发生的时间或原因有任何相似之处，所以没有直接的方法可以重现。

2 个赞
50

我发现了一个触发器，每当有工单更新并且它带有 discourse 标签时，它就会通过 PUT 请求通知 Discourse 同步 webhook。我不是设置这个插件的人，但这可能是原因吗？

image
image884×1189 53.7 KB

除了这个触发器之外，我看不到任何其他可能干扰的自动化。我已经要求我们的 Discourse 管理员返回 John 的所有评论列表（包括我们删除的评论），以便我可以交叉引用每个实例来尝试找到联系。

4 个赞
51

我一直在使用 Zendesk 插件，并且非常喜欢它。但是，刚刚发生了一些意想不到的事情。当团队中的另一名成员（以前是 Zendesk 的客服人员）回复 Discourse 中的一个帖子时，Zendesk 将消息回传给了 Discourse。因此，它在 Discourse 主题中发布了两次，一次是由在 Discourse 中发帖的团队成员发布的，另一次是由 Zendesk 中该工单的当前被分配人发布的。

有人遇到过这种情况并有解决方案吗？

52

您好，

我遇到了一个问题，即在社区端创建的私有主题未在 Zendesk 中生成。请问是否需要任何特定的设置或配置才能确保私有主题正确同步到 Zendesk？

提前感谢您的帮助。

1 个赞
53

我有一个功能请求 : )

我看到“创建/查看 Zendesk 工单”按钮仅对员工可见。

能否通过新的 zendesk_create_ticket_allowed_groups 和 zendesk_view_ticket_allowed_groups 插件设置来控制这些按钮的可见性，以获得更大的灵活性？

我不一定想授予我们的支持团队管理员或版主角色。他们当然是（Zendesk）域的管理员，但恕我直言，这并不总是证明在 Discourse 上拥有扩展特权的合理性。

54

:partying_face: 此插件现已作为 Bundling more popular plugins with Discourse core 的一部分，捆绑到 Discourse 核心中。如果您是自托管用户并使用了此插件，则需要在下次升级前将其从 app.yml 中移除。

1 个赞