n8n

Quire-ren n8n komunitate-nodoak REST APIrako ekintza-nodoa eta Quire-n zerbait gertatzean lan-fluxua abiarazten duen abiarazle-nodoa eskaintzen ditu. Ez du exekuzio-mendekotasunik; beraz, nodoa bera baino ez dio gehitzen zure n8n instantziari.

Instalatu

n8n-en, ireki Settings, gero Community nodes, aukeratu Install eta idatzi @quire/n8n-node. Autoostatatutako n8n batean, bestela, exekutatu npm install @quire/n8n-node n8n erabiltzailearen karpetan eta berrabiarazi.

Konektatu

Sortu kredentzial bat. Bi mota eskaintzen dira:

• Quire API Key: Base URL zure erakundearen helbidea da, amaierako barrarik gabe; adibidez, https://acme.quirelms.com. API Key administratzaile batek /admin/integrations/api-keys helbidean sortutako gakoa da; qk_live_ aurrizkiarekin hasten da. Eman lan-fluxuak behar dituen irismenak soilik.
• Quire OAuth2: pertsona jakin baten moduan jardun behar duten lan-fluxuetarako. Erregistratu OAuth bezero bat /admin/integrations/oauth-clients helbidean, n8n-en birbideratze-helbidearekin (n8n-ek kredentzialan erakusten du), eta idatzi bezeroaren IDa, sekretua eta irismenak.

Ekintzak

Quire nodoak erabiltzaileak, ikastaroak, matrikulak, taldeak, amaitzeak, kalifikazioak, ziurtagiriak, bidalketak, galdetegi-saiakerak, programak, eskaerak, posta elektronikoa eta erakundeak hartzen ditu. Bakoitzean zerrendatu, eskuratu, sortu, eguneratu eta ezabatzeko aukera dago, APIak hala egiten uzten badu; kanpoko IDaren bidez sortu edo eguneratzea ere badago. Hori da sinkronizaziorako egokiena: lan-fluxu bera bitan exekutatuta ere ez da ezer bikoizten.

Eragiketak Quire-ren OpenAPI dokumentutik sortzen dira, beraz APIaren erreferentziarekin eremu guztietan bat datoz. Eragiketa guztiak n8n IA-agente baten tresna gisa ere erabil daitezke; haien deskribapena APIaren erreferentziatik dator.

Lehenespenez, zerrendek orrialde guztiak itzultzen dituzte. Erakunde handietan, desaktibatu Return All eta ezarri muga bat.

Abiarazlea

Gehitu Quire Trigger nodoa, aukeratu kredentziala eta hautatu Events: izenaren araberako gertaera bat, adibidez enrolment.created; eremu oso bat, adibidez course.*; edo dena. Lan-fluxua aktibatzean, nodoak Quire-n webhook-harpidetza sortzen du n8n-en helbiderako; desaktibatzean harpidetza kentzen du.

Bidalketa bakoitzaren sinadura egiaztatzen da lan-fluxua exekutatu aurretik. Egiaztatzen ez den bidalketa nodo-errore batekin baztertzen da, eskaera faltsu batek lan-fluxua abiarazi ez dezan. Gertaeraren data eremuak identifikatzaileak ditu; gehitu Quire nodo bat abiarazlearen ondoren erregistro osoa eskuratzeko.

Adibidea: matrikulatzean ongietorri-mezua bidali

1. Quire Trigger, enrolment.created gertaerarekin.
2. Quire nodoa, Users baliabidea, Get eragiketa, erabiltzaile-ID honekin: {{$json.data.user_id}}.
3. Quire nodoa, Courses baliabidea, Get eragiketa, ikastaro-ID honekin: {{$json.data.course_id}}.
4. Zure posta- edo txat-nodoa, pertsonaren izena eta ikastaroaren izenburua erabiliz.

Arazoak konpontzea

• 401 dei guztietan: Base URLa eta gakoa erakunde desberdinetakoak dira edo gakoa ezeztatu da.
• 403 eragiketa batean: gakoak ez du irismen hori. Gehitu /admin/integrations/api-keys helbidean.
• Abiarazlea ez da inoiz pizten: Quire-k HTTPS bidez iritsi behar du n8n-en webhook-helbidera. Egiaztatu harpidetzaren bidalketa-erregistroa /admin/webhooks helbidean.