n8n

Quire community čvor za n8n nudi akcijski čvor za REST API i okidački čvor koji pokreće tok rada kada se nešto dogodi u Quireu. Nema zavisnosti tokom rada, pa u vašu n8n instancu dodaje samo sebe.

Instaliranje

U n8n-u otvorite Settings, zatim Community nodes, odaberite Install i unesite @quire/n8n-node. Ako sami hostujete n8n, možete pokrenuti i npm install @quire/n8n-node u korisničkoj fascikli n8n-a, pa ga ponovo pokrenuti.

Povezivanje

Kreirajte pristupni podatak. Nude se dvije vrste:

• Quire API Key: Base URL je adresa vaše organizacije bez završne kose crte, npr. https://acme.quirelms.com. API Key je ključ koji je administrator kreirao na /admin/integrations/api-keys, a počinje sa qk_live_. Dodijelite mu samo opsege potrebne za tok rada.
• Quire OAuth2: za tokove rada koji treba da djeluju u ime određene osobe. Registrujte OAuth klijenta na /admin/integrations/oauth-clients s n8n adresom za preusmjeravanje (n8n je prikazuje u pristupnom podatku), pa unesite ID klijenta, tajnu i opsege.

Radnje

Čvor Quire podržava korisnike, kurseve, upise, grupe, završetke, ocjene, certifikate, predane radove, pokušaje kvizova, programe, narudžbe, e-poštu i organizacije. Svaki resurs nudi listanje, dohvatanje, kreiranje, ažuriranje i brisanje kada to API podržava, kao i upis ili ažuriranje prema vanjskom ID-u. To je pogodno za sinhronizaciju: pokretanje istog toka rada dva puta neće napraviti duplikate.

Operacije se generišu iz Quire OpenAPI dokumenta, pa se polje po polje podudaraju s API priručnikom. Svaka operacija može se koristiti i kao alat AI agenta u n8n-u; njen opis dolazi iz API priručnika.

Liste podrazumijevano vraćaju svaku stranicu. Za velike organizacije isključite Return All i postavite limit.

Okidač

Dodajte čvor Quire Trigger, odaberite pristupni podatak i navedite Events: pojedinačni događaj poput enrolment.created, cijelo područje poput course.* ili sve događaje. Kada aktivirate tok rada, čvor kreira Quire webhook pretplatu na n8n adresu; pri deaktivaciji je uklanja.

Potpis svake isporuke provjerava se prije pokretanja toka rada. Isporuka koja ne prođe provjeru odbacuje se uz grešku čvora, tako da krivotvoreni zahtjev ne može pokrenuti tok rada. data događaja sadrži identifikatore; dodajte Quire čvor iza okidača da dohvati cijeli zapis.

Primjer: poruka dobrodošlice nakon upisa

1. Quire Trigger za enrolment.created.
2. Čvor Quire, resurs Users, operacija Get, uz ID korisnika {{$json.data.user_id}}.
3. Čvor Quire, resurs Courses, operacija Get, uz {{$json.data.course_id}}.
4. Vaš čvor za e-poštu ili razgovor, s imenom osobe i nazivom kursa.

Rješavanje problema

• 401 pri svakom pozivu: osnovna URL adresa i ključ pripadaju različitim organizacijama ili je ključ opozvan.
• 403 za jednu operaciju: ključ nema potreban opseg. Dodajte ga na /admin/integrations/api-keys.
• Okidač se ne aktivira: Quire mora moći pristupiti n8n webhook adresi putem HTTPS-a. Provjerite evidenciju isporuka pretplate na /admin/webhooks.