n8n | Quire

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

The API keys page with a key named for an n8n automation. — 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 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

Trigger Quire su enrolment.created.
Nodo Quire, risorsa Utenti, operazione Leggi, con l’ID utente {{$json.data.user_id}}.
Nodo Quire, risorsa Corsi, operazione Leggi, con {{$json.data.course_id}}.
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.