n8n | Quire

De Quire Community-Node fir n8n gëtt Iech en Aktiouns-Node fir d’REST API an en Trigger-Node, deen en Workflow start, wann an Quire eppes geschéit. En huet keng Laufzäit-Ofhängegkeeten, en füügt also zu Ärer n8n-Instanz näischt derbäi ausser sech selwer.

Installéieren

Öffnen an n8n Settings, dann Community nodes, wielt Install a gitt @quire/n8n-node an. Op engem selwer gehostete n8n kënnt Dir amplaz npm install @quire/n8n-node am n8n-Benotzer-Ordner ausféieren an nei starten.

Verbannen

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.

Erstellt Zougangsdaten. Zwei Aarten ginn ugebueden:

Quire API Key: Base URL ass d’Adress vun Ärer Organisatioun ouni Slash um Enn, wéi https://acme.quirelms.com. API Key ass e Schlëssel, deen en Administrator um /admin/integrations/api-keys gemaach huet, deen mat qk_live_ ufänkt. Gitt him nëmmen d’Scopes, déi den Workflow brauch.
Quire OAuth2: fir Workflows, déi wéi eng bestëmmte Persoun handelen. Registréiert e Client um /admin/integrations/oauth-clients mat n8n sengem Redirect-Adress (n8n weist en op de Zougangsdaten), an erfuert dunn d’Client-ID, d’Geheimnis a d’Scopes.

Aktiounen

De Quire-Node deckt Benotzer, Coursen, Aschreiwungen, Gruppen, Ofschléisser, Noten, Zertifikater, Abgaben, Quiz-Versich, Programmer, Uerder, E-Mail an Organisatiounen. All bitt Lëschten, kréien, erstellen, aktualiséieren an läschen, wou d’API et mécht, an upsert no externem ID — wat Dir fir e Sync wëllt: féiert gläich zweemol de selwechte Workflow aus a näischt gëtt duplizéiert.

D’Operatioune ginn aus Quire sengem OpenAPI-Dokument generéiert, sou datt se der API-Referenz Feld fir Feld entspriechen. All Operatioun kann och als Tool vun engem n8n-KI-Agent benotzt ginn; seng Beschreiwung kënnt aus der API-Referenz.

Lëschten iwwerdroen all Säit standardméisseg. Maacht Return All aus a setzt en Limit fir grouss Organisatiounen.

Trigger

Füügt de Quire Trigger-Node derbäi, wielt d’Zougangsdaten an wielt d’Evenementer: en Evenement no Numm wéi enrolment.created, e ganze Beräich wéi course.*, oder alles. Wann Dir den Workflow aktivéiert, erstellt de Node en Webhook-Abonnement an Quire fir n8n seng Adress; wann Dir en desaktivéiert, gëtt d’Abonnement geholl.

D’Signatur vun all Liwwerung gëtt iwwerpréift, ier de Workflow leeft. Eng Liwwerung, déi net iwwerpréift gëtt, gëtt mat engem Node-Feeler weiggeworfen, sou datt eng fälschteg Demande Ären Workflow net starten kann. D’data vum Evenement dréit Identifikatioren; füügt no dem Trigger e Quire-Node derbäi, fir de ganzen Dossier ze fannen.

Beispill: Wëllkommens-E-Mail bei der Aschreiwung

Quire Trigger op enrolment.created.
Quire-Node, Ressource Users, Operatioun Get, mat der Benotzer-ID {{$json.data.user_id}}.
Quire-Node, Ressource Courses, Operatioun Get, mat {{$json.data.course_id}}.
Ären E-Mail- oder Chat-Node, mat dem Numm vun der Persoun an dem Titel vum Cours.

Problemléisung

401 bei all Uruff: d’Base URL an de Schlëssel gehéieren verschiddenen Organisatiounen, oder de Schlëssel gouf annuléiert.
403 bei enger Operatioun: de Schlëssel feelt dee Scope. Füügt en ëm /admin/integrations/api-keys derbäi.
Den Trigger fält ni un: d’Webhook-Adress vun n8n muss vun Quire iwwer HTTPS erreechbar sinn. Kuckt de Liwwerungs-Log vum Abonnement ëm /admin/webhooks.