Discourse Zendesk

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

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 documentPerform check on document:
36 إعجابًا

أود تقديم طلب ميزة لهذا التكامل مع Zendesk:

القدرة على إرسال الردود إلى Zendesk كتعليقات، وسحب التعليقات من Zendesk كردود أمر بالغ الأهمية بالنسبة لنا. ومع ذلك، فإن الطريقة الوحيدة لأداء الأخيرة هي أن تقوم مواضيع فئة Discourse محددة بإنشاء تذاكر Zendesk تلقائيًا.

أفضل بكثير لو كانت هناك طريقة لجعل التذاكر التي تم إنشاؤها يدويًا في Zendesk قادرة أيضًا على سحب التعليقات كردود! هذا لأنه لدينا عملية فرز معمول بها حيث تحتاج بعض المواضيع التي أنشأها العملاء فقط إلى إعادة توجيهها إلى Zendesk. لا نريد السماح للمستخدمين النهائيين لدينا بإنشاء تذاكر Zendesk في الخلفية.

شكرًا!

شكراً جزيلاً على الإضافة، لقد ساعدتنا كثيراً!

أود بعض المساعدة بخصوص المشكلة التالية:

  • في Zendesk، عندما ننشئ “ملاحظات داخلية” (ملاحظات خاصة) في تذكرة، فإن تلك الملاحظات الداخلية لا تنتج “همسة” (whisper) في Discourse.
  • قمت بتنفيذ خطاف ويب (webhook) في Zendesk لإنشاء “همسة” لكل “ملاحظة داخلية”، ومع ذلك، يتم دفع تلك “الهمسة” إلى Zendesk بسبب العمل الطبيعي للإضافة.

لذا، سؤالي هو: هل هناك طريقة لمنع الإضافة من إنشاء تعليق جديد في Zendesk عندما أقوم بإنشاء “الهمسات” من “الملاحظات الداخلية”، كما هو موضح أعلاه؟

أعلم أنه يمكنني تعطيل المزامنة لجميع المشاركات، ولكن الهدف هو عدم مزامنة تلك الهمسات التي أنشئها عبر Discourse API فقط.

هل تعرف ما إذا كان هناك حل سهل لذلك؟

إعجاب واحد (1)

أهلاً!

لست متأكدًا مما إذا كان هذا هو المكان المناسب للإبلاغ عن خطأ، لذا أخبرني إذا كان يجب علي نقل هذا إلى مكان آخر.

لقد كنا نستخدم هذه الإضافة لبضع أسابيع حتى الآن وقد عملت بشكل جيد بشكل عام. ومع ذلك، وجدنا مشكلة حيث يبدو أن الإضافة تقوم بمزامنة التعليقات مرتين. ما أعتقد أنه يحدث هو:

  1. يرسل المستخدم منشورًا في Discourse
  2. تتم مزامنته في Zendesk
  3. ترى إضافة المزامنة التعليق الجديد في Zendesk وتقوم بمزامنته مرة أخرى إلى Discourse

إليك ما نراه بصريًا حيث يرسل John (المسؤول الذي قام بإعداد الإضافة) أحيانًا نسخًا مكررة من رسائل المستخدمين الآخرين دون تدخله. هذا يأتي من إضافة مزامنة discourse:

على جانب Zendesk، لا نرى أي ردود مكررة، ونرى فقط من المستخدم (لا يمكن نشر لقطة شاشة ثانية بسبب قيود هذا المنتدى).

توسيع عرض سجل التذكرة لا يظهر أي شذوذ في Zendesk.

أي أفكار حول ما يمكن أن يحدث خطأ أو كيف يمكننا تصحيح هذا؟

شكرًا!

6 إعجابات

مرحباً شين! لقد حاولت اختبار هذا لمعرفة ما إذا كان بإمكاني تكرار المشكلة ولكن حتى الآن لم أواجه نفس المشكلة.

للتأكيد، يبدو أن ZD يرسل التعليق تلقائيًا مرة أخرى إلى Discourse. أليس جون يقتبس أو ينسخ/يلصق التعليق؟

هل قمت بإعداد أي مشغلات إضافية على ZD عند إعداد المكون الإضافي لأول مرة؟

3 إعجابات

شكراً على المشاركة! نعم، هذه مشكلة برمجية، جون لا ينشر هذه الرسائل بنفسه.

سألقي نظرة على المشغلات الخاصة بنا وأختبر تعطيلها وإعادة تمكينها. للأسف، لم أجد أي تشابه بين وقت حدوث ذلك أو سببه، لذلك ليس لدي طريقة مباشرة لإعادة إنتاجه.

إعجابَين (2)

لقد وجدت مشغلًا، كلما تم تحديث تذكرة ولديها علامة discourse، فإنه سيقوم بإخطار خطاف مزامنة Discourse عبر طلب PUT. لم أكن أنا من قام بإعداد المكون الإضافي، ولكن هل يمكن أن يكون هذا هو السبب؟

بخلاف هذا المشغل، لا أرى أي أتمتة أخرى قد تتداخل. لقد طلبت من مسؤولي Discourse لدينا إرجاع قائمة بجميع تعليقات John (بما في ذلك تلك التي حذفناها) حتى أتمكن من الرجوع إليها بالرجوع إلى كل مثيل لمحاولة العثور على اتصال.

4 إعجابات

لقد كنت أستخدم إضافة Zendesk وأعجبت بها حقًا. ومع ذلك، حدث شيء غير متوقع للتو. عندما رد عضو آخر في الفريق (شخص كان وكيلًا في Zendesk) على سلسلة مناقشات في Discourse، أرسل Zendesk الرسالة مرة أخرى إلى Discourse. لذلك، تم نشرها في موضوع Discourse مرتين، مرة واحدة كتبها عضو الفريق الذي نشرها في Discourse، ومرة أخرى بواسطة المعين الحالي للتذكرة في Zendesk.

هل واجه أي شخص هذا ولديه حل؟

مرحباً،

أواجه مشكلة حيث لا يتم إنشاء المواضيع الخاصة التي تم إنشاؤها على جانب المجتمع في Zendesk. هل يمكن لأحد أن يقدم لي النصح بشأن أي إعدادات أو تكوينات محددة مطلوبة لضمان مزامنة المواضيع الخاصة بشكل صحيح مع Zendesk؟

شكراً مقدماً على مساعدتكم.

إعجاب واحد (1)

لدي طلب ميزة : )

أرى أن أزرار “إنشاء/عرض تذكرة Zendesk” مرئية للموظفين فقط.

هل يمكن التحكم في رؤية هذه الأزرار من خلال إعدادات جديدة للمكون الإضافي zendesk_create_ticket_allowed_groups و zendesk_view_ticket_allowed_groups لمزيد من المرونة؟

لا أرغب بالضرورة في منح أدوار المسؤول أو المشرف لفرق الدعم لدينا. إنهم بالطبع المسؤولون عن مجالهم (Zendesk)، ولكن في رأيي لا يبرر ذلك دائمًا الامتيازات الموسعة على Discourse.

:partying_face: تم تضمين هذه الإضافة الآن مع Discourse الأساسي كجزء من Bundling more popular plugins with Discourse core. إذا كنت تستضيف بنفسك وتستخدم الإضافة، فأنت بحاجة إلى إزالتها من app.yml قبل الترقية التالية.

إعجاب واحد (1)