---
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/he/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 פתחו **Settings**, ואז **Community nodes**, בחרו **Install** והזינו
`@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>

צרו פרטי גישה. מוצעים שני סוגים:

- **מפתח API של Quire**: **כתובת בסיס** היא כתובת הארגון בלי לוכסן בסוף, למשל
  `https://acme.quirelms.com`. **מפתח API** הוא מפתח שמנהל מערכת יצר ב-`/admin/integrations/api-keys`,
  ומתחיל ב-`qk_live_`. העניקו לו רק את ההיקפים שתהליך העבודה צריך.
- **Quire OAuth2**: לתהליכי עבודה שצריכים לפעול בשם אדם מסוים. רשמו לקוח OAuth
  ב-`/admin/integrations/oauth-clients` עם כתובת ההפניה של n8n (n8n מציג אותה
  בפרטי הגישה), ואז הזינו מזהה לקוח, סוד והיקפים.

## פעולות <!--quire:actions-->

צומת **Quire** מכסה משתמשים, קורסים, הרשמות, קבוצות, השלמות, ציונים, תעודות,
הגשות, ניסיונות בחן, תוכניות, הזמנות, דוא״ל וארגונים. בכל משאב מוצעות פעולות
רשימה, אחזור, יצירה, עדכון ומחיקה במקום שבו ה-API תומך בהן, וגם upsert לפי מזהה
חיצוני, המתאים לסנכרון: הפעלה חוזרת של אותו תהליך עבודה אינה יוצרת כפילויות.

הפעולות נוצרות ממסמך OpenAPI של Quire, ולכן הן תואמות לשדות שב[מדריך ה-API](https://docs.quirelms.com/api/).
אפשר גם להשתמש בכל פעולה ככלי של סוכן AI ב-n8n; התיאור שלה מגיע ממדריך ה-API.

רשימות מחזירות כברירת מחדל כל עמוד. בארגונים גדולים, כבו **Return All** והגדירו
מגבלה.

## הפעלה <!--quire:trigger-->

הוסיפו צומת **Quire Trigger**, בחרו פרטי גישה ואז בחרו **Events**: אירוע בשם כגון
`enrolment.created`, אזור שלם כגון `course.*` או הכול. בעת הפעלת תהליך העבודה, הצומת
יוצר ב-Quire מינוי webhook לכתובת של 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** בכל קריאה: כתובת הבסיס והמפתח שייכים לארגונים שונים, או שהמפתח בוטל.
- **403** בפעולה אחת: למפתח חסר ההיקף הזה. הוסיפו אותו ב-`/admin/integrations/api-keys`.
- ההפעלה אינה מתרחשת: כתובת ה-webhook של n8n חייבת להיות נגישה ל-Quire דרך HTTPS.
  בדקו את יומן המסירות של המינוי ב-`/admin/webhooks`.

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