---
title: "n8n"
description: "Aŭtomatigi Quire per n8n kaj la komunuma nodo de Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

La komunuma nodo de Quire por n8n provizas agan nodon por la REST-API
kaj ekigilan nodon, kiu komencas laborfluon kiam io okazas en Quire.
Ĝi ne havas rultempajn dependecojn, do ĝi aldonas nenion al via n8n-instanco krom
si mem.

## Instali <!--quire:install-->

En n8n, malfermu **Agordojn**, poste **Komunumaj nodoj**, elektu **Instali** kaj
enigu `@quire/n8n-node`. Ĉe memgastigata n8n, vi povas anstataŭe ruli
`npm install @quire/n8n-node` en la uzantdosierujo de n8n kaj rekomenci ĝin.

## Konekti <!--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>

Kreu legitimilon. Du tipoj estas ofertataj:

- **Quire API-ŝlosilo**: **Baza URL** estas la adreso de via organizaĵo sen
  fina oblikvo, ekzemple `https://acme.quirelms.com`. **API-ŝlosilo** estas ŝlosilo
  kreita de administranto ĉe `/admin/integrations/api-keys`, komenciĝanta per
  `qk_live_`. Donu al ĝi nur la ampleksojn bezonatajn de la laborfluo.
- **Quire OAuth2**: por laborfluoj agantaj kiel specifa persono.
  Registru OAuth-klienton ĉe `/admin/integrations/oauth-clients` kun la alidirekta
  adreso de n8n (montrata ĉe la legitimilo), poste enigu la klientan
  ID, sekreton kaj ampleksojn.

## Agoj <!--quire:actions-->

La nodo **Quire** kovras uzantojn, kursojn, aliĝojn, grupojn, kompletigojn,
notojn, atestilojn, senditajn laborojn, kvizprovojn, programojn, mendojn, retpoŝton kaj
organizaĵojn. Ĉiu rimedo ofertas listigon, legadon, kreadon, ĝisdatigon kaj forigon kie la API tion
permesas, kaj alĝustigon laŭ ekstera ID — tion vi bezonas por sinkronigo: rulu la saman
laborfluon dufoje kaj nenio duobliĝas.

Operacioj estas generitaj el la OpenAPI-dokumento de Quire, do ili kongruas kampon post kampo kun la
[API-referenco](https://docs.quirelms.com/api/). Ĉiu operacio ankaŭ uzeblas kiel ilo de n8n-AI-agento;
ĝia priskribo venas de la API-referenco.

Listoj defaŭlte redonas ĉiujn paĝojn. Malŝaltu **Redoni ĉion** kaj agordu limon
por grandaj organizaĵoj.

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

Aldonu la nodon **Quire Trigger**, elektu legitimilon kaj elektu la
**Eventojn**: unu eventon laŭ nomo kiel `enrolment.created`, tutan areon kiel
`course.*` aŭ ĉion. Aktivigante laborfluon, la nodo kreas webhook-abonon en Quire al la adreso de n8n; malaktivigante ĝin, la abono estas forigita.

La subskribo de ĉiu livero estas kontrolata antaŭ ol la laborfluo ruliĝas. Livero
kiu ne validas estas forĵetata kun noda eraro, do falsa peto
ne povas komenci vian laborfluon. `data` de la evento enhavas identigilojn; aldonu
Quire-nodon post la ekigilo por preni la plenan registron.

## Ekzemplo: bonveniga retpoŝto post aliĝo <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** ĉe `enrolment.created`.
2. Nodo **Quire**, rimedo **Uzantoj**, operacio **Legi**, kun la uzant-ID
   `{{$json.data.user_id}}`.
3. Nodo **Quire**, rimedo **Kursoj**, operacio **Legi**, kun
   `{{$json.data.course_id}}`.
4. Via retpoŝta aŭ babila nodo uzante la nomon de la persono kaj la titolon de kurso.

## Solvado de problemoj <!--quire:troubleshooting-->

- **401** ĉe ĉiu voko: la Baza URL kaj ŝlosilo apartenas al malsamaj
  organizaĵoj aŭ la ŝlosilo estis revokita.
- **403** ĉe unu operacio: al la ŝlosilo mankas tiu amplekso. Aldonu ĝin ĉe
  `/admin/integrations/api-keys`.
- La ekigilo neniam funkcias: la webhook-adreso de n8n devas esti atingebla de
  Quire per HTTPS. Kontrolu la liverprotokolon de la abono ĉe
  `/admin/webhooks`.

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