n8n

In-node komunitarja ta’ Quire għal n8n tagħtik node ta’ azzjoni għar-REST API u node ta’ trigger li jibda workflow meta jiġri xi ħaġa f’Quire. M’għandha l-ebda dipendenza ta’ runtime, għalhekk ma żżid xejn mal-istanza n8n tiegħek ħlief liilha nnifisha.

Installa

F’n8n, iftaħ Settings, imbagħad Community nodes, agħżel Install, u daħħal @quire/n8n-node. Fuq n8n self-hosted tista’ minflok tħaddem npm install @quire/n8n-node fil-folder tal-utent ta’ n8n u terġa’ tibda.

Qabbad

Oħloq kredenzjali. Żewġ tipi huma offruti:

• Ċavetta API ta’ Quire: Base URL huwa l-indirizz tal-organizzazzjoni tiegħek mingħajr slash tat-tmiem, bħal https://acme.quirelms.com. API Key hija ċavetta li amministratur ħoloq f’/admin/integrations/api-keys, li tibda qk_live_. Agħtiha biss l-iskops li l-workflow jeħtieġ.
• Quire OAuth2: għal workflows li għandhom jaġixxu bħala persuna partikolari. Irreġistra klijent OAuth f’/admin/integrations/oauth-clients bl-indirizz ta’ redirect ta’ n8n (n8n jurih fuq il-kredenzjali), imbagħad daħħal il-klijent ID, is-sigriet u l-iskops.

Azzjonijiet

In-node Quire ikopri utenti, korsijiet, reġistrazzjonijiet, gruppi, tlestijiet, gradi, ċertifikati, sottomissjonijiet, tentattivi ta’ kwizz, programmi, ordnijiet, email u organizzazzjonijiet. Kull waħda toffri elenka, ġib, oħloq, aġġorna u ħassar fejn l-API tagħmel, u upsert b’ID estern, li huwa dak li trid għal sync: ħaddem l- istess workflow darbtejn u xejn ma jiġi dduplikat.

L-operazzjonijiet huma ġġenerati mid-dokument OpenAPI ta’ Quire, għalhekk jaqblu mar-referenza tal-API qasam b’qasam. Kull operazzjoni tista’ tintuża wkoll bħala għodda minn aġent AI ta’ n8n; id-deskrizzjoni tagħha tiġi mir-referenza tal-API.

Il-listi jirritornaw kull paġna default. Itfi Return All u ssettja limitu għal organizzazzjonijiet kbar.

Trigger

Żid in-node Quire Trigger, agħżel il-kredenzjali, u agħżel l- Avvenimenti: avveniment bl-isem bħal enrolment.created, żona sħiħa bħal course.*, jew kollox. Meta tattiva l-workflow, in-node joħloq abbonament webhook f’Quire għall-indirizz ta’ n8n; meta tiddiżattivah, l-abbonament jitneħħa.

Il-firma ta’ kull kunsinna tiġi ċċekkjata qabel ma jaħdem il-workflow. Kunsinna li ma tivverifikax tintrema b’żball tan-node, biex talba ffalsifikata ma tistax tibda l-workflow tiegħek. Id-data tal-avveniment iġorr identifikaturi; żid node ta’ Quire wara t-trigger biex iġġib ir-rekord sħiħ.

Eżempju: email ta’ merħba mar-reġistrazzjoni

1. Quire Trigger fuq enrolment.created.
2. Node Quire, riżorsa Utenti, operazzjoni Ġib, bl-ID tal-utent {{$json.data.user_id}}.
3. Node Quire, riżorsa Korsijiet, operazzjoni Ġib, bi {{$json.data.course_id}}.
4. In-node tal-email jew chat tiegħek, bl-isem tal-persuna u t-titlu tal-kors.

Solvi problemi

• 401 fuq kull sejħa: il-Base URL u ċ-ċavetta huma ta’ organizzazzjonijiet differenti, jew iċ-ċavetta ġiet revokata.
• 403 fuq operazzjoni waħda: iċ-ċavetta m’għandhiex dak l-iskop. Żidu f’ /admin/integrations/api-keys.
• It-trigger qatt ma jaħdem: l-indirizz webhook ta’ n8n irid ikun milħuq minn Quire fuq HTTPS. Iċċekkja l-log tal-kunsinna tal-abbonament f’ /admin/webhooks.