---
title: "n8n"
description: "بە n8n و گرێی کۆمەڵگەی Quire کارەکانی Quire خۆکار بکە."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

گرێی کۆمەڵگەی Quire بۆ n8n گرێی کردار بۆ REST API و گرێی هاندەر دابین دەکات کە کاتێک شتێک لە Quire ڕوودەدات ڕەوتی کار دەست پێ دەکات. پێویستییەکی کاتی کارکردنی نییە، بۆیە هیچ شتێک زیاد ناکات بۆ n8nەکەت جگە لە خۆی.

## دامەزراندن <!--quire:install-->

لە n8nدا **ڕێکخستنەکان** بکەرەوە، پاشان **گرێکانی کۆمەڵگە**، **دامەزراندن** هەڵبژێرە و `@quire/n8n-node` بنووسە. لە n8nی خۆبەڕێوەبەردا دەتوانیت `npm install @quire/n8n-node` لە بوخچەی بەکارهێنەری n8n جێبەجێ بکەیت و دووبارە دەستی پێ بکەیتەوە.

## پەیوەستکردن <!--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>

زانیاریی نهێنییەک دروست بکە. دوو جۆر هەن:

- **کلیلی APIی Quire**: **ناونیشانی بنەڕەت** ناونیشانی دامەزراوەکەتە بەبێ لارەی کۆتایی، وەک `https://acme.quirelms.com`. **کلیلی API** ئەو کلیلەیە کە بەڕێوەبەر لە `/admin/integrations/api-keys` دروستی کردووە و بە `qk_live_` دەست پێ دەکات. تەنها ئەو سنوورانەی ڕەوتی کار پێویستی پێیانە بدە.
- **Quire OAuth2**: بۆ ئەو ڕەوتەکارییانەی دەبێت وەک کەسێکی دیاریکراو کار بکەن. کڕیارێکی OAuth لە `/admin/integrations/oauth-clients` بە ناونیشانی گەڕانەوەی n8n تۆمار بکە (n8n لە زانیاریی نهێنیدا پیشانی دەدات)، پاشان ناسێنەری کڕیار، نهێنی و سنوورەکان بنووسە.

## کردارەکان <!--quire:actions-->

گرێی **Quire** بەکارهێنەر، کۆرس، تۆمارکردن، گرووپ، تەواوکردن، نمرەدان، بڕوانامە، پێشکەشکردن، هەوڵی تاقیکردنەوە، بەرنامە، داواکاری، ئیمەیڵ و دامەزراوەکان دەگرێتەوە. بۆ هەر یەک لیستکردن، وەرگرتن، دروستکردن، نوێکردنەوە و سڕینەوە بەردەستە ئەگەر API پشتیوانی بکات؛ هەروەها نوێکردنەوە بە ناسێنەری دەرەکی، کە بۆ هاوکاتکردن بەکاردێت: هەمان ڕەوتی کار دوو جار جێبەجێ بکە و هیچ شتێک دووبارە دروست نابێت.

کردارەکان لە بەڵگەنامەی OpenAPIی Quireوە دروست دەکرێن، بۆیە ورد بە [سەرچاوەی API](https://docs.quirelms.com/api/) دەگونجێن. هەر کردارێک وەک ئامرازێکیش دەتوانرێت لەلایەن ئەجێنتی AIی n8n بەکاربهێنرێت؛ وەسفەکەی لە سەرچاوەی APIوە دێت.

بەپێی بنەڕەت لیستەکان هەموو لاپەڕەکان دەگەڕێننەوە. بۆ دامەزراوە گەورەکان **گەڕاندنەوەی هەموو** ناچالاک بکە و سنوورێک دابنێ.

## هاندەر <!--quire:trigger-->

گرێی **Quire Trigger** زیاد بکە، زانیاریی نهێنی هەڵبژێرە و **ڕووداوەکان** دیاری بکە: ڕووداوێک بە ناو وەک `enrolment.created`، ناوچەیەکی تەواو وەک `course.*` یان هەموو شتێک. کاتێک ڕەوتی کار چالاک دەکەیت، گرێکە subscriptionێکی webhook بۆ ناونیشانی n8n لە Quire دروست دەکات؛ کاتێک ناچالاکی دەکەیت subscriptionەکە لادەبات.

واژۆی هەر گەیاندنێک پێش جێبەجێبوونی ڕەوتی کار دەپشکنرێت. گەیاندنێک کە پشتڕاست نابێتەوە بە هەڵەی گرێکە فڕێ دەدرێت، بۆیە داواکاریی ساختە ناتوانێت ڕەوتی کار دەست پێ بکات. `data`ی ڕووداو ناسێنەرەکان هەڵدەگرێت؛ دوای هاندەرەکە گرێیەکی Quire زیاد بکە بۆ وەرگرتنی تۆماری تەواو.

## نموونە: ئیمەیڵی بەخێرهێنان لە کاتی تۆماربوون <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** لەسەر `enrolment.created`.
2. گرێی **Quire**، سەرچاوە **بەکارهێنەر**، کردار **وەرگرتن**، بە ناسێنەری بەکارهێنەر `{{$json.data.user_id}}`.
3. گرێی **Quire**، سەرچاوە **کۆرسەکان**، کردار **وەرگرتن**، بە `{{$json.data.course_id}}`.
4. گرێی ئیمەیڵ یان گفتوگۆی خۆت بە ناوی کەسەکە و ناونیشانی کۆرسەکە.

## چارەسەرکردنی کێشە <!--quire:troubleshooting-->

- **401** بۆ هەموو بانگکردنێک: ناونیشانی بنەڕەت و کلیلەکە هی دوو دامەزراوەی جیاوازن، یان کلیلەکە هەڵوەشێنراوەتەوە.
- **403** لە کردارێکدا: کلیلەکە ئەو سنوورەی نییە. لە `/admin/integrations/api-keys` زیاد بکە.
- هاندەر هەرگیز کار ناکات: ناونیشانی webhookی n8n دەبێت لە ڕێگەی HTTPSەوە لە Quire بگاتەوە. تۆماری گەیاندنی subscription لە `/admin/webhooks` بپشکنە.

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