---
title: "n8n"
description: "Аўтаматызуйце Quire праз n8n і вузел Quire ад супольнасці."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/be/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 адкрыйце **Settings**, затым **Community nodes**, выберыце **Install** і ўвядзіце `@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>

Стварыце ўліковыя даныя. Даступны два віды:

- **Quire API Key**: у полі **Base URL** увядзіце адрас арганізацыі без касой рысы ў канцы, напрыклад `https://acme.quirelms.com`. **API Key** — гэта ключ, створаны адміністратарам у `/admin/integrations/api-keys`; ён пачынаецца з `qk_live_`. Дайце яму толькі тыя вобласці доступу, якія патрэбны працоўнаму працэсу.
- **Quire OAuth2**: для працоўных працэсаў, якія павінны дзейнічаць ад імя канкрэтнага чалавека. Зарэгіструйце кліент OAuth у `/admin/integrations/oauth-clients`, указаўшы адрас перанакіравання n8n (ён паказаны ў даных уліковага запісу), затым увядзіце ID кліента, сакрэт і вобласці доступу.

## Дзеянні <!--quire:actions-->

Вузел **Quire** працуе з карыстальнікамі, курсамі, залічэннямі, групамі, завяршэннямі, ацэнкамі, сертыфікатамі, здадзенымі работамі, спробамі тэстаў, праграмамі, заказамі, электроннай поштай і арганізацыямі. Для кожнага рэсурсу ён прапануе спіс, атрыманне, стварэнне, абнаўленне і выдаленне, калі гэта падтрымлівае API, а таксама upsert паводле знешняга ID. Гэта падыходзіць для сінхранізацыі: паўторны запуск таго ж працоўнага працэсу не стварае дублікатаў.

Аперацыі генеруюцца з дакумента OpenAPI Quire, таму яны дакладна адпавядаюць [даведцы API](https://docs.quirelms.com/api/). Кожную аперацыю можна таксама выкарыстоўваць як інструмент ШІ-агента n8n; апісанне бярэцца з даведкі API.

Па змаўчанні спісы вяртаюць усе старонкі. Для вялікіх арганізацый выключыце **Return All** і задайце ліміт.

## Трыгер <!--quire:trigger-->

Дадайце вузел **Quire Trigger**, выберыце ўліковыя даныя і **Events**: асобную падзею, напрыклад `enrolment.created`, цэлы раздзел кшталту `course.*` або ўсе падзеі. Пры актывацыі працоўнага працэсу вузел стварае ў Quire падпіску на вэбхук з адрасам n8n; пры дэактывацыі падпіска выдаляецца.

Перад запускам працоўнага працэсу правяраецца подпіс кожнай дастаўкі. Неправераная дастаўка адхіляецца з памылкай вузла, таму падроблены запыт не можа запусціць ваш працоўны працэс. Поле `data` падзеі змяшчае ідэнтыфікатары; дадайце пасля трыгера вузел Quire, каб атрымаць поўны запіс.

## Прыклад: прывітальны ліст пасля залічэння <!--quire:example-welcome-email-on-enrolment-->

1. Трыгер **Quire Trigger** на `enrolment.created`.
2. Вузел **Quire**, рэсурс **Users**, аперацыя **Get**, ID карыстальніка `{{$json.data.user_id}}`.
3. Вузел **Quire**, рэсурс **Courses**, аперацыя **Get**, ID курса `{{$json.data.course_id}}`.
4. Ваш вузел электроннай пошты або чата з імем чалавека і назвай курса.

## Дыягностыка праблем <!--quire:troubleshooting-->

- **401** пры кожным выкліку: базавы URL і ключ належаць розным арганізацыям або ключ быў адкліканы.
- **403** для адной аперацыі: ключ не мае патрэбнай вобласці доступу. Дадайце яе ў `/admin/integrations/api-keys`.
- Трыгер не запускаецца: адрас вэбхукаў n8n павінен быць даступны з Quire праз HTTPS. Праверце журнал даставак падпіскі ў `/admin/webhooks`.

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