---
title: "n8n"
description: "Quire-munkafolyamatok automatizálása az n8n-nel és a Quire közösségi csomóponttal."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Az n8n Quire közösségi csomópontja egy REST API-műveleti és egy trigger-csomópontot kínál. A trigger akkor indít munkafolyamatot, amikor valami történik a Quire-ben. Nincs futásidejű függősége, így önmagán kívül semmit nem ad hozzá az n8n-példányhoz.

## Telepítés <!--quire:install-->

Az n8n-ben nyissa meg a **Settings**, majd a **Community nodes** részt, válassza az **Install** lehetőséget, és írja be: `@quire/n8n-node`. Saját üzemeltetésű n8n esetén az n8n felhasználói mappájában a `npm install @quire/n8n-node` paranccsal is telepítheti, majd indítsa újra.

## Csatlakozás <!--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>

Hozzon létre hitelesítő adatot. Két típus érhető el:

- **Quire API Key**: a **Base URL** a szervezet címe, záró perjel nélkül, például `https://acme.quirelms.com`. Az **API Key** a rendszergazda által itt létrehozott kulcs: `/admin/integrations/api-keys`; `qk_live_` előtaggal kezdődik. Csak a munkafolyamathoz szükséges hatóköröket adja meg.
- **Quire OAuth2**: olyan munkafolyamatokhoz, amelyek egy adott személy nevében járnak el. Regisztráljon OAuth-klienst itt: `/admin/integrations/oauth-clients`, az n8n átirányítási címével (az n8n feltünteti a hitelesítő adatnál), majd adja meg a kliensazonosítót, a titkot és a hatóköröket.

## Műveletek <!--quire:actions-->

A **Quire** csomópont felhasználókat, kurzusokat, beiratkozásokat, csoportokat, teljesítéseket, jegyeket, tanúsítványokat, beadásokat, kvízpróbálkozásokat, programokat, rendeléseket, e-mailt és szervezeteket kezel. Ahol az API lehetővé teszi, mindegyiknél van listázás, lekérés, létrehozás, módosítás és törlés, valamint külső azonosító szerinti upsert. Szinkronizáláshoz ez a kívánt mód: ugyanazt a munkafolyamatot kétszer futtatva nem keletkezik ismétlődés.

A műveletek a Quire OpenAPI-dokumentumból készülnek, ezért mezőről mezőre megfelelnek az [API-referenciának](https://docs.quirelms.com/api/). Mindegyik művelet eszközként is használható egy n8n MI-ügynökben; leírása az API-referenciából származik.

Alapértelmezés szerint a listák minden oldalt visszaadnak. Nagy szervezeteknél kapcsolja ki a **Return All** beállítást, és adjon meg korlátot.

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

Adja hozzá a **Quire Trigger** csomópontot, válassza ki a hitelesítő adatot, majd jelölje ki az **Events** eseményeket: név szerinti esemény, például `enrolment.created`, teljes terület, például `course.*`, vagy minden esemény. A munkafolyamat aktiválásakor a csomópont webhook-feliratkozást hoz létre a Quire-ben az n8n címére; deaktiváláskor eltávolítja azt.

Minden kézbesítés aláírását ellenőrzi a munkafolyamat futása előtt. Az ellenőrzésen elbukó kézbesítés csomóponti hibával elvész, így hamis kéréssel nem indítható munkafolyamat. Az esemény `data` mezője azonosítókat tartalmaz; adjon hozzá utána egy Quire-csomópontot a teljes rekord lekéréséhez.

## Példa: üdvözlő e-mail beiratkozáskor <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** a `enrolment.created` eseményhez.
2. **Quire** csomópont, erőforrás: **Users**, művelet: **Get**, felhasználóazonosító: `{{$json.data.user_id}}`.
3. **Quire** csomópont, erőforrás: **Courses**, művelet: **Get**, kurzusazonosító: `{{$json.data.course_id}}`.
4. E-mail- vagy csevegőcsomópont, a személy nevével és a kurzus címével.

## Hibaelhárítás <!--quire:troubleshooting-->

- **401** minden hívásnál: a Base URL és a kulcs különböző szervezetekhez tartozik, vagy visszavonták a kulcsot.
- **403** egy műveletnél: a kulcsnak nincs meg az adott hatóköre. Adja hozzá itt: `/admin/integrations/api-keys`.
- Nem indul el a trigger: a Quire-nek HTTPS-en el kell érnie az n8n webhookcímét. Ellenőrizze a feliratkozás kézbesítési naplóját a `/admin/webhooks` oldalon.

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