---
title: "n8n"
description: "Automatizate Quire cù n8n è u nodu cumunitariu Quire."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/co/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

U nodu cumunitariu Quire per n8n offre un nodu d’azzione per l’API REST è
un nodu d’attivazione chì principia un flussu di travagliu quandu accade
qualcosa in Quire. Ùn hà dipendenze in tempu d’esecuzione; dunque ùn aghjusta
nunda à a vostra istanza n8n fora di sè stessu.

## Installazione <!--quire:install-->

In n8n, aprite **Settings**, dopu **Community nodes**, sceglite **Install** è
scrivite `@quire/n8n-node`. In un n8n auto-ospitatu, pudete invece eseguisce
`npm install @quire/n8n-node` in u cartulare d’utilizatore n8n è riavvià.

## Cunnessione <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

Create una credenziale. Ci sò dui tippi:

- **Quire API Key**: **Base URL** hè l’indirizzu di a vostra urganizazione,
  senza barra finale, cum’è `https://acme.quirelms.com`. **API Key** hè una
  chjave creata da un amministratore à `/admin/integrations/api-keys`, chì
  principia cù `qk_live_`. Dalli solu l’ambiti necessarii à u flussu.
- **Quire OAuth2**: per i flussi chì devenu agisce cum’è una persona
  particulare. Registrate un client OAuth à `/admin/integrations/oauth-clients`
  cù l’indirizzu di redirezzione n8n (n8n u mostra in a credenziale), dopu
  inserite l’ID di u client, u secretu è l’ambiti.

## Azzioni <!--quire:actions-->

U nodu **Quire** gestisce utilizatori, corsi, iscrizzioni, gruppi,
cumpletamenti, note, certificati, travaglii mandati, tentativi di test,
prugrammi, ordini, email è urganizazioni. Ogni risorsa offre liste, lettura,
creazione, aghjurnamentu è sguassatura quand’ellu a permette l’API, è ancu
upsert per ID esternu, utile per a sincronizazione: eseguite u listessu flussu
duie volte è ùn si creanu duplicati.

L’operazioni sò generate da u documentu OpenAPI di Quire, cusì currispondenu
campu per campu à u [riferimentu API](https://docs.quirelms.com/api/). Ogni operazione pò ancu
esse aduprata cum’è strumentu da un agente IA n8n; a so descrizzione vene da u
riferimentu API.

Per difettu, e liste restituiscenu tutte e pagine. Per urganizazioni grande,
disattivate **Return All** è stabilite un limitu.

## Attivazione <!--quire:trigger-->

Aghjunghjite u nodu **Quire Trigger**, sceglite a credenziale è selezziunate
**Events**: un avvenimentu per nome cum’è `enrolment.created`, un spaziu
interu cum’è `course.*`, o tuttu. Quandu attivate u flussu, u nodu crea in
Quire un abbonamentu webhook à l’indirizzu n8n; quandu u disattivate,
l’abbonamentu hè eliminatu.

A firma di ogni mandata hè verificata prima di l’esecuzione di u flussu. Una
mandata micca valida hè scartata cù un errore di u nodu, cusì una dumanda
falsificata ùn pò principià u flussu. U campu `data` di l’avvenimentu cuntene
identificatori; aghjunghjite un nodu Quire dopu à u trigger per piglià u
registru cumpletu.

## Esempiu: email di benvenuta à l’iscrizzione <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** per `enrolment.created`.
2. Nodiu **Quire**, risorsa **Users**, operazione **Get**, cù l’ID d’utilizatore
   `{{$json.data.user_id}}`.
3. Nodiu **Quire**, risorsa **Courses**, operazione **Get**, cù
   `{{$json.data.course_id}}`.
4. U vostru nodu d’email o chat, cù u nome di a persona è u titulu di u cursu.

## Risoluzione di prublemi <!--quire:troubleshooting-->

- **401** à ogni chjama: l’URL di basa è a chjave appartenenu à
  urganizazioni sfarente, o a chjave hè stata revucata.
- **403** per una operazione: manca à a chjave quellu ambitu. Aghjunghjitelu
  à `/admin/integrations/api-keys`.
- U trigger ùn si lancia mai: l’indirizzu webhook n8n deve esse accessibile
  da Quire via HTTPS. Verificate u registru di mandate di l’abbonamentu à
  `/admin/webhooks`.

Source: https://docs.quirelms.com/co/integrations/n8n/index.mdx