n8n

Quire kopienas mezgls n8n dod darbības mezglu REST API un notikuma mezglu, kas sāk darbplūsmu, kad Quire kaut kas notiek. Tam nav izpildlaika atkarību, tāpēc tā instalācijai tas nepievieno neko citu kā sevi pašu.

Uzstādīšana

n8n atveriet Iestatījumus, pēc tam Kopienas mezglus, izvēlieties Uzstādīt un ierakstiet @quire/n8n-node. Pašmitinātā n8n vietā varat palaist npm install @quire/n8n-node mapē n8n lietotāja un restartēt.

Savienošana

Izveidojiet akreditācijas datus. Tiek piedāvāti divi veidi:

• Quire API atslēga: Base URL ir tavas organizācijas adrese bez slīpsvītras beigās, piemēram, https://acme.quirelms.com. API atslēga ir atslēga, ko administrators izveidojis vietnē /admin/integrations/api-keys, sākot ar qk_live_. Dodiet tai tikai tās pilnvaras, ko darbplūsmai vajag.
• Quire OAuth2: darbplūsmām, kurām jārīkojas konkrētas personas vārdā. Reģistrējiet OAuth klientu vietnē /admin/integrations/oauth-clients ar n8n adresi (n8n to parāda pie akreditācijas datiem), pēc tam ierakstiet klienta ID, noslēpumu un pilnvaras.

Darbības

Mezgls Quire aptver lietotājus, kursus, ierakstīšanos, grupas, pabeigšanu, atzīmes, sertifikātus, iesniegumus, viktorīnu mēģinājumus, programmas, pasūtījumus, e-pastu un organizācijas. Katrs piedāvā sarakstu, iegūšanu, izveidi, atjaunošanu un dzēšanu tur, kur to dara API, kā arī atjaunošanu vai izveidi pēc ārējā ID, kas ir tas, ko vajag sinhronizācijai: palaist to pašu darbplūsmu divreiz, un nekas netiek dublēts.

Operācijas ir ģenerētas no Quire OpenAPI dokumenta, tāpēc tās atbilst API atsaucei lauks pa laukam. Katru operāciju var izmantot arī kā rīku n8n mākslīgā intelekta aģents; tās apraksts nāk no API atsauces.

Saraksti pēc noklusējuma atgriež katru lapu. Lielām organizācijām izslēdziet Atgriezt visu un iestatiet ierobežojumu.

Notikums

Pievienojiet mezglu Quire Trigger, izvēlieties akreditācijas datus un izvēlieties Notikumus: notikumu pēc nosaukuma, piemēram, enrolment.created, visu zonu, piemēram, course.*, vai visu. Kad darbplūsmu ieslēdzat, mezgls Quire izveido tīmekļa āķa abonementu ar n8n adresi; kad to izslēdzat, abonements tiek noņemts.

Katra piegādes paraksts tiek pārbaudīts pirms darbplūsmas palaišanas. Piegāde, kas nepārbaudās, tiek noraidīta ar mezgla kļūdu, tāpēc viltots pieprasījums nevar palaist tavu darbplūsmu. Notikuma data nes identifikatorus; pēc notikuma mezgla pievienojiet Quire mezglu, lai iegūtu pilnu ierakstu.

Piemērs: sveiciena e-pasts par ierakstīšanos

1. Quire Trigger par enrolment.created.
2. Mezgls Quire, resurss Lietotāji, darbība Iegūt ar lietotāja ID {{$json.data.user_id}}.
3. Mezgls Quire, resurss Kursi, darbība Iegūt ar {{$json.data.course_id}}.
4. Tavs e-pasta vai čata mezgls, izmantojot personas vārdu un kursa nosaukumu.

Problēmu novēršana

• 401 katram izsaukumam: Base URL un atslēga pieder dažādām organizācijām vai atslēga tika atsaukta.
• 403 vienai operācijai: atslēgai trūkst šīs pilnvaras. Pievienojiet to vietnē /admin/integrations/api-keys.
• Notikums nekad netiek palaists: n8n tīmekļa āķa adresei jābūt sasniedzamai no Quire caur HTTPS. Pārbaudiet abonementa piegādes žurnālu vietnē /admin/webhooks.