---
title: "n8n"
description: "Automatitzeu Quire amb n8n i el node comunitari de Quire."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ca/llms.txt
> Use this file to discover all available pages before exploring further.
# 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ó
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
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](https://docs.quirelms.com/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`.
Source: https://docs.quirelms.com/ca/integrations/n8n/index.mdx
