n8n

„Quire“ bendruomenės mazgas n8n suteikia veiksmo mazgą REST API ir įvykio mazgą, kuris pradeda darbo srautą, kai Quire įvyksta tam tikras dalykas. Jis neturi priklausomybių vykdymo metu, todėl į jūsų n8n instanciją neprideda nieko, išskyrus patį save.

Įdiegimas

Atidarykite n8n Nustatymus, tada Bendruomenės mazgus, pasirinkite Įdiegti ir įveskite @quire/n8n-node. Savo prieglobos turimame n8n vietoj to galite paleisti npm install @quire/n8n-node n8n naudotojo aplankale ir iš naujo paleisti programą.

Prijungimas

Sukurkite prisijungimo duomenis. Siūlomi du tipai:

• Quire API raktas: Base URL yra jūsų organizacijos adresas be galinio brūkšnio, pavyzdžiui https://acme.quirelms.com. API raktas yra raktas, kurį administratorius sukūrė adresu /admin/integrations/api-keys ir kuris prasideda qk_live_. Duokite jam tik tas apimtis, kurių reikia darbo srautui.
• Quire OAuth2: darbo srautams, kurie turėtų veikti konkretaus žmogaus vardu. Registruokite OAuth klientą adresu /admin/integrations/oauth-clients su n8n atsakomuoju adresu (n8n jį parodo prisijungimo duomenų lauke), tada įveskite kliento ID, paslaptį ir apimtis.

Veiksmai

Mazgas Quire apima vartotojus, kursus, įtraukimus, grupes, užbaigimus, įvertinimus, pažymėjimus, pateiktus darbus, klausimynų bandymus, programas, užsakymus, el. paštą ir organizacijas. Kiekvienas siūlo sąrašo, gavimo, sukūrimo, atnaujinimo ir ištrynimo veiksmus ten, kur tai daro API, ir įrašą arba atnaujinimą pagal išorinį ID – būtent to ir norite sinchronizacijai: paleiskite tą patį darbo srautą du kartus ir nieko nepasidvigubins.

Veiksmai sugeneruoti iš Quire „OpenAPI“ dokumento, todėl jie atitinka API dokumentaciją laukas į lauką. Kiekvieną veiksmą taip pat gali naudoti kaip įrankį n8n DI agentas; jo aprašymas atkeliauja iš API dokumentacijos.

Sąrašai pagal nutylėjimą grąžina visus puslapius. Didelėms organizacijoms išjunkite Gražinti viską ir nustatykite limitą.

Įvykis

Pridėkite mazgą Quire Trigger, pasirinkite prisijungimo duomenis ir pasirinkite Įvykius: įvykį pagal pavadinimą, pavyzdžiui enrolment.created, visą sritį, pavyzdžiui course.*, arba viską. Kai aktyvuojate darbo srautą, mazgas Quire sukuria webhook prenumeratą n8n adresui; kai jį išjungiate, prenumerata pašalinama.

Kiekvieno pristatymo parašas patikrinamas prieš paleidžiant darbo srautą. Pristatymas, kurio nepavyksta patikrinti, atmetamas su mazgo klaida, todėl suklastota užklausa negali paleisti jūsų darbo srauto. Įvykio data neša identifikatorius; po įvykio pridėkite Quire mazgą, kad pasiimtumėte visą įrašą.

Pavyzdys: sveikinimo el. laiškas įtraukus

1. Quire Trigger su enrolment.created.
2. Quire mazgas, išteklius Users, veiksmas Get, su vartotojo ID {{$json.data.user_id}}.
3. Quire mazgas, išteklius Courses, veiksmas Get, su {{$json.data.course_id}}.
4. Jūsų el. pašto arba pokalbio mazgas, naudojantis žmogaus vardą ir kurso pavadinimą.

Trikčių šalinimas

• 401 kiekvienoje užklausoje: Base URL ir raktas priklauso skirtingoms organizacijoms arba raktas buvo atšauktas.
• 403 viename veiksme: rakto trūksta tos apimties. Pridėkite ją adresu /admin/integrations/api-keys.
• Įvykis neįvyksta: n8n webhook adresas turi būti pasiekiamas iš Quire per HTTPS. Patikrinkite prenumeratos pristatymo žurnalą adresu /admin/webhooks.