---
title: "n8n"
description: "Awtomeiddio Quire gyda n8n a nod cymunedol Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Mae nod cymunedol Quire ar gyfer n8n yn darparu nod gweithredu ar gyfer yr API REST
ac yn sbarduno llifoedd gwaith pan fydd rhywbeth yn digwydd yn Quire.
Nid oes ganddo ddibyniaethau amser rhedeg, felly nid yw'n ychwanegu dim at eich instans n8n ond
ei hun.

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

Yn n8n, agorwch **Settings**, yna **Community nodes**, dewiswch **Install**, a
nodwch `@quire/n8n-node`. Ar n8n hunangynhaliol gallwch redeg yn lle hynny
`npm install @quire/n8n-node` yn ffolder defnyddiwr n8n ac ailgychwyn.

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

Crëwch fanylyn cysylltu. Cynigir dau fath:

- **Quire API Key**: **Base URL** yw cyfeiriad eich sefydliad heb slaes
  terfynol, megis `https://acme.quirelms.com`. **API Key** yw allwedd a grëwyd gan
  weinyddwr yn `/admin/integrations/api-keys`, gan ddechrau ag
  `qk_live_`. Rhowch y cwmpasau sydd eu hangen ar y llif gwaith yn unig.
- **Quire OAuth2**: ar gyfer llifoedd gwaith a ddylai weithredu fel person penodol.
  Cofrestrwch gleient OAuth yn `/admin/integrations/oauth-clients` gyda chyfeiriad
  ailgyfeirio n8n (mae n8n yn ei ddangos wrth greu'r manylyn cysylltu), yna nodwch ID y cleient,
  cyfrinach a chwmpasau.

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

Mae nod **Quire** yn cwmpasu defnyddwyr, cyrsiau, cofrestriadau, grwpiau, cwblhau,
graddau, tystysgrifau, cyflwyniadau, ymdrechion cwis, rhaglenni, archebion, e-bost a
sefydliadau. Mae pob un yn cynnig rhestru, cael, creu, diweddaru a dileu lle mae'r API'n
caniatáu hynny, ac uwchlwytho drwy ID allanol, sef yr hyn rydych ei eisiau ar gyfer cydamseru: rhedwch yr un
llif gwaith ddwywaith ac ni chaiff dim ei ddyblygu.

Cynhyrchir y gweithrediadau o ddogfen OpenAPI Quire, felly maent yn cyfateb
fesul maes i'r [cyfeirnod API](https://docs.quirelms.com/api/). Gellir defnyddio pob gweithrediad hefyd
fel offeryn gan asiant AI n8n; daw ei ddisgrifiad o'r cyfeirnod API.

Mae rhestrau'n dychwelyd pob tudalen yn ddiofyn. Diffoddwch **Return All** a gosodwch derfyn
ar gyfer sefydliadau mawr.

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

Ychwanegwch nod **Quire Trigger**, dewiswch y manylyn cysylltu, a dewiswch y
**Events**: digwyddiad yn ôl enw megis `enrolment.created`, ardal gyfan megis
`course.*`, neu bopeth. Pan fyddwch yn actifadu'r llif gwaith, mae'r nod yn creu tanysgrifiad webhook yn Quire ar gyfer cyfeiriad n8n; pan fyddwch yn
anactifadu, caiff y tanysgrifiad ei dynnu.

Caiff llofnod pob dosbarthiad ei wirio cyn rhedeg y llif gwaith. Mae dosbarthiad
nad yw'n dilysu yn cael ei ollwng gyda gwall nod, felly ni all cais ffug
gychwyn eich llif gwaith. Mae `data` y digwyddiad yn cynnwys dynodwyr; ychwanegwch nod
Quire ar ôl y sbardun i nôl y cofnod llawn.

## Enghraifft: e-bost croeso wrth gofrestru <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** ar `enrolment.created`.
2. Nod **Quire**, adnodd **Users**, gweithred **Get**, gydag ID y defnyddiwr
   `{{$json.data.user_id}}`.
3. Nod **Quire**, adnodd **Courses**, gweithred **Get**, gydag ID y cwrs
   `{{$json.data.course_id}}`.
4. Eich nod e-bost neu sgwrs, gan ddefnyddio enw'r person a theitl y cwrs.

## Datrys problemau <!--quire:troubleshooting-->

- **401** ar bob galwad: mae'r URL sylfaenol a'r allwedd yn perthyn i sefydliadau
  gwahanol, neu cafodd yr allwedd ei dirymu.
- **403** ar un gweithred: nid oes gan yr allwedd y cwmpas hwnnw. Ychwanegwch ef yn
  `/admin/integrations/api-keys`.
- Nid yw'r sbardun byth yn tanio: rhaid bod modd cyrraedd cyfeiriad webhook n8n o
  Quire dros HTTPS. Gwiriwch gofnod dosbarthu'r tanysgrifiad yn
  `/admin/webhooks`.

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