n8n

توفر عقدة مجتمع Quire لـn8n عقدة إجراء لواجهة REST API وعقدة مُشغّل تبدأ مسار عمل عند وقوع حدث في Quire. ولا تتطلب اعتماديات تشغيلية، لذا لا تضيف إلى نسخة n8n لديك سوى العقدة نفسها.

التثبيت

في n8n، افتح الإعدادات ثم عقد المجتمع واختر تثبيت وأدخل @quire/n8n-node. ويمكنك بدلًا من ذلك، عند استضافة n8n بنفسك، تشغيل npm install @quire/n8n-node في مجلد مستخدم n8n ثم إعادة تشغيله.

الاتصال

أنشئ بيانات اعتماد. يتوفر نوعان:

• مفتاح Quire API: اجعل عنوان URL الأساسي عنوان مؤسستك دون شرطة مائلة أخيرة، مثل https://acme.quirelms.com. أما مفتاح API فهو مفتاح أنشأه مسؤول في /admin/integrations/api-keys ويبدأ بـqk_live_. امنحه النطاقات التي يحتاجها مسار العمل وحدها.
• Quire OAuth2: لمسارات العمل التي ينبغي أن تتصرف بصفتها شخصًا بعينه. سجّل عميل OAuth في /admin/integrations/oauth-clients بعنوان إعادة التوجيه الخاص بـn8n (يعرضه n8n ضمن بيانات الاعتماد)، ثم أدخل معرف العميل والسر والنطاقات.

الإجراءات

تدعم عقدة Quire المستخدمين والمقررات والتسجيلات والمجموعات والإكمال والدرجات والشهادات والتسليمات ومحاولات الاختبارات والبرامج والطلبات والبريد الإلكتروني والمؤسسات. وتوفر لكل مورد عمليات القائمة والاسترجاع والإنشاء والتحديث والحذف بحسب ما تدعمه API، والتحديث أو الإنشاء حسب المعرف الخارجي؛ وهذا ما تحتاجه للمزامنة كي لا ينتج عن تشغيل مسار العمل نفسه مرتين سجلات مكررة.

تُنشأ العمليات من مستند OpenAPI الخاص بـQuire، لذا تطابق حقول مرجع API حقلًا بحقل. ويمكن أيضًا استخدام كل عملية أداةً لوكيل ذكاء اصطناعي في n8n؛ إذ يأتي وصفها من مرجع API.

تعيد القوائم كل الصفحات افتراضيًا. أوقف إرجاع الكل وحدد حدًا للمؤسسات الكبيرة.

المُشغّل

أضف عقدة Quire Trigger واختر بيانات الاعتماد ثم الأحداث: حدثًا باسمه مثل enrolment.created، أو مجالًا بأكمله مثل course.*، أو الكل. عند تفعيل مسار العمل، تنشئ العقدة اشتراك خطاف ويب في Quire لعنوان n8n؛ وعند إلغاء تفعيله، يُزال الاشتراك.

يُتحقق من توقيع كل عملية تسليم قبل تشغيل مسار العمل. وتُهمل عملية التسليم التي لم يجتز توقيعها التحقق مع ظهور خطأ في العقدة، فلا يستطيع طلب مزور بدء مسار العمل. تحمل الخاصية data في الحدث المعرّفات؛ أضف عقدة Quire بعد المُشغّل لجلب السجل الكامل.

مثال: رسالة ترحيب عند التسجيل

1. عقدة Quire Trigger للحدث enrolment.created.
2. عقدة Quire، المورد Users، العملية Get، مع معرف المستخدم {{$json.data.user_id}}.
3. عقدة Quire، المورد Courses، العملية Get، مع معرف المقرر {{$json.data.course_id}}.
4. عقدة البريد الإلكتروني أو المحادثة لديك، مع استخدام اسم الشخص وعنوان المقرر.

استكشاف المشكلات

• ظهور 401 في كل طلب: ينتمي عنوان URL الأساسي والمفتاح إلى مؤسستين مختلفتين، أو أُلغي المفتاح.
• ظهور 403 لعملية واحدة: لا يتضمن المفتاح نطاق الإذن المطلوب. أضفه في /admin/integrations/api-keys.
• عدم تشغيل المُشغّل: يجب أن يكون عنوان خطاف الويب في n8n متاحًا لـQuire عبر HTTPS. تحقق من سجل التسليم للاشتراك في /admin/webhooks.