n8n

הצומת הקהילתי של Quire ל-n8n מספק צומת פעולה עבור REST API וצומת הפעלה שמתחיל תהליך עבודה כשמשהו קורה ב-Quire. אין לו תלויות בזמן ריצה, ולכן הוא מוסיף למופע n8n שלכם רק את עצמו.

התקנה

ב-n8n פתחו Settings, ואז Community nodes, בחרו Install והזינו @quire/n8n-node. במקום זאת, במופע n8n באירוח עצמי אפשר להריץ npm install @quire/n8n-node בתיקיית המשתמש של n8n ואז להפעיל מחדש.

חיבור

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

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

פעולות

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

הפעולות נוצרות ממסמך OpenAPI של Quire, ולכן הן תואמות לשדות שבמדריך ה-API. אפשר גם להשתמש בכל פעולה ככלי של סוכן AI ב-n8n; התיאור שלה מגיע ממדריך ה-API.

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

הפעלה

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