تكامل Jira
يعمل مع Jira
اربط ReplyRabbit بـ Jira Cloud حتى تتحول محادثات الدعم في FreeScout إلى مشكلات Jira منظمة. يمكن للوكلاء إنشاء مشكلة Jira من محادثة، وإبقاء المشكلة المرتبطة ظاهرة في FreeScout، واستخدام ReplyRabbit لتجهيز متابعة العميل عند إنجاز العمل.
هل تبحث عن النظرة العامة؟
نظرة عامة
يضيف تكامل Jira لوحة Jira إلى ReplyRabbit في محادثة FreeScout. عند تهيئة Jira لصندوق بريد، يمكن لـ ReplyRabbit إنشاء بلاغ بعنوان ووصف وأولوية وتسميات ومسند ونوع بلاغ ومشروع ورابط يعود إلى محادثة الدعم.
تم اختيار Jira كمتتبع المشكلات النشط لصندوق بريد. إذا كان صندوق بريد يستخدم بالفعل Linear أو GitHub Issues، فأبقِ ذلك المتتبع محددًا حتى تصبح جاهزًا لنقل ذلك الصندوق إلى Jira.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- تثبيت ReplyRabbit وتفعيله.
- خطة ReplyRabbit تتضمن ميزة Jira التي تريد استخدامها.
- موقع Jira Cloud مثل
https://example.atlassian.net. - بريد حساب Jira ورمز API مع صلاحية الوصول إلى المشروع المستهدف.
- مشروع Jira واحد على الأقل ونوع مشكلة يدعم إنشاء المشكلات.
- أذونات مشروع Jira لسير العمل الذي تفعّله: مطلوب Browse Projects وCreate Issues؛ وتلزم Edit Issues وAssign Issues وTransition Issues وAdd Comments عند استخدام تعديلات الأولوية/التسمية أو الإسناد أو انتقالات الحالة أو تعليقات السلسلة.
إذا لم يكن ReplyRabbit مثبتاً بعد، ابدأ بـ كيفية تثبيت وحدة ReplyRabbit، ثم أكمل كيفية إعداد ReplyRabbit.
الأذونات ورموز API
يتصل ReplyRabbit بـ Jira Cloud REST API v3 باستخدام مصادقة Basic. يخزن صندوق البريد ثلاث قيم اتصال:
- عنوان URL لموقع Jira: ال
https://example.atlassian.netعنوان URL للموقع. - Account Email: بريد حساب Atlassian الإلكتروني المستخدم مع رمز API.
- API Token: رمز Jira Cloud API لذلك الحساب.
يُخزَّن رمز API كإعداد صندوق بريد مشفّر ولا يُعرض كاملاً بعد حفظه. إذا تم تدوير الرمز أو إزالته في Atlassian، فحدّث إعدادات صندوق البريد قبل إنشاء المزيد من البلاغات.
ربط Jira
افتح إعدادات صندوق البريد
في FreeScout، افتح صندوق البريد الذي يجب أن ينشئ مشكلات Jira، ثم افتح الإعدادات واختر ReplyRabbit.اختر Jira كمتتبع مشكلات
في التكاملات القسم، اضبط متتبع المشكلات على Jira. يمكن لصندوق البريد استخدام Linear أو GitHub Issues أو Jira أو لا متتبع مشكلات.إضافة بيانات اعتماد Jira
الصق عنوان URL لموقع Jira Cloud وبريد الحساب ورمز API.تحميل مشاريع Jira
حمّل المشاريع من Jira، ثم اختر المشروع الافتراضي للمشكلات الجديدة.اختر نوع المشكلة
حمّل أنواع المشكلات للمشروع واختر نوع المشكلة الافتراضي، مثل Task أو Bug.حفظ الإعدادات
احفظ إعدادات صندوق البريد. يخزن ReplyRabbit اتصال Jira لصندوق البريد هذا.
هيّئ الإعدادات الافتراضية
بعد ربط Jira، هيّئ الإعدادات الافتراضية التي يحتاجها فريقك:
- المشروع الافتراضي: مشروع Jira المستخدم عندما لا يختار أي تعيين نطاق أو مطابقة مشروع بالذكاء الاصطناعي مشروعًا مختلفًا.
- نوع المشكلة الافتراضي: نوع المشكلة للمشكلات الجديدة، عادةً Task أو Bug.
- تعيين الأولوية: عيّن مستويات أولوية ReplyRabbit إلى أسماء أولوية Jira الأصلية.
- توجيه المشروع: عيّن نطاقات البريد الإلكتروني للعملاء إلى مشاريع Jira عندما يجب أن يكون التوجيه حتميًا.
- إرسال المشكلات تلقائياً: في خطة Team، دع ReplyRabbit ينشئ مشكلات Jira تلقائيًا عندما يشير الفرز إلى الحاجة إلى عمل هندسي.
- مسودة تلقائية عند Done: دع ReplyRabbit يحضر متابعة للعميل عندما تصل مشكلة Jira المرتبطة إلى فئة حالة Done.
توجيه المشروع اختياري. إذا لم تتم مطابقة أي مشروع بثقة، يستخدم ReplyRabbit مشروع صندوق البريد الافتراضي.
إنشاء مشكلة Jira من محادثة FreeScout
افتح محادثة في صندوق بريد حيث تم ضبط Jira. يمكن للوحة ReplyRabbit إنشاء مشكلة Jira من سلسلة العميل، ثم عرض المشكلة المرتبطة في FreeScout.
يرسل ReplyRabbit إلى Jira وصفاً منظماً بصيغة Atlassian Document Format. يتضمن الوصف ملخص الدعم وسياق العميل ورابط محادثة FreeScout. يُعامل نص العميل كمحتوى وليس كتعليمات.
بعد الإنشاء، راجع مشكلة Jira المرتبطة واضبط الحالة أو الأولوية أو المسؤول أو الوسوم من لوحة ReplyRabbit عند الحاجة.
أبقِ المحادثات والمشكلات متزامنة
بمجرد ربط مشكلة، يمكن لمحادثة FreeScout عرض حالة Jira الحالية والأولوية والمسند والتسميات ومفتاح المشكلة. يمكن للوكلاء فتح المشكلة في Jira عندما يحتاجون إلى العرض الهندسي الكامل.
يغيّر ReplyRabbit حالة Jira عبر انتقالات Jira. ولا يكتب مباشرة في حقل الحالة.
يدعم ReplyRabbit أيضًا حلقة إكمال. يفحص فحص حالة مجدول مشكلات Jira المرتبطة. عندما تُبلغ Jira عن فئة حالة Done، يمكن لـ ReplyRabbit المساعدة في صياغة متابعة العميل حتى يتمكن الدعم من إغلاق المحادثة بسياق.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| لن يتم تحميل المشاريع | تأكد من أن عنوان URL للموقع هو Jira Cloud atlassian.net URL، والبريد الإلكتروني صحيح، ورمز API لديه وصول إلى المشروع. |
| أنواع المشكلات مفقودة | تأكد من أن المشروع المحدد يدعم نوع المشكلة الذي تتوقع استخدامه. |
| المشكلات لا تُنشأ | تأكد من تحديد Jira كمتتبع مشكلات لصندوق البريد، ومن تحديد مشروع، ومن أن خطة ReplyRabbit تتضمن الميزة. |
| لا يتم إنشاء المشكلات التلقائية | تأكد من أنك على خطة Team و إرسال المشكلات تلقائياً ممكّن. |
| لن يتم تحديث الحالة | أعد تحميل المحادثة، ثم تأكد من أن Jira يعرض انتقالًا صالحًا للحالة المستهدفة. |
| مسودات الإكمال لا تظهر | تأكيد مسودة تلقائية عند Done ممكّن ووصلت مشكلة Jira المرتبطة إلى فئة حالة Done. |
للإصلاحات الأوسع، راجع استكشاف أخطاء ReplyRabbit وإصلاحها.
الخصوصية والتعامل مع البيانات
يرسل ReplyRabbit إلى Jira محتوى المشكلة اللازم لتسليم الهندسة. يمكن أن يشمل ذلك سياق العميل ذي الصلة ونص المشكلة المنشأ والأولوية والتسميات والمعيّن ورابط محادثة FreeScout أو معرّفها.
لا تضع معلومات حساسة في مشكلة Jira ما لم تكن مساحة عمل Jira Cloud الخاصة بك مسموحًا لها باستقبالها. إذا كان يجب أن تبقى بيانات العملاء بالكامل على خادمك، فأبقِ Jira معطلاً لصندوق البريد هذا.
الأسئلة الشائعة
هل يدعم ReplyRabbit Jira Data Center أو Server؟
لا. يدعم ReplyRabbit مواقع Jira Cloud التي تستخدم عنوان URL بصيغة atlassian.net.
هل أحتاج إلى OAuth لـ Jira؟
لا. يستخدم ReplyRabbit مصادقة Jira Cloud Basic لكل صندوق بريد مع عنوان URL للموقع وبريد الحساب ورمز Jira API.
هل يمكن لصندوق بريد واحد استخدام Jira مع Linear أو GitHub Issues في الوقت نفسه؟
لا. يختار كل صندوق بريد متتبع مشكلات نشطًا واحدًا. تبقى إعدادات Linear وGitHub Issues متاحة عند اختيار أي منهما.
هل يمكن لـ ReplyRabbit صياغة متابعة للعميل عندما تكتمل مشكلة Jira؟
نعم. يستقصي ReplyRabbit مشكلات Jira المرتبطة ويمكنه إعداد مسودة متابعة للعميل عندما تُبلغ Jira عن فئة حالة Done.