---
title: "n8n"
description: "Quire və Quire icma qovşağı ilə işləri avtomatlaşdırın."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

n8n üçün Quire icma qovşağı REST API üçün əməliyyat qovşağı və Quire-də hadisə baş verəndə iş axınını başladan trigger qovşağı təqdim edir. Onun işləmə asılılıqları yoxdur, yəni n8n instansiyanıza özündən başqa heç nə əlavə etmir.

## Quraşdırma <!--quire:install-->

n8n-də **Settings**, sonra **Community nodes** bölməsini açın, **Install** seçin və `@quire/n8n-node` daxil edin. Öz serverinizdəki n8n-də alternativ olaraq n8n istifadəçi qovluğunda `npm install @quire/n8n-node` işlədib yenidən başladın.

## Qoşulma <!--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>

Etimadnamə yaradın. İki növ təklif olunur:

- **Quire API Key**: **Base URL** sonundakı slash olmadan təşkilatınızın ünvanıdır, məsələn, `https://acme.quirelms.com`. **API Key** administratorun `/admin/integrations/api-keys` ünvanında yaratdığı və `qk_live_` ilə başlayan açardır. Yalnız iş axınının ehtiyac duyduğu scope-ları verin.
- **Quire OAuth2**: konkret şəxs kimi işləməli olan iş axınları üçündür. n8n-in yönləndirmə ünvanı ilə (n8n onu etimadnamədə göstərir) `/admin/integrations/oauth-clients` ünvanında OAuth client qeydiyyatdan keçirin, sonra client ID, secret və scope-ları daxil edin.

## Əməliyyatlar <!--quire:actions-->

**Quire** qovşağı istifadəçilər, kurslar, qeydiyyatlar, qruplar, tamamlamalar, qiymətlər, sertifikatlar, təhvil verilən işlər, test cəhdləri, proqramlar, sifarişlər, e-poçt və təşkilatları əhatə edir. API-də olduqda hər biri siyahı, əldə etmə, yaratma, yeniləmə və silmə əməliyyatlarını, eləcə də xarici ID-yə görə upsert-i təklif edir. Sinxronizasiya üçün upsert-dən istifadə edin: eyni iş axınını iki dəfə işlətmək heç nəyi təkrarlamır.

Əməliyyatlar Quire-in OpenAPI sənədindən yaradılır, buna görə [API arayışındakı](https://docs.quirelms.com/api/) sahələrlə tam uyğun gəlir. Hər əməliyyat n8n süni intellekt agenti üçün alət kimi də istifadə edilə bilər; onun təsviri API arayışından götürülür.

Siyahılar standart olaraq bütün səhifələri qaytarır. Böyük təşkilatlarda **Return All** parametrini söndürün və limit təyin edin.

## Trigger <!--quire:trigger-->

**Quire Trigger** qovşağı əlavə edin, etimadnaməni seçin və **Events** bölməsindən hadisə adı (`enrolment.created`), bütöv sahə (`course.*`) və ya hamısını seçin. İş axınını aktivləşdirdikdə qovşaq Quire-də n8n ünvanına vebhuk abunəliyi yaradır; deaktiv etdikdə abunəlik silinir.

İş axını başlamazdan əvvəl hər çatdırılmanın imzası yoxlanılır. Təsdiqlənməyən çatdırılma qovşaq xətası ilə atılır, buna görə saxta sorğu iş axınınızı başlada bilməz. Hadisənin `data` hissəsində identifikatorlar olur; tam qeydi əldə etmək üçün trigger-dən sonra Quire qovşağı əlavə edin.

## Nümunə: qeydiyyatda qarşılama e-poçtu <!--quire:example-welcome-email-on-enrolment-->

1. `enrolment.created` hadisəsində **Quire Trigger**.
2. İstifadəçi ID-si `{{$json.data.user_id}}` ilə **Quire** qovşağı, resurs **Users**, əməliyyat **Get**.
3. `{{$json.data.course_id}}` ilə **Quire** qovşağı, resurs **Courses**, əməliyyat **Get**.
4. Şəxsin adını və kursun başlığını işlədən e-poçt və ya çat qovşağı.

## Problemlərin aradan qaldırılması <!--quire:troubleshooting-->

- Hər çağırışda **401**: Base URL və açar müxtəlif təşkilatlara aiddir və ya açar ləğv edilib.
- Bir əməliyyatda **403**: açarda həmin scope yoxdur. `/admin/integrations/api-keys` ünvanında əlavə edin.
- Trigger işləmir: n8n vebhuk ünvanına Quire tərəfindən HTTPS üzərindən çatmaq mümkün olmalıdır. `/admin/webhooks` ünvanında abunəliyin çatdırılma jurnalını yoxlayın.

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