n8n

ޤުއަރޭ community node ފޮނުވަނީ REST API އަށް އެކްޝަން node އެއް، އަދި ޤުއަރޭގައި ކަމެއް ހިނގުމުން workflow ފަށާ trigger node އެއް އެވެ. އޭގައި runtime dependency ނެތެވެ؛ އެ node ނޫން ތަކެއް n8n instance އަށް އިތުރު ނުކުރެއެވެ.

އިންސްޓޮލް

n8n ގައި Settings ހުޅުވައި Community nodes، ދެން Install ހޮވައި @quire/n8n-node ލިޔާށެވެ. ސެލްފް-ހޯސްޓް n8n ގައި ނުވަތަ npm install @quire/n8n-node ނ8n user folder ގައި ހިންގައި restart ކުރެވޭނެއެވެ.

ގުޅުވުން

ކްރެޑެންޝަލެއް ހަދާށެވެ. ދެ ބާވަތެއް ލިބެއެވެ:

• Quire API Key: Base URL އަކީ ތިބާގެ އޮގަނައިޒޭޝަން އެޑްރެސް، ފަހުގައި slash ނެތި، https://acme.quirelms.com ފަދަ. API Key އަކީ އެޑްމިނިސްޓްރޭޓަރު /admin/integrations/api-keys ގައި ހަދި، qk_live_ އިން ފެށޭ ކީއެކެވެ. workflow އަށް ބޭނުންވާ scope އެކަނި ދޭށެވެ.
• Quire OAuth2: ވަކި މީހަކުގެ ފަރުވާގައި ހިންގޭ workflow ތަކަށް. n8n ގެ redirect address އާއެކު /admin/integrations/oauth-clients ގައި OAuth client ރަޖިސްޓަރކޮށް (n8n އެއީ credential ގައި ދައްކާ)، ދެން client ID، secret އަދި scope ތައް ލާށެވެ.

އެކްޝަންތައް

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 ވެސް ކުރެވޭނެއެވެ، sync އަށް އެއީ މުހިންމެވެ: އެއް workflow ދެފަހަރު ހިންގިޔަސް އެކްލިކޭޓް ނުވާނެއެވެ.

އޮޕަރޭޝަންތައް ޤުއަރޭގެ OpenAPI document އިން ޖެނެރޭޓް ކުރެވެއެވެ، އެހެންވެ އޭތައް API reference ގެ ފީލްޑުތަކާ އެއްގޮތް ވެއެވެ. ކޮންމެ އޮޕަރޭޝަނެއް n8n AI agent އަކުން tool ގެ ގޮތުގައިވެސް ބޭނުންކުރެވޭނެއެވެ؛ އޭގެ ވަޞްފު API reference އިން ނަގައެވެ.

ލިސްޓެއް ޑިފޯލްޓުން ކޮންމެ ޕޭޖެއް ރިޓަރންކުރެއެވެ. ބޮޑު އޮގަނައިޒޭޝަނަކަށް Return All އޮފްކޮށް ލިމިޓެއް ދޭށެވެ.

Trigger

Quire Trigger node އިތުރުކޮށް credential ހޮވައި، Events ހޮވާށެވެ: enrolment.created ފަދަ ނަމުން އިވެންޓެއް، course.* ފަދަ ހުރިހާ އޭރިއާއެއް، ނުވަތަ ހުރިހާތަކެއް. Workflow activate ކުރުމުން node އިން n8n ގެ އެޑްރެހަށް ޤުއަރޭގައި webhook subscription ހަދައެވެ؛ deactivate ކުރުމުން subscription ފޮހެއެވެ.

Workflow ހިންގުމުގެ ކުރިން ކޮންމެ delivery ގެ signature ޗެކްކުރެއެވެ. ޗެކް ނުފާސްވާ delivery އެ node error އާއެކު ފޮހެވެއެވެ؛ ފޯޖް ކުރި request އެއް workflow ނުފަށާނެއެވެ. Event ގެ data ގައި identifiers ހުރެއެވެ؛ ފުރިހަމަ record ހޯދަން 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.

ދަތި ކަންކަން ޙައްލުކުރުން

• ކޮންމެ call އަކަށް 401: Base URL އަދި key ތަކަކީ ތަފާތު އޮގަނައިޒޭޝަންގެ، ނުވަތަ key ރިވޯކްކުރިފައި.
• އެއް އޮޕަރޭޝަނަކަށް 403: key އަށް scope ނެތެވެ. /admin/integrations/api-keys ގައި އިތުރުކުރާށެވެ.
• Trigger ހިންގާނެއް ނޫން: n8n webhook އެޑްރެސް ޤުއަރޭއިން HTTPS އިން އެކްސެސް ކުރެވޭންޖެހެއެވެ. /admin/webhooks ގައި subscription delivery log ޗެކްކުރާށެވެ.