---
title: "n8n"
description: "n8n އަދި ޤުއަރޭ community node އާއެކު ޤުއަރޭ އޮޓޮމޭޓްކުރާށެވެ."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/dv/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

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

## އިންސްޓޮލް <!--quire:install-->

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

## ގުޅުވުން <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

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

- **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:actions-->

**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](https://docs.quirelms.com/api/) ގެ ފީލްޑުތަކާ އެއްގޮތް ވެއެވެ. ކޮންމެ އޮޕަރޭޝަނެއް n8n AI agent އަކުން tool ގެ ގޮތުގައިވެސް ބޭނުންކުރެވޭނެއެވެ؛ އޭގެ ވަޞްފު API reference އިން ނަގައެވެ.

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

## Trigger <!--quire: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 އެއް އިތުރުކުރާށެވެ.

## މިސާލު: އެންރޯލްމަންޓްގައި ވެލްކަމް އީމެއިލް <!--quire:example-welcome-email-on-enrolment-->

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.

## ދަތި ކަންކަން ޙައްލުކުރުން <!--quire:troubleshooting-->

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

Source: https://docs.quirelms.com/dv/integrations/n8n/index.mdx
