يجلب التكامل Linear إمكانات إدارة المشاريع القوية إلى موقعك المدعوم بالذكاء الاصطناعي chatbot. ربط Botpress بسلاسة مع Linear ، وهي أداة حديثة لتتبع المشكلات وإدارة سير العمل. من خلال هذا التكامل، يمكنك أتمتة إنشاء المهام وتتبع التقدم المحرز والتعاون في المشاريع مباشرةً داخل chatbot. قم بتمكين chatbot الخاص بك من إنشاء وتحديث واسترداد المشكلات Linear ، وتعيين المهام لأعضاء الفريق، وتتبع تواريخ الاستحقاق، والمزيد. قم بتبسيط عمليات إدارة مشروعك وتعزيز إنتاجية الفريق من خلال تكامل Linear لـ Botpress. ## الترحيل من الإصدار '0.x' إلى الإصدار '1.x' يتطلب الإصدار '1.0' من تكامل Linear الآن من المستخدمين تقديم سر توقيع webhook . إذا كنت تستخدم مصادقة OAuth، فلن تتأثر بهذا التغيير. إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات للمصادقة مع Linear ، فيجب عليك توفير سر توقيع webhook لضمان الاتصال الآمن بين Botpress و Linear. للحصول على سر التوقيع webhook ، اتبع الإرشادات الواردة في قسم _التكوين اليدوي باستخدام مفتاح API_ أدناه. ## التكوين ### التكوين التلقائي باستخدام OAuth (موصى به) هذه هي أبسط طريقة لإعداد التكامل. لإعداد تكامل Linear باستخدام OAuth، انقر فوق زر التفويض واتبع التعليمات لتوصيل Botpress chatbot ب Linear. يوصى بهذه الطريقة لأنها تبسط عملية التكوين وتضمن اتصالاً آمنًا بين chatbot و Linear. عند استخدام وضع التهيئة هذا، سيتم استخدام تطبيق Linear المُدار من قبل Botpress للاتصال بمساحة العمل Linear الخاصة بك. سيكون للتطبيق الأذونات اللازمة لإدارة المشكلات والتعليقات وتنفيذ العمليات نيابة عن المستخدمين لديك. إذا كنت تحتاج إلى مزيد من التحكم الدقيق في الأذونات، يمكنك اختيار وضع التكوين اليدوي بدلاً من ذلك. ### التكوين اليدوي باستخدام مفتاح واجهة برمجة التطبيقات إذا كنت تفضل تكوين التكامل يدويًا، يمكنك توفير مفتاح API لربط حسابك الشخصي Linear بحسابك الشخصي Botpress. ضع في اعتبارك أنه عند استخدام مفتاح API، ستُنسب الإجراءات التي يتخذها الروبوت إلى حسابك الشخصي Linear . إذا كنت ترغب في أن تُنسب الإجراءات إلى مؤسستك بدلاً من حسابك الشخصي، فيجب عليك استخدام مصادقة OAuth. توفر مصادقة OAuth الكثير من المزايا مقارنةً بمفاتيح واجهة برمجة التطبيقات ولا تستهلك مقعدًا داخل مؤسستك Linear . لإعداد التكامل Linear باستخدام مفتاح API شخصي، اتبع الخطوات التالية: ### إنشاء مفتاح واجهة برمجة التطبيقات Linear 1. على Linear ، انتقل إلى إعدادات حسابك وحدد علامة التبويب API في الشريط الجانبي للتنقل. 2. ضمن _مفاتيح واجهة برمجة التطبيقات الشخصية_، أدخل اسمًا لمفتاح واجهة برمجة التطبيقات الخاص بك وانقر على زر _إنشاء مفتاح واجهة برمجة تطبيقات جديد_. 3. احفظ مفتاح واجهة برمجة التطبيقات هذا في مكان آمن. ستحتاج إليه لتكوين التكامل Linear في Botpress. ### الاشتراك في Linear webhook الأحداث 1. في Botpress ، انتقل إلى صفحة تكوين التكامل لـ Linear. 2. انسخ عنوان URL webhook الذي تم إنشاؤه بواسطة Botpress. 3. في Linear ، انتقل إلى إعدادات حسابك وحدد علامة تبويب واجهة برمجة التطبيقات في الشريط الجانبي للتنقل. 4. ضمن _Webhooks_، انقر فوق الزر _إنشاء webhook جديد _. 5. أدخل اسمًا لـ webhook والصق عنوان URL webhook الذي تم إنشاؤه بواسطة Botpress في الحقل _URL_. 6. انسخ سر التوقيع webhook في مكان آمن. ستحتاج إليه لتكوين التكامل Linear في Botpress. 7. ضمن _أحداث تغيير البيانات_، حدد الأحداث التي ترغب في الاشتراك فيها: - 'الإصدارات': تلقي الإشعارات عند إنشاء المشكلات أو تحديثها أو حذفها. - 'التعليقات': تلقي إعلامات عند إضافة تعليقات إلى المشكلات. 8. ضمن _الفرق_، حدد الفرق التي ترغب في تلقي تنبيهات لها. 9. انقر فوق الزر _إنشاء webhook_ لحفظ التغييرات التي أجريتها. ### تكوين التكامل Linear في Botpress 1. في Botpress ، انتقل إلى صفحة تكوين التكامل لـ Linear. 2. حدد الخيار _تكوين Linear باستخدام مفتاح API_. 3. أدخل مفتاح واجهة برمجة التطبيقات الذي حصلت عليه من Linear في الحقل _API Key_. 4. أدخل سرّ التوقيع webhook الذي حصلت عليه من Linear في الحقل _سرّ توقيع خطاف الويب_. 5. احفظ التكوين وقم بتمكين التكامل. 6. انسخ عنوان URL webhook الذي تم إنشاؤه بواسطة Botpress. ## القيود تنطبق قيود واجهة برمجة التطبيقات Linear القياسية على تكامل Linear في Botpress. تتضمن هذه القيود حدود المعدل وقيود حجم الحمولة والقيود الأخرى التي تفرضها منصة Linear . تأكد من التزام الروبوت الخاص بك بهذه القيود للحفاظ على الأداء الأمثل والموثوقية. يتوفر المزيد من التفاصيل في [Linear وثائق واجهة برمجة التطبيقات] (https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).
