n8n

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

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

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

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

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

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

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