Discourse Zendesk

[Discourse]

	Summary	Create Zendesk tickets from Discourse topics.
	Install Guide	This plugin is bundled with Discourse core. There is no need to install the plugin separately.

As this is an official plugin maintained by the Discourse team, Support, Bug, UX, and Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started.

 Support  Bug  UX  Feature

Features

Create Zendesk tickets

This plugin allows you to create Zendesk tickets from Discourse topics. This can be done either by configuring the plugin so that all topics in a category automatically generate Zendesk tickets, or by pushing individual topics to Zendesk by clicking the “Create Zendesk Ticket” button that’s displayed for site staff below each topic:

When the ticket is created, the author of the topic’s first post will be set as the Requester on Zendesk. They will also be added to your Zendesk customers list.

After the ticket has been created, the “Create Zendesk Ticket” button will be updated to “View on Zendesk.” Clicking that button will take you to the associated Zendesk ticket:

Push replies created on Discourse to Zendesk

The plugin allows you to optionally push all replies to the Discourse topic to the Zendesk ticket, or to only push replies created by the topic’s author. Both of these features are configurable via the plugin’s settings.

Sync Zendesk comments with Discourse

Zendesk comment can be synced with the Discourse topic that the ticket originated on.

Configuration

The Discourse Zendesk settings can be accessed from the Plugins page of your Discourse site’s Admin section. Click the “Settings” button for the “discourse-zendesk-plugin” entry on that page to access the settings.

• zendesk url : enter the URL of your Zendesk account, followed by api/v2 . For example, https://example.zendesk.com/api/v2

• zendesk enabled : used to enable and disable the plugin.

• zendesk jobs api token : details for generating the API token on Zendesk are here: Generating a new API token – Zendesk help. Copy that token to this Discourse setting.

• zendesk jobs email : the email address of a staff user on your Zendesk account that also has an admin account on your Discourse site.

• zendesk autogenerate all categories (formerly zendesk enable all categories) : if enabled, all topics on your Discourse site will automatically generate Zendesk tickets. This setting is disabled by default.

• zendesk autogenerate categories (formerly zendesk enabled categories) : a list of Discourse categories that will have all new topics automatically pushed to Zendesk.

• zendesk job push all posts and zendesk job push only author posts : both of these settings are disabled by default. Enable one of them if you want to push either all replies, or only the topic author’s replies to Zendesk.

• sync comments from zendesk and zendesk incoming webhook token : these two settings are used to sync comments from Zendesk to Discourse. Details about how to configure syncing Zendesk comments to Discourse are here: How to enable Zendesk two-way sync

• zendesk tags : an optional list of tags to append to all Zendesk tickets that originate on your Discourse site.

Last edited by @tobiaseigen 2025-07-16T21:55:24Z

Check document

Perform check on document:

[Rob_Lauer]

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

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

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

谢谢！

[acorrea]

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

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

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

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

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

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

[TheDevBird (Shane Vandegrift)]

嘿！

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

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

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

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

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

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

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

谢谢！

[jessii]

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

@TheDevBird

同步插件会看到 Zendesk 中的新评论，并将其同步回 Discourse

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

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

[TheDevBird (Shane Vandegrift)]

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

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

[TheDevBird (Shane Vandegrift)]

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

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

[PeakProsperity (Aaron McKeon)]

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

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

[abinash889 (Abinash Bhatta)]

您好，

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

提前感谢您的帮助。

[gormus (Osman Görmüş)]

我有一个功能请求 : )

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

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

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

[tobiaseigen]

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