Discourse Zendesk

[Discourse]

	الملخص	إنشاء تذاكر Zendesk من مواضيع Discourse.
	دليل التثبيت	هذا الإضافة مدمجة مع Discourse core. لا حاجة لتثبيت الإضافة بشكل منفصل.

بما أن هذه إضافة official يتم صيانتها بواسطة فريق Discourse، يمكن تقديم طلبات #support، #contribute:bug، #contribute:ux، و Contribute > Feature في الفئات المناسبة هنا على Meta، مع وسمها بوسم الإضافة المناسب. انقر على أحد الروابط أدناه للبدء.

 الدعم  خطأ  تجربة المستخدم  ميزة

نظرًا لأن Zendesk ستقوم بـ إلغاء مصادقة رمز API نهائيًا في 30 أبريل 2027، فإن التثبيتات الحالية بحاجة إلى الانتقال إلى المصادقة عبر OAuth.

الميزات

إنشاء تذاكر Zendesk

تسمح لك هذه الإضافة بإنشاء تذاكر Zendesk من مواضيع Discourse. يمكن القيام بذلك إما من خلال تكوين الإضافة بحيث تقوم جميع المواضيع في فئة معينة بإنشاء تذاكر Zendesk تلقائيًا، أو من خلال دفع مواضيع فردية إلى Zendesk بالنقر على زر «إنشاء تذكرة Zendesk» الذي يظهر لموظفي الموقع أسفل كل موضوع:

عند إنشاء التذكرة، سيتم تعيين مؤلف أول منشور في الموضوع كـ «الطالب» (Requester) في Zendesk. كما سيتم إضافتهم إلى قائمة عملاء Zendesk لديك.

بعد إنشاء التذكرة، سيتم تحديث زر «إنشاء تذكرة Zendesk» ليصبح «عرض في Zendesk». عند النقر على هذا الزر، سيتم توجيهك إلى تذكرة Zendesk المرتبطة:

دفع الردود المنشأة على Discourse إلى Zendesk

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

مزامنة تعليقات Zendesk مع Discourse

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

التكوين

يمكن الوصول إلى إعدادات Discourse Zendesk من صفحة الإضافات في قسم الإدارة الخاص بموقع Discourse الخاص بك. انقر على زر «الإعدادات» لإدخال «discourse-zendesk-plugin» في تلك الصفحة.

تكوين OAuth

أولاً، أنشئ عميل OAuth في Zendesk:

1. في مركز إدارة Zendesk، انتقل إلى التطبيقات والتكاملات > واجهات برمجة التطبيقات (APIs) > عملاء OAuth.
2. انقر على إضافة عميل OAuth.
3. أدخل اسمًا، وصفًا، واختر Confidential كنوع العميل. لا يلزم إدخال عنوان URL لإعادة التوجيه.
4. قم بتكوين النطاقات (Scopes) لتكون tickets:read, tickets:write, users:read, و users:write لتقييد عميل OAuth بالنطاقات المطلوبة فقط بواسطة الإضافة.
5. احفظ العميل.
6. انسخ المعرّف (Identifier) و السر (Secret) الخاص بالعميل. تعرض Zendesk السر الكامل مرة واحدة فقط.

قم بتكوين إعدادات Discourse التالية:

• zendesk oauth client id: أدخل المعرّف (Identifier) الخاص بعميل OAuth.
• zendesk oauth client secret: أدخل السر (Secret) الخاص بعميل OAuth.

إعدادات أخرى

• zendesk url: أدخل عنوان URL لحساب Zendesk الخاص بك متبوعًا بـ /api/v2. على سبيل المثال، https://example.zendesk.com/api/v2.

• zendesk enabled: تفعيل أو تعطيل الإضافة.

• zendesk jobs api token: غير مدعوم (Deprecated). يجب على التثبيتات الحالية الانتقال إلى OAuth.

• zendesk jobs email: غير مدعوم (Deprecated). يجب على التثبيتات الحالية الانتقال إلى OAuth.

• zendesk autogenerate all categories (سابقًا zendesk enable all categories): إنشاء تذاكر Zendesk تلقائيًا للمواضيع في كل فئة. هذا الإعداد معطل افتراضيًا.

• zendesk autogenerate categories (سابقًا zendesk enabled categories): تحديد فئات Discourse التي يجب أن تنشئ مواضيعها الجديدة تذاكر Zendesk تلقائيًا.

• 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: قائمة اختيارية من الوسوم لإضافتها إلى تذاكر Zendesk المنشأة من Discourse.