Quire
n8n-ৰ Quire community node-এ REST API-ৰ বাবে action node আৰু Quire-ত কিবা ঘটিলে workflow আৰম্ভ কৰা trigger node দিয়ে। ইয়াৰ runtime dependency নাই, সেয়ে নিজকে বাদ দি আপোনাৰ n8n instance-ত একো যোগ নকৰে।
ইনষ্টল কৰক
n8n-ত Settings, তাৰ পিছত Community nodes খুলি Install বাছি @quire/n8n-node দিয়ক। Self-hosted n8n-ত n8n user folder-ত npm install @quire/n8n-node চলাই restart কৰিব পাৰে।
সংযোগ কৰক
Credential সৃষ্টি কৰক। দুটা ধৰণ দিয়া হৈছে:
- Quire API Key: Base URL হৈছে আপোনাৰ প্ৰতিষ্ঠানৰ ঠিকনা, শেষত slash নোহোৱাকৈ, যেনে
https://acme.quirelms.com। API Key হৈছে/admin/integrations/api-keysত প্ৰশাসকে সৃষ্টি কৰা আৰুqk_live_ৰে আৰম্ভ হোৱা key। Workflow-ৰ প্ৰয়োজনীয় scope-হে দিয়ক। - Quire OAuth2: নিৰ্দিষ্ট ব্যক্তিৰ হৈ কাম কৰিবলগীয়া workflow-ৰ বাবে। n8n-ৰ redirect address (credential-ত n8n-এ দেখুৱায়) লৈ
/admin/integrations/oauth-clientsত OAuth client register কৰি client ID, secret আৰু scope দিয়ক।
Action
Quire node-এ user, course, enrolment, group, completion, grade, certificate, submission, quiz attempt, program, order, email আৰু organisation সামৰে। API-ত থকা ক্ষেত্ৰত প্ৰতিটোৱে list, get, create, update আৰু delete দিয়ে; লগতে external ID অনুসৰি upsert-ও, sync-ৰ বাবে এইটোৱেই উপযোগী: একে workflow দুবাৰ চলালেও duplicate নহয়।
Operation-সমূহ Quire-ৰ OpenAPI document-ৰ পৰা তৈয়াৰ হয়, সেয়ে API তথ্যসূত্ৰ-ৰ প্ৰতিটো field-ৰ সৈতে মিলে। প্ৰতিটো operation n8n AI agent-ৰ tool হিচাপেও ব্যৱহাৰ কৰিব পাৰি; ইয়াৰ বৰ্ণনা API তথ্যসূত্ৰৰ পৰা আহে।
ডিফল্টভাৱে list-এ প্ৰতিটো page ঘূৰাই দিয়ে। ডাঙৰ প্ৰতিষ্ঠানৰ বাবে Return All off কৰি limit দিয়ক।
Trigger
Quire Trigger node যোগ কৰি credential আৰু Events বাছক: enrolment.createdৰ দৰে নামৰ event, course.*ৰ দৰে সম্পূৰ্ণ এলেকা অথবা সকলো। Workflow activate কৰিলে node-এ n8n-ৰ address-ৰ বাবে Quire-ত webhook subscription সৃষ্টি কৰে; deactivate কৰিলে subscription আঁতৰায়।
Workflow চলাৰ আগতে প্ৰতিটো delivery-ৰ signature পৰীক্ষা হয়। Verify নোহোৱা delivery node error-সহ বাদ পৰে, সেয়ে জাল request-এ workflow আৰম্ভ কৰিব নোৱাৰে। Event-ৰ dataত identifier থাকে; সম্পূৰ্ণ record আনিবলৈ trigger-ৰ পিছত Quire node যোগ কৰক।
উদাহৰণ: enrolment হ’লে welcome email
enrolment.createdৰ Quire Trigger।- User ID
{{$json.data.user_id}}সহ Quire node, resource Users, operation Get। {{$json.data.course_id}}সহ Quire node, resource Courses, operation Get।- ব্যক্তিজনৰ নাম আৰু পাঠ্যক্ৰমৰ title ব্যৱহাৰ কৰি আপোনাৰ email বা chat node।
সমস্যা সমাধান
- 401 প্ৰতিটো call-ত: Base URL আৰু key বেলেগ প্ৰতিষ্ঠানৰ, অথবা key revoke কৰা হৈছে।
- 403 এটা operation-ত: key-ত সেই scope নাই।
/admin/integrations/api-keysত যোগ কৰক। - Trigger কেতিয়াও নচলে: Quire-ৰ পৰা HTTPS-ৰে n8n webhook address পোৱা যাব লাগিব।
/admin/webhooksত subscription-ৰ delivery log চাওক।