n8n

Quire-community-noden til n8n giver dig en handlingsnode til REST API og en udløsernode, der starter en arbejdsgang, når noget sker i Quire. Den har ingen afhængigheder under kørsel, så den tilføjer ikke andet til din n8n-instans end sig selv.

Installation

Åbn Settings i n8n, vælg Community nodes, vælg Install, og indtast @quire/n8n-node. I en selvhostet n8n-instans kan du i stedet køre npm install @quire/n8n-node i n8n-brugermappen og genstarte.

Forbind

Opret en adgangsoplysning. Der tilbydes to typer:

• Quire API Key: Base URL er organisationens adresse uden en afsluttende skråstreg, f.eks. https://acme.quirelms.com. API Key er en nøgle, en administrator har oprettet på /admin/integrations/api-keys, og den begynder med qk_live_. Giv den kun de scopes, arbejdsgangen har brug for.
• Quire OAuth2: til arbejdsgange, der skal handle på vegne af en bestemt person. Registrér en OAuth-klient på /admin/integrations/oauth-clients med n8n’s omdirigeringsadresse (n8n viser den i adgangsoplysningen), og indtast derefter klient-id, hemmelighed og scopes.

Handlinger

Noden Quire dækker brugere, kurser, tilmeldinger, grupper, gennemførelser, bedømmelser, certifikater, afleveringer, quizforsøg, programmer, ordrer, e-mail og organisationer. For hver ressource kan du liste, hente, oprette, opdatere og slette, når API’et understøtter det, samt oprette eller opdatere via eksternt id. Det er nyttigt til synkronisering: Kør samme arbejdsgang to gange, så oprettes der ikke dubletter.

Handlingerne genereres ud fra Quires OpenAPI-dokument, så de stemmer overens med felterne i API-referencen. Hver handling kan også bruges som værktøj af en n8n-AI-agent; beskrivelsen stammer fra API-referencen.

Lister returnerer som standard alle sider. Slå Return All fra, og angiv en grænse for store organisationer.

Udløser

Tilføj noden Quire Trigger, vælg adgangsoplysningen, og vælg Events: en hændelse efter navn, f.eks. enrolment.created, et helt område som course.* eller alt. Når du aktiverer arbejdsgangen, opretter noden et webhook-abonnement i Quire til n8n’s adresse; når du deaktiverer den, fjernes abonnementet.

Hver leverings signatur kontrolleres, før arbejdsgangen kører. En levering, der ikke godkendes, droppes med en nodefejl, så en forfalsket anmodning ikke kan starte arbejdsgangen. Hændelsens data indeholder identifikatorer; tilføj en Quire-node efter udløseren for at hente hele posten.

Eksempel: velkomstmail ved tilmelding

1. Quire Trigger for enrolment.created.
2. Quire-node, ressource Users, handling Get, med bruger-id’et {{$json.data.user_id}}.
3. Quire-node, ressource Courses, handling Get, med {{$json.data.course_id}}.
4. Din e-mail- eller chatnode med personens navn og kursets titel.

Fejlfinding

• 401 ved alle kald: Base URL og nøglen tilhører forskellige organisationer, eller nøglen er tilbagekaldt.
• 403 ved én handling: Nøglen mangler det pågældende scope. Tilføj det på /admin/integrations/api-keys.
• Udløseren aktiveres aldrig: n8n’s webhook-adresse skal kunne nås fra Quire via HTTPS. Kontrollér abonnementets leveringslog på /admin/webhooks.