n8n | Quire

Quires fellesskapsnode for n8n gir deg en handlingsnode for REST-API-et og en utløsernode som starter en arbeidsflyt når noe skjer i Quire. Den har ingen kjøretidsavhengigheter, så den legger ingenting til n8n-instansen din utover seg selv.

Installasjon

I n8n åpner du Settings, deretter Community nodes, velger Install, og skriver inn @quire/n8n-node. På en selvdrevet n8n kan du i stedet kjøre npm install @quire/n8n-node i n8ns brukermappe og starte på nytt.

Koble til

Opprett en legitimasjon. To typer tilbys:

Quire API Key: Base URL er organisasjonens adresse uten skråstrek på slutten, for eksempel https://acme.quirelms.com. API Key er en nøkkel en administrator opprettet på /admin/integrations/api-keys, som starter med qk_live_. Gi den bare omfangene arbeidsflyten trenger.
Quire OAuth2: for arbeidsflyter som skal handle som en bestemt person. Registrer en OAuth-klient på /admin/integrations/oauth-clients med n8ns omdirigeringsadresse (n8n viser den på legitimasjonen), og skriv deretter inn klient-ID, hemmelighet og omfang.

Handlinger

Quire-noden dekker brukere, kurs, påmeldinger, grupper, fullføringer, karakterer, vitnemål, innleveringer, quizforsøk, programmer, bestillinger, e-post og organisasjoner. Hver tilbyr vis, hent, opprett, oppdater og slett der API-et gjør det, og upsert etter ekstern ID, som er det du vil ha for en synkronisering: kjør samme arbeidsflyt to ganger og ingenting dupliseres.

Operasjonene genereres fra Quires OpenAPI-dokument, så de samsvarer med API-referansen felt for felt. Hver operasjon kan også brukes som verktøy av en n8n AI-agent; beskrivelsen dens kommer fra API-referansen.

Lister returnerer alle sider som standard. Slå av Return All og sett en grense for store organisasjoner.

Utløser

Legg til Quire Trigger-noden, velg legitimasjonen, og velg Events: en hendelse etter navn som enrolment.created, et helt område som course.*, eller alt. Når du aktiverer arbeidsflyten, oppretter noden et webhook-abonnement i Quire for n8ns adresse; når du deaktiverer den, fjernes abonnementet.

Hver leverings signatur sjekkes før arbeidsflyten kjører. En levering som ikke verifiseres, forkastes med en nodefeil, slik at en forfalsket forespørsel ikke kan starte arbeidsflyten din. Hendelsens data bærer identifikatorer; legg til en Quire-node etter utløseren for å hente hele posten.

Eksempel: velkomstepost ved påmelding

Quire Trigger på enrolment.created.
Quire-node, ressurs Users, operasjon Get, med bruker-ID-en {{$json.data.user_id}}.
Quire-node, ressurs Courses, operasjon Get, med {{$json.data.course_id}}.
Din e-post- eller chatnode, med personens navn og kursets tittel.

Feilsøking

401 på alle kall: basis-URL-en og nøkkelen tilhører ulike organisasjoner, eller nøkkelen ble tilbakekalt.
403 på én operasjon: nøkkelen mangler det omfanget. Legg det til på /admin/integrations/api-keys.
Utløseren slår aldri inn: n8ns webhook-adresse må være nåbar fra Quire over HTTPS. Sjekk abonnementets leveringslogg på /admin/webhooks.