الاستيراد من Zendesk

Shayan Taslimتم التحديث

استخدم أداة الاستيراد من Zendesk لنقل المنشورات والتعليقات والتصويتات المؤيدة والمتابعين من منتدى مجتمع Zendesk (Zendesk Gather) إلى لوحات UserJot.

Note

تنقل أداة الاستيراد هذه منتديات مجتمع Zendesk، وليس تذاكر Zendesk Support أو مقالات قاعدة المعرفة في مركز المساعدة. لنقل مقالات مركز مساعدة Zendesk، استخدم استيراد مركز مساعدة موجود.

متاح لمشرفي مساحات العمل ومالكيها في جميع الخطط، بما فيها الخطة المجانية.

إنشاء عميل OAuth سري في Zendesk

يتصل UserJot بـ Zendesk باستخدام منحة OAuth client_credentials (لا حاجة إلى عنوان URI لإعادة التوجيه).

  1. افتح مركز إدارة Zendesk → التطبيقات وعمليات التكامل → واجهات برمجة التطبيقات → عملاء OAuth.

  2. أنشئ عميل OAuth سريًا وامنحه النطاقين hc:read وusers:read. يتيح هذان النطاقان لـ UserJot قراءة مواضيع المجتمع والمنشورات والتعليقات والتصويتات والاشتراكات ورسائل البريد الإلكتروني للأعضاء، من دون الوصول إلى تذاكر Support.

  3. انسخ معرّف العميل وسر العميل.

لا يخزّن UserJot بيانات اعتماد Zendesk الخاصة بك بشكل دائم. تُشفّر هذه البيانات فقط أثناء تشغيل مهمة الاستيراد في الخلفية، ثم تُحذف فورًا بعد ذلك.

تنفيذ الاستيراد

  1. في UserJot، افتح الإعدادات → البيانات & الاستيراد، ثم انقر على الاستيراد من Zendesk.

  2. أدخل النطاق الفرعي لـ Zendesk (النطاق الفرعي .zendesk.com، مثل acme.zendesk.com؛ لا تُقبل النطاقات المخصصة المرتبطة بالمضيف، مثل support.acme.com)، ومعرّف العميل، وسر العميل، ثم انقر على متابعة.

  3. في صفحة اختيار المواضيع، اربط كل موضوع من Zendesk بلوحة UserJot، أو اترك الموضوع مضبوطًا على عدم الاستيراد. تُحدّد المواضيع التي تتطابق أسماؤها مع لوحة موجودة في UserJot مسبقًا تلقائيًا، مع تجاهل حالة الأحرف. اربط موضوعًا واحدًا على الأقل، ثم انقر على متابعة.

  4. راجع جاهز للاستيراد (تستغرق العملية عادةً نحو 15 دقيقة)، ثم انقر على بدء الاستيراد.

ينفّذ UserJot عملية الاستيراد في الخلفية، ويرسل رسالة بريد إلكتروني إلى المشرف الذي بدأها عند اكتمالها (الموضوع: Your Zendesk import is done). يمكنك إعادة تنفيذ الاستيراد بأمان، إذ تُزال التكرارات من المنشورات والتعليقات والتصويتات والمتابعين الذين سبق استيرادهم، استنادًا إلى معرّفات Zendesk الخاصة بهم.

ما يتم استيراده وما يتم تخطيه

بيانات Zendesk

طريقة التعامل معها في UserJot

المنشورات

تُستورد كطلبات عامة، مع العنوان والنص (يُحوّل HTML إلى نص عادي، بحد أقصى 20,000 حرف) وتاريخ الإنشاء الأصلي والحالة وإجمالي التصويتات المؤيدة.

الحالات

none → معلّق، وplanned → مخطط له، وcompleted → مكتمل، وnot_planned وanswered → مغلق.

التعليقات

تُستورد ضمن منشوراتها من دون تسلسل هرمي (بحد أقصى 10,000 حرف)، مع تاريخ الإنشاء وعدد التصويتات المؤيدة. تُتخطى التعليقات الفارغة التي لا تحتوي على نص أو صور.

الصور

تُنسخ صور HTTPS الخارجية وتُرفق. أما الصور /hc/ المستضافة على Zendesk فتبقى روابط في نص المحتوى، لأن Zendesk يمنع التنزيلات من جهة الخادم.

التصويتات

تُستورد التصويتات المؤيدة، بينما تُتخطى التصويتات المعارضة. تُنشأ سجلات تصويت فردية للمستخدمين الذين لديهم بريد إلكتروني أو معرّف خارجي (وتظل أصوات مستخدمي Zendesk المحذوفين محسوبة ضمن إجمالي المنشور).

المتابعون

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

ما لا يتم استيراده

تذاكر Support، ومقالات مركز المساعدة، ووسوم المحتوى، والتصويتات المعارضة، والمواضيع غير المرتبطة، وسجلات التغييرات.

استكشاف الأخطاء وإصلاحها

  • «تعذّر العثور على حساب Zendesk.» أدخل النطاق الفرعي .zendesk.com بدلًا من نطاق مخصص.

  • «لم يقبل Zendesk معرّف العميل وسرّه.» تأكد من ضبط عميل OAuth في Zendesk على سري، وليس عامًّا.

  • «لا يمكن لعميل OAuth هذا قراءة المنتدى.» تأكد من تفعيل النطاقين hc:read وusers:read على العميل.

  • حدود المعدل. يقتصر تحميل المواضيع على 10 طلبات في الساعة، ويقتصر بدء الاستيراد على 3 مرات في الساعة و5 مرات في اليوم.

الخطوات التالية

هل أجاب هذا عن سؤالك؟