---
title: "n8n"
description: "Outomatiseer Quire met n8n en die Quire-gemeenskapsnodus."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/af/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
Die Quire-gemeenskapsnodus vir n8n bied ’n aksienodus vir die REST API en ’n sneller-nodus wat ’n werkvloei begin wanneer iets in Quire gebeur. Dit het geen looptydafhanklikhede nie, dus voeg dit niks by jou n8n-instansie behalwe homself nie.
## Installeer
Maak in n8n **Settings** oop, dan **Community nodes**, kies **Install** en voer `@quire/n8n-node` in. Op selfgehuisveste n8n kan jy eerder `npm install @quire/n8n-node` in die n8n-gebruikerslêergids uitvoer en herbegin.
## Koppel
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
Skep ’n aanmeldbewys. Twee soorte is beskikbaar:
- **Quire API Key**: **Base URL** is jou organisasie se adres sonder ’n skuinsstreep agteraan, soos `https://acme.quirelms.com`. **API Key** is ’n sleutel wat ’n administrateur by `/admin/integrations/api-keys` geskep het en met `qk_live_` begin. Gee dit net die omvang wat die werkvloei nodig het.
- **Quire OAuth2**: vir werkvloeie wat as ’n bepaalde persoon moet optree. Registreer ’n OAuth-kliënt by `/admin/integrations/oauth-clients` met n8n se herleidingsadres (n8n wys dit op die aanmeldbewys), en voer dan die kliënt-ID, geheim en omvang in.
## Aksies
Die **Quire**-nodus dek gebruikers, kursusse, inskrywings, groepe, voltooiings, punte, sertifikate, indienings, vasvra-pogings, programme, bestellings, e-pos en organisasies. Vir elkeen word lys, kry, skep, werk by en skrap aangebied waar die API dit bied, asook opdatering of invoeging volgens eksterne ID — nuttig vir sinkronisering: voer dieselfde werkvloei twee keer uit en niks word gedupliseer nie.
Die bewerkings word uit Quire se OpenAPI-dokument gegenereer, dus stem hulle veld vir veld ooreen met die [API-verwysing](https://docs.quirelms.com/api/). Elke bewerking kan ook deur ’n n8n-KI-agent as ’n nutsmiddel gebruik word; die beskrywing kom uit die API-verwysing.
Lyste gee by verstek elke bladsy terug. Skakel **Return All** af en stel ’n limiet vir groot organisasies.
## Sneller
Voeg die **Quire Trigger**-nodus by, kies die aanmeldbewys en kies die **Events**: ’n gebeurtenis volgens naam soos `enrolment.created`, ’n hele area soos `course.*` of alles. Wanneer jy die werkvloei aktiveer, skep die nodus ’n webhook-intekening in Quire vir n8n se adres; wanneer jy dit deaktiveer, word die intekening verwyder.
Elke aflewering se handtekening word nagegaan voordat die werkvloei loop. ’n Aflewering wat nie bekragtig nie, word met ’n nodusfout laat vaar, sodat ’n vervalste versoek nie jou werkvloei kan begin nie. Die gebeurtenis se `data` bevat identifiseerders; voeg ná die sneller ’n Quire-nodus by om die volledige rekord te kry.
## Voorbeeld: verwelkomingse-pos by inskrywing
1. **Quire Trigger** op `enrolment.created`.
2. **Quire**-nodus, hulpbron **Users**, bewerking **Get**, met die gebruiker-ID `{{$json.data.user_id}}`.
3. **Quire**-nodus, hulpbron **Courses**, bewerking **Get**, met `{{$json.data.course_id}}`.
4. Jou e-pos- of kletsnodus, met die persoon se naam en kursustitel.
## Probleemoplossing
- **401** op elke oproep: die basis-URL en sleutel behoort aan verskillende organisasies, of die sleutel is herroep.
- **403** op een bewerking: die sleutel het nie daardie omvang nie. Voeg dit by by `/admin/integrations/api-keys`.
- Die sneller loop nooit af nie: n8n se webhook-adres moet vanaf Quire oor HTTPS bereikbaar wees. Kontroleer die intekening se afleweringslog by `/admin/webhooks`.
Source: https://docs.quirelms.com/af/integrations/n8n/index.mdx
