n8n

n8n के लिए Quire कम्युनिटी node REST API के लिए action node और Quire में कुछ होने पर वर्कफ़्लो शुरू करने वाला trigger node देता है। इसकी रनटाइम निर्भरताएँ नहीं हैं, इसलिए यह आपके n8n इंस्टेंस में अपने अलावा कुछ नहीं जोड़ता।

इंस्टॉल करें

n8n में Settings, फिर Community nodes खोलें, Install चुनें और @quire/n8n-node दर्ज करें। अपने सर्वर वाले n8n में इसके बजाय n8n user फ़ोल्डर में npm install @quire/n8n-node चलाकर रीस्टार्ट कर सकते हैं।

कनेक्ट करें

क्रेडेंशियल बनाएँ। दो प्रकार दिए जाते हैं:

• Quire API Key: Base URL आपके संगठन का पता है, जिसके अंत में slash न हो, जैसे https://acme.quirelms.com। API Key प्रशासक द्वारा /admin/integrations/api-keys पर बनाया गया key है, जो qk_live_ से शुरू होता है। वर्कफ़्लो को जितने scope चाहिए उतने ही दें।
• Quire OAuth2: उन वर्कफ़्लो के लिए जो किसी ख़ास व्यक्ति के रूप में काम करते हैं। n8n के redirect पते के साथ (n8n उसे क्रेडेंशियल पर दिखाता है) /admin/integrations/oauth-clients पर OAuth client रजिस्टर करें, फिर client ID, secret और scopes दर्ज करें।

कार्रवाइयाँ

Quire node में users, courses, enrolments, groups, completions, grades, certificates, submissions, quiz attempts, programs, orders, email और organisations शामिल हैं। जहाँ API अनुमति देता है वहाँ हर एक में list, get, create, update और delete हैं, साथ ही external ID से upsert भी—सिंक के लिए यही सही है: एक ही वर्कफ़्लो दो बार चलाने पर कुछ दोहराया नहीं जाता।

ये ऑपरेशन Quire के OpenAPI दस्तावेज़ से तैयार होते हैं, इसलिए API संदर्भ के हर फ़ील्ड से मेल खाते हैं। हर ऑपरेशन n8n AI agent के tool के रूप में भी इस्तेमाल हो सकता है; उसका विवरण API संदर्भ से आता है।

डिफ़ॉल्ट रूप से सूचियाँ हर पृष्ठ लौटाती हैं। बड़े संगठन के लिए Return All बंद करें और सीमा तय करें।

ट्रिगर

Quire Trigger node जोड़ें, क्रेडेंशियल चुनें और Events चुनें: नाम से कोई इवेंट जैसे enrolment.created, पूरा क्षेत्र जैसे course.*, या सब कुछ। वर्कफ़्लो चालू करने पर node n8n के पते के लिए Quire में webhook subscription बनाता है; बंद करने पर subscription मिटा दी जाती है।

वर्कफ़्लो चलने से पहले हर डिलीवरी का हस्ताक्षर जाँचा जाता है। जिसकी जाँच सफल न हो, उसे node त्रुटि सहित छोड़ देता है, ताकि जाली अनुरोध वर्कफ़्लो शुरू न कर सके। इवेंट का data पहचानकर्ता रखता है; पूरा रिकॉर्ड पाने के लिए trigger के बाद Quire node जोड़ें।

उदाहरण: नामांकन पर स्वागत ईमेल

1. enrolment.created पर Quire Trigger।
2. Quire node, resource Users, operation Get, user ID {{$json.data.user_id}} के साथ।
3. Quire node, resource Courses, operation Get, {{$json.data.course_id}} के साथ।
4. आपका email या chat node, जिसमें व्यक्ति का नाम और पाठ्यक्रम का शीर्षक हो।

समस्या निवारण

• हर कॉल पर 401: Base URL और key अलग-अलग संगठनों के हैं, या key रद्द कर दी गई।
• एक ऑपरेशन पर 403: key के पास वह scope नहीं है। उसे /admin/integrations/api-keys पर जोड़ें।
• trigger कभी नहीं चलता: Quire को HTTPS के ज़रिए n8n webhook पता पहुँचने योग्य होना चाहिए। /admin/webhooks पर subscription की delivery log देखें।