n8n

El node comunitari de Quire per a n8n ofereix un node d’acció per a l’API REST i un node activador que inicia un flux de treball quan passa alguna cosa a Quire. No té dependències en temps d’execució; per tant, no afegeix res a la instància d’n8n, tret del mateix node.

Instal·lació

A n8n, obriu Settings, després Community nodes, trieu Install i introduïu @quire/n8n-node. En una instal·lació pròpia d’n8n, també podeu executar npm install @quire/n8n-node a la carpeta de l’usuari d’n8n i reiniciar-lo.

Connexió

Creeu una credencial. Hi ha dues opcions:

• Quire API Key: a Base URL, introduïu l’adreça de la vostra organització sense la barra final, com ara https://acme.quirelms.com. A API Key, poseu-hi una clau creada per un administrador a /admin/integrations/api-keys, que comença amb qk_live_. Assigneu-li només els àmbits necessaris per al flux de treball.
• Quire OAuth2: per als fluxos de treball que hagin d’actuar com una persona concreta. Registreu un client OAuth a /admin/integrations/oauth-clients amb l’adreça de redirecció d’n8n (n8n la mostra a la credencial) i, tot seguit, introduïu l’ID del client, el secret i els àmbits.

Accions

El node Quire cobreix usuaris, cursos, inscripcions, grups, complecions, qualificacions, certificats, lliuraments, intents de qüestionari, programes, comandes, correu electrònic i organitzacions. Quan l’API ho permet, cada recurs ofereix operacions de llista, consulta, creació, actualització i supressió, a més d’upsert per ID extern; és el que convé fer per sincronitzar dades, perquè si executeu el mateix flux dues vegades no es dupliquen.

Les operacions es generen a partir del document OpenAPI de Quire, de manera que coincideixen camp per camp amb la referència de l’API. Un agent d’IA d’n8n també pot utilitzar qualsevol operació com a eina; la seva descripció prové de la referència de l’API.

Les llistes retornen totes les pàgines de manera predeterminada. Per a organitzacions grans, desactiveu Return All i establiu un límit.

Activador

Afegiu el node Quire Trigger, trieu la credencial i seleccioneu els Events: un esdeveniment pel nom, com ara enrolment.created; tota una àrea, com course.*; o bé tots els esdeveniments. Quan activeu el flux de treball, el node crea a Quire una subscripció al webhook amb l’adreça d’n8n; quan el desactiveu, elimina la subscripció.

La signatura de cada lliurament es verifica abans d’executar el flux. Si la verificació falla, el lliurament es descarta i el node mostra un error; així, una petició falsificada no pot iniciar el flux. El camp data de l’esdeveniment conté identificadors; afegiu un node Quire després de l’activador per obtenir el registre complet.

Exemple: enviar un correu de benvinguda en inscriure’s

1. Node Quire Trigger per a enrolment.created.
2. Node Quire, recurs Users, operació Get, amb l’ID d’usuari {{$json.data.user_id}}.
3. Node Quire, recurs Courses, operació Get, amb {{$json.data.course_id}}.
4. El vostre node de correu o xat, amb el nom de la persona i el títol del curs.

Resolució de problemes

• 401 a totes les crides: l’adreça base i la clau pertanyen a organitzacions diferents, o bé la clau s’ha revocat.
• 403 en una operació: la clau no té l’àmbit necessari. Afegiu-lo a /admin/integrations/api-keys.
• L’activador no s’executa: l’adreça del webhook d’n8n ha de ser accessible des de Quire mitjançant HTTPS. Consulteu el registre de lliuraments de la subscripció a /admin/webhooks.