---
title: "n8n"
description: "Automatizza Quire con n8n e il nodo community di Quire."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/it/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
Il nodo community di Quire per n8n offre un nodo azione per le API REST
e un nodo trigger che avvia un flusso quando qualcosa accade in Quire.
Non ha dipendenze di runtime, quindi non aggiunge nulla alla tua istanza n8n oltre
sé stesso.
## Installazione
In n8n, apri **Impostazioni**, poi **Nodi community**, scegli **Installa** e
inserisci `@quire/n8n-node`. Su un n8n autonomo puoi invece eseguire
`npm install @quire/n8n-node` nella cartella utente di n8n e riavviare.
## Connessione
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
Crea una credenziale. Ne sono offerte due tipi:
- **Chiave API Quire**: **URL di base** è l'indirizzo della tua organizzazione senza
barra finale, ad esempio `https://acme.quirelms.com`. **Chiave API** è una chiave creata da un
amministratore in `/admin/integrations/api-keys`, che inizia con
`qk_live_`. Assegnale solo gli ambiti di cui il flusso ha bisogno.
- **OAuth2 Quire**: per flussi che devono agire come una persona specifica.
Registra un client OAuth in `/admin/integrations/oauth-clients` con l'indirizzo di
reindirizzamento di n8n (n8n lo mostra sulla credenziale), poi inserisci ID client,
segreto e ambiti.
## Azioni
Il nodo **Quire** copre utenti, corsi, iscrizioni, gruppi, completamenti,
voti, certificati, consegne, tentativi quiz, programmi, ordini, email e
organizzazioni. Ciascuno offre elenco, lettura, creazione, aggiornamento ed eliminazione dove le API
lo fanno, e upsert per ID esterno, ideale per una sincronizzazione: esegui due volte lo
stesso flusso e nulla viene duplicato.
Le operazioni sono generate dal documento OpenAPI di Quire, quindi corrispondono al
[riferimento API](https://docs.quirelms.com/api/) campo per campo. Ogni operazione può anche essere
usata come strumento da un agente IA di n8n; la sua descrizione proviene dal riferimento
API.
Gli elenchi restituiscono ogni pagina per impostazione predefinita. Disattiva **Restituisci tutto** e imposta un limite
per le organizzazioni grandi.
## Trigger
Aggiungi il nodo **Trigger Quire**, scegli la credenziale e poi gli
**Eventi**: un evento per nome come `enrolment.created`, un'intera area come
`course.*`, oppure tutto. Quando attivi il flusso, il nodo
crea una sottoscrizione webhook in Quire per l'indirizzo di n8n; quando lo
disattivi, la sottoscrizione viene rimossa.
La firma di ciascuna consegna viene verificata prima che il flusso venga eseguito. Una consegna
che non viene verificata viene scartata con un errore del nodo, così una richiesta contraffatta
non può avviare il tuo flusso. Il `data` dell'evento contiene identificatori; aggiungi un
nodo Quire dopo il trigger per recuperare il record completo.
## Esempio: email di benvenuto all'iscrizione
1. **Trigger Quire** su `enrolment.created`.
2. Nodo **Quire**, risorsa **Utenti**, operazione **Leggi**, con l'ID utente
`{{$json.data.user_id}}`.
3. Nodo **Quire**, risorsa **Corsi**, operazione **Leggi**, con
`{{$json.data.course_id}}`.
4. Il tuo nodo email o chat, usando il nome della persona e il titolo del corso.
## Risoluzione dei problemi
- **401** su ogni chiamata: URL di base e chiave appartengono a organizzazioni diverse,
oppure la chiave è stata revocata.
- **403** su un'operazione: alla chiave manca quell'ambito. Aggiungilo in
`/admin/integrations/api-keys`.
- Il trigger non si attiva mai: l'indirizzo webhook di n8n deve essere raggiungibile da
Quire via HTTPS. Controlla il registro consegne della sottoscrizione in
`/admin/webhooks`.
Source: https://docs.quirelms.com/it/integrations/n8n/index.mdx
