Linear

اربط Linear ليستطيع الوكلاء تسجيل التذاكر من التحقيقات، وتحديث الحالات، وإبقاء أداة تتبع المشكلات لديك متزامنة مع ما يجدونه.

الإعداد

1. في Linear، افتح Settings وانتقل إلى Security & access.
2. تحت Personal API keys، أنشئ مفتاحاً. يحتاج إلى حق الكتابة ليستطيع الوكلاء إنشاء التذاكر وتحديثها.
3. الصق المفتاح في Polylane. يتحقق Polylane منه مقابل مساحة عمل Linear الخاصة بك ويربط.

يُشفَّر مفتاحك قبل تخزينه، ولا يراه الوكيل أبداً.

ما يستطيع الوكلاء فعله

• سرد الفرق وحالات تدفق العمل والأعضاء والمشاريع
• سرد التذاكر والبحث فيها وقراءتها مع تعليقاتها الأخيرة
• إنشاء تذاكر من نتائج التحقيقات، مع سلسلة الأدلة في الوصف
• تحديث حالة التذكرة وأولويتها والمكلَّف بها ومشروعها ووسومها وتاريخ استحقاقها
• التعليق على التذاكر بالنتائج والحالة
• تشغيل GraphQL حر على Linear API لأي شيء غير مغطى أعلاه؛ وتمرّ عمليات التغيير (mutations) ببوابة التأكيد نفسها

تطلب عمليات الكتابة على التذاكر التأكيد دائماً قبل تنفيذها.

webhooks والفرز

يسجّل الربط webhook من Polylane في مساحة عمل Linear الخاصة بك، يغطي التذاكر في كل الفرق العامة. مع وجود الـ webhook:

• تصل التذاكر التي تصبح عاجلة كتنبيهات وتُفرز لحظة انطلاقها؛ ويحلّ تخفيض التصعيد أو إكمال التذكرة التنبيه.

يتطلب إنشاء الـ webhook أن يكون مستخدم مفتاح API مسؤول مساحة عمل في Linear. ما زال المفتاح غير المسؤول يربط وتعمل كل أدوات الوكلاء؛ ولا يُتخطى إلا الفرز المدفوع بالـ webhook.

استكشاف الأخطاء

خطأ "Invalid API key"

• استخدم مفتاح API شخصياً من Security & access؛ فرموز OAuth غير مدعومة. يرسل Polylane المفتاح كما هو في ترويسة Authorization، من دون بادئة Bearer، تماماً كما يتوقع Linear للمفاتيح الشخصية.
• تحقق من أن المفتاح لم يُلغَ في Linear.

لا تنبيهات أو مشغّلات من Linear

• يحتاج إنشاء الـ webhook إلى مفتاح مسؤول مساحة العمل. أعد الربط بمفتاح مسؤول لتمكين الفرز والمشغّلات المدفوعة بالـ webhook.

الفصل

افصل Linear في Polylane، وهو ما يزيل أيضاً الـ webhook الذي سجّله، ثم ألغِ مفتاح API في Linear.