---
title: "n8n"
description: "Sjálfvirknivæddu Quire með n8n og Quire-hnúti samfélagsins."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/is/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

Quire-hnútur samfélagsins fyrir n8n gefur þér aðgerðahnút fyrir REST API og
kveikjuhnút sem ræsir verkflæði þegar eitthvað gerist í Quire. Hann hefur engin
keyrslutímaaðhengi og bætir því engu öðru við n8n-uppsetninguna þína.

## Setja upp <!--quire:install-->

Í n8n skaltu opna **Settings**, síðan **Community nodes**, velja **Install** og
slá inn `@quire/n8n-node`. Í sjálfhýstri n8n-uppsetningu geturðu í staðinn keyrt
`npm install @quire/n8n-node` í notendamöppu n8n og endurræst hana.

## Tengjast <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

Búðu til auðkenni. Boðið er upp á tvær tegundir:

- **Quire API Key**: **Base URL** er heimilisfang stofnunarinnar þinnar án skástriks
  aftast, til dæmis `https://acme.quirelms.com`. **API Key** er lykill sem stjórnandi
  bjó til á `/admin/integrations/api-keys` og byrjar á `qk_live_`. Veittu honum
  aðeins þau heimildasvið sem verkflæðið þarf.
- **Quire OAuth2**: fyrir verkflæði sem eiga að framkvæma aðgerðir sem ákveðinn
  einstaklingur. Skráðu OAuth-biðlara á `/admin/integrations/oauth-clients` með
  tilvísunarslóð n8n (n8n sýnir hana á auðkenninu) og sláðu síðan inn biðlaraauðkenni,
  leyndarmál og heimildasvið.

## Aðgerðir <!--quire:actions-->

**Quire**-hnúturinn nær yfir notendur, námskeið, skráningar, hópa, námslok,
einkunnir, skírteini, verkefnaskil, próftilraunir, námsleiðir, pantanir, tölvupóst
og stofnanir. Fyrir hvert úrræði eru aðgerðirnar list, get, create, update og
delete í boði þar sem API styður þær, ásamt upsert eftir ytra auðkenni. Það hentar
best fyrir samstillingu: keyrirðu sama verkflæði tvisvar verður ekkert tvítekið.

Aðgerðirnar eru búnar til úr OpenAPI-skjalinu frá Quire og samsvara því [API-
tilvísuninni](https://docs.quirelms.com/api/) reit fyrir reit. Hverja aðgerð má einnig nota sem verkfæri
fyrir gervigreindarfulltrúa n8n; lýsing hennar kemur úr API-tilvísuninni.

Listar skila sjálfgefið öllum síðum. Slökktu á **Return All** og stilltu mörk ef
stofnunin er stór.

## Kveikja <!--quire:trigger-->

Bættu við **Quire Trigger**-hnútnum, veldu auðkennið og veldu **Events**: atburð
eftir heiti eins og `enrolment.created`, heilt svæði eins og `course.*` eða alla
atburði. Þegar verkflæðið er virkjað stofnar hnúturinn vefkróksáskrift í Quire
á slóð n8n; þegar það er óvirkjað er áskriftin fjarlægð.

Undirskrift hverrar sendingar er sannreynd áður en verkflæðið keyrir. Sendingu sem
stenst ekki sannprófun er hent með hnútavillu svo fölsuð beiðni geti ekki ræst
verkflæðið. `data` atburðarins inniheldur auðkenni; bættu Quire-hnúti á eftir
kveikjunni til að sækja alla færsluna.

## Dæmi: velkominn tölvupóstur við skráningu <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** á `enrolment.created`.
2. **Quire**-hnútur, úrræði **Users**, aðgerð **Get**, með notandaauðkennið
   `{{$json.data.user_id}}`.
3. **Quire**-hnútur, úrræði **Courses**, aðgerð **Get**, með
   `{{$json.data.course_id}}`.
4. Tölvupósts- eða spjallhnúturinn þinn notar nafn viðkomandi og heiti námskeiðs.

## Úrræðaleit <!--quire:troubleshooting-->

- **401** við hvert kall: grunnslóðin og lykillinn tilheyra ekki sömu stofnun eða
  lykillinn hefur verið afturkallaður.
- **403** við eina aðgerð: lykilinn skortir viðeigandi heimildasvið. Bættu því við á
  `/admin/integrations/api-keys`.
- Kveikjan fer aldrei af stað: vefkróksslóð n8n verður að vera aðgengileg frá Quire
  yfir HTTPS. Athugaðu afhendingarskrá áskriftarinnar á `/admin/webhooks`.

Source: https://docs.quirelms.com/is/integrations/n8n/index.mdx