n8n

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

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

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

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. 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

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

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

• 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.