---
title: "n8n"
description: "Automatizuokite Quire su n8n ir „Quire“ bendruomenės mazgu."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

„Quire“ bendruomenės mazgas n8n suteikia veiksmo mazgą REST API ir
įvykio mazgą, kuris pradeda darbo srautą, kai Quire įvyksta tam tikras
dalykas. Jis neturi priklausomybių vykdymo metu, todėl į jūsų n8n instanciją
neprideda nieko, išskyrus patį save.

## Įdiegimas <!--quire:install-->

Atidarykite n8n **Nustatymus**, tada **Bendruomenės mazgus**, pasirinkite
**Įdiegti** ir įveskite `@quire/n8n-node`. Savo prieglobos turimame n8n
vietoj to galite paleisti `npm install @quire/n8n-node` n8n naudotojo
aplankale ir iš naujo paleisti programą.

## Prijungimas <!--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>

Sukurkite prisijungimo duomenis. Siūlomi du tipai:

- **Quire API raktas**: **Base URL** yra jūsų organizacijos adresas be
  galinio brūkšnio, pavyzdžiui `https://acme.quirelms.com`. **API raktas** yra
  raktas, kurį administratorius sukūrė adresu
  `/admin/integrations/api-keys` ir kuris prasideda `qk_live_`. Duokite jam
  tik tas apimtis, kurių reikia darbo srautui.
- **Quire OAuth2**: darbo srautams, kurie turėtų veikti konkretaus žmogaus
  vardu. Registruokite OAuth klientą adresu
  `/admin/integrations/oauth-clients` su n8n atsakomuoju adresu (n8n jį
  parodo prisijungimo duomenų lauke), tada įveskite kliento ID, paslaptį ir
  apimtis.

## Veiksmai <!--quire:actions-->

Mazgas **Quire** apima vartotojus, kursus, įtraukimus, grupes, užbaigimus,
įvertinimus, pažymėjimus, pateiktus darbus, klausimynų bandymus, programas,
užsakymus, el. paštą ir organizacijas. Kiekvienas siūlo sąrašo, gavimo,
sukūrimo, atnaujinimo ir ištrynimo veiksmus ten, kur tai daro API, ir įrašą
arba atnaujinimą pagal išorinį ID – būtent to ir norite sinchronizacijai:
paleiskite tą patį darbo srautą du kartus ir nieko nepasidvigubins.

Veiksmai sugeneruoti iš Quire „OpenAPI“ dokumento, todėl jie atitinka
[API dokumentaciją](https://docs.quirelms.com/api/) laukas į lauką. Kiekvieną veiksmą taip pat
gali naudoti kaip įrankį n8n DI agentas; jo aprašymas atkeliauja iš API
dokumentacijos.

Sąrašai pagal nutylėjimą grąžina visus puslapius. Didelėms organizacijoms
išjunkite **Gražinti viską** ir nustatykite limitą.

## Įvykis <!--quire:trigger-->

Pridėkite mazgą **Quire Trigger**, pasirinkite prisijungimo duomenis ir
pasirinkite **Įvykius**: įvykį pagal pavadinimą, pavyzdžiui
`enrolment.created`, visą sritį, pavyzdžiui `course.*`, arba viską. Kai
aktyvuojate darbo srautą, mazgas Quire sukuria webhook prenumeratą n8n
adresui; kai jį išjungiate, prenumerata pašalinama.

Kiekvieno pristatymo parašas patikrinamas prieš paleidžiant darbo srautą.
Pristatymas, kurio nepavyksta patikrinti, atmetamas su mazgo klaida, todėl
suklastota užklausa negali paleisti jūsų darbo srauto. Įvykio `data` neša
identifikatorius; po įvykio pridėkite Quire mazgą, kad pasiimtumėte visą
įrašą.

## Pavyzdys: sveikinimo el. laiškas įtraukus <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** su `enrolment.created`.
2. **Quire** mazgas, išteklius **Users**, veiksmas **Get**, su vartotojo ID
   `{{$json.data.user_id}}`.
3. **Quire** mazgas, išteklius **Courses**, veiksmas **Get**, su
   `{{$json.data.course_id}}`.
4. Jūsų el. pašto arba pokalbio mazgas, naudojantis žmogaus vardą ir kurso
   pavadinimą.

## Trikčių šalinimas <!--quire:troubleshooting-->

- **401** kiekvienoje užklausoje: Base URL ir raktas priklauso skirtingoms
  organizacijoms arba raktas buvo atšauktas.
- **403** viename veiksme: rakto trūksta tos apimties. Pridėkite ją adresu
  `/admin/integrations/api-keys`.
- Įvykis neįvyksta: n8n webhook adresas turi būti pasiekiamas iš
  Quire per HTTPS. Patikrinkite prenumeratos pristatymo žurnalą adresu
  `/admin/webhooks`.

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