---
title: "n8n"
description: "Automatizirajte Quire pomoću n8n-a i Quireova čvora zajednice."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Quireov čvor zajednice za n8n nudi akcijski čvor za REST API i okidački čvor koji
pokreće tijek rada kada se nešto dogodi u Quireu. Nema ovisnosti tijekom rada pa
vašoj instanci n8n-a dodaje samo sebe.

## Instalacija <!--quire:install-->

U n8n-u otvorite **Settings**, zatim **Community nodes**, odaberite **Install** i
upišite `@quire/n8n-node`. Na instanci n8n-a koju sami hostate možete umjesto toga
pokrenuti `npm install @quire/n8n-node` u korisničkoj mapi n8n-a i ponovno ga pokrenuti.

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

Izradite vjerodajnicu. Dostupne su dvije vrste:

- **Quire API Key**: **Base URL** jest adresa vaše organizacije bez završne kose crte,
  npr. `https://acme.quirelms.com`. **API Key** je ključ koji je administrator izradio
  na `/admin/integrations/api-keys` i počinje s `qk_live_`. Dodijelite mu samo opsege
  koje tijek rada treba.
- **Quire OAuth2**: za tijekove rada koji trebaju djelovati u ime određene osobe.
  Registrirajte OAuth klijenta na `/admin/integrations/oauth-clients` s adresom za
  preusmjeravanje n8n-a (n8n je prikazuje u vjerodajnici), a zatim unesite ID klijenta,
  tajnu i opsege.

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

Čvor **Quire** obuhvaća korisnike, tečajeve, upise, grupe, dovršenosti, ocjene,
potvrde, predaje, pokušaje kvizova, programe, narudžbe, e-poštu i organizacije. Za
svaki nudi popis, dohvat, stvaranje, ažuriranje i brisanje kada to API podržava te
umetanje ili ažuriranje prema vanjskom ID-ju — prikladno za sinkronizaciju jer se
ponovnim pokretanjem istog tijeka rada ne stvaraju duplikati.

Operacije se generiraju iz Quireova dokumenta OpenAPI pa se podudaraju sa svim poljima
u [referenci API-ja](https://docs.quirelms.com/api/). Svaka se operacija može upotrijebiti i kao alat agenta
AI-ja u n8n-u; njezin opis preuzet je iz reference API-ja.

Popisi prema zadanim postavkama vraćaju sve stranice. Na velikim organizacijama isključite
**Return All** i postavite ograničenje.

## Okidač <!--quire:trigger-->

Dodajte čvor **Quire Trigger**, odaberite vjerodajnicu i **Events**: događaj po nazivu,
primjerice `enrolment.created`, cijelo područje poput `course.*` ili sve događaje.
Kada aktivirate tijek rada, čvor izrađuje pretplatu na webhook u Quireu za n8n-ovu
adresu; kada ga deaktivirate, pretplata se uklanja.

Potpis svake isporuke provjerava se prije pokretanja tijeka rada. Neprovjerena se
isporuka odbacuje uz pogrešku čvora, pa krivotvoren zahtjev ne može pokrenuti tijek.
`data` događaja sadrži identifikatore; nakon okidača dodajte Quireov čvor da biste
dohvatili cijeli zapis.

## Primjer: poruka dobrodošlice nakon upisa <!--quire:example-welcome-email-on-enrolment-->

1. Čvor **Quire Trigger** za `enrolment.created`.
2. Čvor **Quire**, resurs **Users**, operacija **Get**, s ID-jem korisnika
   `{{$json.data.user_id}}`.
3. Čvor **Quire**, resurs **Courses**, operacija **Get**, s ID-jem tečaja
   `{{$json.data.course_id}}`.
4. Vaš čvor za e-poštu ili razgovor koji upotrebljava ime osobe i naziv tečaja.

## Otklanjanje poteškoća <!--quire:troubleshooting-->

- **401** pri svakom pozivu: osnovna adresa i ključ pripadaju različitim organizacijama
  ili je ključ opozvan.
- **403** za jednu operaciju: ključ nema taj opseg. Dodajte ga na
  `/admin/integrations/api-keys`.
- Okidač se ne pokreće: Quire mora moći pristupiti n8n-ovoj webhook adresi preko HTTPS-a.
  Provjerite zapisnik isporuka pretplate na `/admin/webhooks`.

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