تكامل GitHub Issues
يعمل مع GitHub
اربط ReplyRabbit بـ GitHub Issues حتى تتحول محادثات الدعم في FreeScout إلى مشكلات منظمة في المستودع الصحيح. يمكن للوكلاء إنشاء مشكلة من محادثة، وإبقاء المشكلة المرتبطة ظاهرة في FreeScout، وترك ReplyRabbit يجهّز التسليم إلى الهندسة.
هل تبحث عن النظرة العامة؟
نظرة عامة
يضيف تكامل GitHub Issues لوحة GitHub إلى ReplyRabbit في محادثة FreeScout. عند تهيئة GitHub، يمكن لـ ReplyRabbit إنشاء بلاغ بعنوان ملائم للمطورين وملخص مفيد وتسميات ومسندين وسياق المستودع ورابط يعود إلى محادثة الدعم.
يختار كل صندوق بريد متتبع مشكلات واحدًا: لا شيء أو Linear أو GitHub. GitHub وLinear بدائل لنفس سير عمل الدعم إلى الهندسة، وليسا متتبعين يعملان معًا في صندوق بريد واحد.
إنشاء مشكلة GitHub يدويًا متاح في Pro وTeam. إنشاء مشكلة GitHub تلقائيًا من رسائل العملاء الجديدة متاح في Team.
المتطلبات الأساسية
قبل أن تبدأ، تأكد من أن لديك:
- تركيب FreeScout عامل.
- تثبيت ReplyRabbit وتفعيله.
- خطة ReplyRabbit تتضمن ميزة GitHub التي تريد استخدامها.
- الوصول إلى حساب GitHub أو مؤسسة حيث ينبغي إنشاء المشكلات.
- مستودع مع تفعيل GitHub Issues.
إذا لم يكن ReplyRabbit مثبتاً بعد، ابدأ بـ كيفية تثبيت وحدة ReplyRabbit، ثم أكمل كيفية إعداد ReplyRabbit.
الأذونات ونطاق الرمز
يتصل ReplyRabbit بـ GitHub باستخدام رمز وصول شخصي تقدمه في إعدادات صندوق البريد. يوصى باستخدام رمز دقيق محدد النطاق، مقتصر على المستودعات التي يجب أن يستخدمها ReplyRabbit. يمكنك إنشاء واحد من إعدادات الرمز الدقيق لـ GitHub.
امنح الرمز وصولًا كافيًا لقراءة بيانات المستودع الوصفية، وقراءة التسميات والمسند إليهم، وإنشاء المشكلات وتحديثها، وإضافة تعليقات المشكلات. للرمز الدقيق، ابدأ بـ البيانات الوصفية: قراءة, المحتويات: قراءة، و المشكلات: قراءة وكتابة للمستودعات المحددة.
لسجلات تدقيق أكثر صرامة، أنشئ الرمز من حساب روبوت GitHub مخصص لا يملك وصولًا إلا إلى المستودعات التي يجب أن يستخدمها ReplyRabbit.
أبقِ الرمز خاصًا. إذا تم تدوير الرمز أو إزالته في GitHub، فحدّث إعدادات صندوق البريد قبل إنشاء المزيد من المشكلات.
ربط GitHub Issues
افتح إعدادات صندوق البريد
في FreeScout، افتح صندوق البريد الذي يجب أن ينشئ مشكلات GitHub، ثم افتح الإعدادات واختر ReplyRabbit.اختر GitHub كمتتبع مشكلات
في محدد متتبع المشكلات، اختر GitHub Issues. يعرض ReplyRabbit إعدادات GitHub ويخفي إعدادات Linear لصندوق البريد ذلك.الصق الرمز
الصق رمز وصول شخصي لـ GitHub. إذا حفظت رمزاً بالفعل، يعرض ReplyRabbit معاينة مقنّعة بدلاً من السر الكامل.تحميل المستودعات
انقر على الزر لتحميل المستودعات من GitHub، ثم اختر المستودع الافتراضي حيث ينبغي إنشاء المشكلات الجديدة.حفظ الإعدادات
احفظ إعدادات صندوق البريد. يخزن ReplyRabbit اتصال GitHub لصندوق البريد هذا.
هيّئ الإعدادات الافتراضية
بعد اختيار المستودع الافتراضي، هيّئ الإعدادات الافتراضية للمشكلات التي ينبغي أن يبدأ منها وكلاؤك:
- المستودع الافتراضي: اختر مكان إنشاء المشكلات عندما لا تطابق أي قاعدة توجيه.
- إرسال المشكلات تلقائياً: في خطة Team، دع ReplyRabbit ينشئ مشكلات GitHub تلقائيًا عندما تشير نتيجة الفرز إلى الحاجة إلى عمل هندسي.
- توجيه المستودع: تمكين الاختيار التلقائي للمستودع عندما تريد أن يطابق ReplyRabbit المحادثات مع المستودعات المتاحة.
- تعيينات النطاقات: عيّن نطاقات البريد الإلكتروني للعملاء إلى مستودعات محددة عندما تحتاج إلى توجيه حتمي.
- الوسوم: اختر التسميات التي يمكن لـ ReplyRabbit تطبيقها لنوع المشكلة أو الأولوية أو وسوم سير العمل الأخرى.
- تسميات الأولوية: عيّن مستويات أولوية ReplyRabbit إلى تسميات GitHub، لأن GitHub Issues لا يحتوي على حقل أولوية أصلي.
- المسؤول الافتراضي: اختر مستخدم GitHub الذي ينبغي أن يتلقى المشكلات الجديدة افتراضياً.
- ملاحظة المراجعة: عند تفعيل الإنشاء التلقائي للمشكلات، أضف ملاحظة FreeScout تخبر الوكلاء بأن المشكلة أُنشئت تلقائيًا ويجب مراجعتها.
توجيه المستودع اختياري. إذا لم تتم مطابقة أي مستودع بثقة، يستخدم ReplyRabbit المستودع الافتراضي.
إنشاء مشكلة GitHub من محادثة FreeScout
افتح محادثة في صندوق بريد حيث تم ضبط GitHub. يمكن للوحة ReplyRabbit إنشاء مشكلة GitHub من سلسلة العميل، ثم عرض المشكلة المرتبطة في FreeScout.
يُولد محتوى المشكلة لتسليم هندسي، ولا يُنسخ بشكل أعمى من سلسلة البريد الإلكتروني بأكملها. راجع العنوان والملخص والتسميات والمعينين والمستودع قبل إنشاء المشكلة عند استخدام الإنشاء اليدوي.
يمكن لـ ReplyRabbit أيضاً إضافة سياق سلسلة البريد الإلكتروني كتعليق على مشكلة GitHub، حتى يحصل فريق الهندسة على تفاصيل العميل دون مطالبة الدعم بلصق السلسلة نفسها مرة أخرى.
أبقِ المحادثات والمشكلات متزامنة
بمجرد ربط مشكلة، يمكن لمحادثة FreeScout عرض معرّف مشكلة GitHub الحالية وعنوانها وحالتها وتسمياتها والمسندين إليها. يمكن للوكلاء فتح المشكلة في GitHub عندما يحتاجون إلى العرض الهندسي الكامل.
يدعم ReplyRabbit أيضًا حلقة إكمال: يفحص مشكلات GitHub المرتبطة وفق جدول، عادةً كل 5 دقائق. عندما يغلق GitHub مشكلة، يمكن لـ ReplyRabbit المساعدة في صياغة متابعة العميل حتى يتمكن الدعم من إغلاق المحادثة بسياق. إذا كان فريقك يستخدم أسباب إغلاق GitHub، يمكنك تقييد مسودات الإكمال بالمشكلات المغلقة كمنجزة.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| لن تُحمّل المستودعات | تأكد من أن الرمز ساري المفعول ويمكنه الوصول إلى مستودعات GitHub المحددة. |
| المشكلات لا تُنشأ | تأكد من أن GitHub هو متتبع المشكلات المحدد، ومن تحديد مستودع افتراضي، ومن أن خطة ReplyRabbit تتضمن الميزة. |
| لا يتم إنشاء المشكلات التلقائية | تأكد من أنك على خطة Team و إرسال المشكلات تلقائياً ممكّن. |
| المستودع خاطئ أو مفقود | تأكد من تهيئة توجيه المستودع أو تعيينات النطاقات. يستخدم ReplyRabbit المستودع الافتراضي عندما لا يوجد تطابق واثق. |
| لن يتم تحديث الوسوم أو المسند إليهم | أعد تحميل المحادثة، ثم تأكد من أن الرمز لا يزال لديه وصول إلى المستودع المرتبط. |
| يعيد GitHub أخطاء حد المعدل | انتظر إعادة ضبط حد GitHub API للرمز، ثم فكر في تضييق الوصول إلى المستودعات أو تقليل نشاط المشكلات الآلي. |
| المشكلات المغلقة لا تولّد مسودات | تأكيد مسودة تلقائية عند Done ممكّن، وإذا كان وضع الإكمال فقط قيد التشغيل، تم إغلاق مشكلة GitHub كمكتملة. |
للإصلاحات الأوسع، راجع استكشاف أخطاء ReplyRabbit وإصلاحها.
الخصوصية والتعامل مع البيانات
يرسل ReplyRabbit إلى GitHub محتوى المشكلة اللازم لتسليم الهندسة. يمكن أن يشمل ذلك سياق العميل ذي الصلة وعنوان المشكلة المنشأ والملخص المنشأ والتسميات والمعيّنين ورابط محادثة FreeScout أو معرّفها.
لا تضع معلومات حساسة في مشكلة GitHub ما لم يكن المستودع مسموحًا له باستقبالها. إذا كان يجب أن تبقى بيانات العملاء بالكامل على خادمك، فأبقِ GitHub معطلاً لصندوق البريد هذا.
الخطوات التالية
- تابع باستخدام كيفية إعداد ReplyRabbit إذا كان صندوق البريد لا يزال بحاجة إلى إعدادات المزود أو السياق أو النمط.
- قراءة تكامل Slack إذا كان فريقك يريد إنشاء المشكلات أو إشعارات الإكمال في Slack.
- قارن مع تكامل Linear إذا كنت تقرر أي متتبع مشكلات يجب أن يستخدمه صندوق البريد.
الأسئلة الشائعة
هل أحتاج إلى رمز وصول شخصي لـ GitHub؟
نعم. يتصل ReplyRabbit بـ GitHub باستخدام رمز من حساب GitHub أو مؤسستك الخاصة.
هل يمكن لصندوق بريد واحد استخدام Linear و GitHub في الوقت نفسه؟
لا. يختار كل صندوق بريد متتبع مشكلات واحدًا: لا شيء أو Linear أو GitHub.
هل يمكن لـ ReplyRabbit اختيار مستودع GitHub؟
نعم، عندما يتم تكوين توجيه المستودع. يدعم ReplyRabbit تعيينات النطاق ومطابقة المستودعات بالذكاء الاصطناعي للمستودعات التي يمكن لرمزك الوصول إليها.
أي خطة تتضمن GitHub Issues؟
إنشاء مشكلة GitHub يدويًا ميزة في Pro. إنشاء مشكلة GitHub تلقائيًا ميزة في Team.
هل يرسل ReplyRabbit محادثة العميل بأكملها إلى GitHub؟
يرسل ReplyRabbit محتوى المشكلة اللازم لتسليم الهندسة، بما في ذلك سياق العميل ذي الصلة والملخص المنشأ.