n8n | Quire

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

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

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

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. 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

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 Trigger per enrolment.created.
Nodiu Quire, risorsa Users, operazione Get, cù l’ID d’utilizatore {{$json.data.user_id}}.
Nodiu Quire, risorsa Courses, operazione Get, cù {{$json.data.course_id}}.
U vostru nodu d’email o chat, cù u nome di a persona è u titulu di u cursu.

Risoluzione di prublemi

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.