---
title: "n8n"
description: "Awtomatizza Quire b'n8n u n-node komunitarja ta' Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

In-node komunitarja ta' Quire għal n8n tagħtik node ta' azzjoni għar-REST API
u node ta' trigger li jibda workflow meta jiġri xi ħaġa f'Quire.
M'għandha l-ebda dipendenza ta' runtime, għalhekk ma żżid xejn mal-istanza n8n tiegħek ħlief
liilha nnifisha.

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

F'n8n, iftaħ **Settings**, imbagħad **Community nodes**, agħżel **Install**, u
daħħal `@quire/n8n-node`. Fuq n8n self-hosted tista' minflok tħaddem
`npm install @quire/n8n-node` fil-folder tal-utent ta' n8n u terġa' tibda.

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

Oħloq kredenzjali. Żewġ tipi huma offruti:

- **Ċavetta API ta' Quire**: **Base URL** huwa l-indirizz tal-organizzazzjoni tiegħek mingħajr
  slash tat-tmiem, bħal `https://acme.quirelms.com`. **API Key** hija ċavetta li
  amministratur ħoloq f'`/admin/integrations/api-keys`, li tibda
  `qk_live_`. Agħtiha biss l-iskops li l-workflow jeħtieġ.
- **Quire OAuth2**: għal workflows li għandhom jaġixxu bħala persuna partikolari.
  Irreġistra klijent OAuth f'`/admin/integrations/oauth-clients` bl-indirizz ta' redirect ta' n8n
  (n8n jurih fuq il-kredenzjali), imbagħad daħħal il-klijent
  ID, is-sigriet u l-iskops.

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

In-node **Quire** ikopri utenti, korsijiet, reġistrazzjonijiet, gruppi, tlestijiet,
gradi, ċertifikati, sottomissjonijiet, tentattivi ta' kwizz, programmi, ordnijiet, email u
organizzazzjonijiet. Kull waħda toffri elenka, ġib, oħloq, aġġorna u ħassar fejn l-API
tagħmel, u upsert b'ID estern, li huwa dak li trid għal sync: ħaddem l-
istess workflow darbtejn u xejn ma jiġi dduplikat.

L-operazzjonijiet huma ġġenerati mid-dokument OpenAPI ta' Quire, għalhekk jaqblu
mar-[referenza tal-API](https://docs.quirelms.com/api/) qasam b'qasam. Kull operazzjoni tista' tintuża wkoll
bħala għodda minn aġent AI ta' n8n; id-deskrizzjoni tagħha tiġi mir-referenza
tal-API.

Il-listi jirritornaw kull paġna default. Itfi **Return All** u ssettja limitu
għal organizzazzjonijiet kbar.

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

Żid in-node **Quire Trigger**, agħżel il-kredenzjali, u agħżel l-
**Avvenimenti**: avveniment bl-isem bħal `enrolment.created`, żona sħiħa bħal
`course.*`, jew kollox. Meta tattiva l-workflow, in-node
joħloq abbonament webhook f'Quire għall-indirizz ta' n8n; meta
tiddiżattivah, l-abbonament jitneħħa.

Il-firma ta' kull kunsinna tiġi ċċekkjata qabel ma jaħdem il-workflow. Kunsinna
li ma tivverifikax tintrema b'żball tan-node, biex talba ffalsifikata
ma tistax tibda l-workflow tiegħek. Id-`data` tal-avveniment iġorr identifikaturi; żid
node ta' Quire wara t-trigger biex iġġib ir-rekord sħiħ.

## Eżempju: email ta' merħba mar-reġistrazzjoni <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** fuq `enrolment.created`.
2. Node **Quire**, riżorsa **Utenti**, operazzjoni **Ġib**, bl-ID tal-utent
   `{{$json.data.user_id}}`.
3. Node **Quire**, riżorsa **Korsijiet**, operazzjoni **Ġib**, bi
   `{{$json.data.course_id}}`.
4. In-node tal-email jew chat tiegħek, bl-isem tal-persuna u t-titlu tal-kors.

## Solvi problemi <!--quire:troubleshooting-->

- **401** fuq kull sejħa: il-Base URL u ċ-ċavetta huma ta' organizzazzjonijiet differenti,
  jew iċ-ċavetta ġiet revokata.
- **403** fuq operazzjoni waħda: iċ-ċavetta m'għandhiex dak l-iskop. Żidu f'
  `/admin/integrations/api-keys`.
- It-trigger qatt ma jaħdem: l-indirizz webhook ta' n8n irid ikun milħuq minn
  Quire fuq HTTPS. Iċċekkja l-log tal-kunsinna tal-abbonament f'
  `/admin/webhooks`.

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