---
title: "n8n"
description: "أتمت Quire باستخدام n8n وعقدة مجتمع Quire."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ar/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

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

## التثبيت <!--quire:install-->

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

## الاتصال <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

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

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

## الإجراءات <!--quire:actions-->

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

تُنشأ العمليات من مستند OpenAPI الخاص بـQuire، لذا تطابق حقول [مرجع API](https://docs.quirelms.com/api/) حقلًا بحقل. ويمكن أيضًا استخدام كل عملية أداةً لوكيل ذكاء اصطناعي في n8n؛ إذ يأتي وصفها من مرجع API.

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

## المُشغّل <!--quire:trigger-->

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

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

## مثال: رسالة ترحيب عند التسجيل <!--quire:example-welcome-email-on-enrolment-->

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

## استكشاف المشكلات <!--quire:troubleshooting-->

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

Source: https://docs.quirelms.com/ar/integrations/n8n/index.mdx