n8n

የQuire የማህበረሰብ node ለn8n ለREST API የaction nodeና በQuire ነገር ሲከሰት workflow የሚጀምር trigger node ይሰጣል። በሩጫ ጊዜ ጥገኛ ነገሮች የሉትም፤ ስለዚህ ከራሱ በስተቀር በn8n መጫኛዎ ላይ ምንም አይጨምርም።

ጫን

በn8n Settings ይክፈቱ፣ ከዚያ Community nodes፣ Install ይምረጡና @quire/n8n-node ያስገቡ። በራስዎ በሚያስተናግዱት n8n ላይ በn8n የተጠቃሚ አቃፊ ውስጥ npm install @quire/n8n-node ማስኬድና እንደገና ማስጀመር ይችላሉ።

አገናኝ

ማረጋገጫ ይፍጠሩ። ሁለት ዓይነቶች አሉ፦

• Quire API Key፦ Base URL የድርጅትዎ አድራሻ ነው፣ መጨረሻ ላይ slash ሳይኖር፤ ለምሳሌ https://acme.quirelms.com። API Key አስተዳዳሪ በ /admin/integrations/api-keys የፈጠረው ቁልፍ ነው፤ በ qk_live_ ይጀምራል። ለworkflow የሚያስፈልጉትን ፈቃዶች ብቻ ይስጡት።
• Quire OAuth2፦ workflowዎች እንደ አንድ ሰው መሥራት ሲገባቸው። በ /admin/integrations/oauth-clients የn8n የማዞሪያ አድራሻ ያለው OAuth ደንበኛ ይመዝግቡ (n8n በማረጋገጫው ላይ ያሳየዋል)፣ ከዚያም የደንበኛ መለያውን፣ ምስጢሩንና ፈቃዶቹን ያስገቡ።

ተግባሮች

የQuire node ተጠቃሚዎችን፣ ኮርሶችን፣ ምዝገባዎችን፣ ቡድኖችን፣ ማጠናቀቆችን፣ ውጤቶችን፣ ሰርቲፊኬቶችን፣ ማቅረቢያዎችን፣ የፈተና ሙከራዎችን፣ ፕሮግራሞችን፣ ትዕዛዞችን፣ ኢሜይልንና ድርጅቶችን ይደግፋል። APIው በሚፈቅድበት ቦታ እያንዳንዱ ዝርዝር ማውጣት፣ ማግኘት፣ መፍጠር፣ ማዘመንና መሰረዝ ያቀርባል፤ በውጫዊ መለያም upsert ይችላል። ለማመሳሰል ይህን ይጠቀሙ፦ ተመሳሳይ workflow ሁለት ጊዜ ቢሠራ ምንም አይደገምም።

ተግባሮቹ ከQuire OpenAPI ሰነድ ይፈጠራሉ፤ ስለዚህ ከየAPI ማጣቀሻው ጋር በዝርዝር ይዛመዳሉ። እያንዳንዱ ተግባር በn8n AI agent እንደ መሣሪያ ሊጠቀም ይችላል፤ መግለጫው ከAPI ማጣቀሻው ይመጣል።

ዝርዝሮች በነባሪነት ገጽ ሁሉን ይመልሳሉ። ለትልቅ ድርጅቶች Return Allን ያጥፉና ገደብ ያዘጋጁ።

Trigger

የQuire Trigger nodeን ያክሉ፣ ማረጋገጫውን ይምረጡና Eventsን ይወስኑ፦ እንደ enrolment.created ያለ ክስተት፣ እንደ course.* ያለ ሙሉ አካባቢ ወይም ሁሉም። workflowውን ሲያነቁ nodeው በQuire ውስጥ ለn8n አድራሻ webhook ምዝገባ ይፈጥራል፤ ሲያጠፉት ምዝገባው ይሰረዛል።

እያንዳንዱ መላኪያ ከworkflowው ከመሥራቱ በፊት ፊርማውን ያረጋግጣል። ማረጋገጫውን ያልፈተሸ መላኪያ በnode ስህተት ይጣላል፤ የተጭበረበረ ጥያቄ workflowዎን ማስጀመር አይችልም። የክስተቱ data መለያዎችን ይይዛል፤ ሙሉ መዝገቡን ለማውጣት ከtriggerው በኋላ Quire node ያክሉ።

ምሳሌ፦ ሲመዘገብ የእንኳን ደህና መጡ ኢሜይል

1. በ enrolment.created ላይ Quire Trigger።
2. Quire node፣ resource Users፣ operation Get፣ ከተጠቃሚ መለያው ጋር {{$json.data.user_id}}።
3. Quire node፣ resource Courses፣ operation Get፣ ከኮርስ መለያው ጋር {{$json.data.course_id}}።
4. የሰውየውን ስምና የኮርሱን ርዕስ የሚጠቀም የኢሜይል ወይም የውይይት nodeዎ።

መላ ፍለጋ

• በሁሉም ጥሪዎች 401፦ Base URLና ቁልፉ የተለያዩ ድርጅቶች ናቸው ወይም ቁልፉ ተሰርዟል።
• በአንድ ተግባር 403፦ ቁልፉ ያ ፈቃድ የለውም። በ /admin/integrations/api-keys ያክሉ።
• Triggerው ፈጽሞ አይሠራም፦ የn8n webhook አድራሻ ከQuire በHTTPS መድረስ አለበት። በ /admin/webhooks የምዝገባውን የመላኪያ ምዝግብ ይመልከቱ።