---
title: "n8n"
description: "I-automate ang Quire gamit ang n8n at Quire community node."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/fil/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
Nagbibigay ang Quire community node para sa n8n ng action node para sa REST API
at trigger node na nagsisimula ng workflow kapag may nangyari sa Quire. Wala
itong runtime dependency, kaya wala itong idinadagdag sa n8n instance mo maliban
sa sarili nito.
## Pag-install
Sa n8n, buksan ang **Settings**, pagkatapos ay **Community nodes**, piliin ang
**Install**, at ilagay ang `@quire/n8n-node`. Sa self-hosted na n8n, maaari mo
ring patakbuhin ang `npm install @quire/n8n-node` sa folder ng n8n user at
i-restart ito.
## Pagkonekta
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
Gumawa ng credential. May dalawang uri:
- **Quire API Key**: ang **Base URL** ay address ng organisasyon mo na walang
trailing slash, gaya ng `https://acme.quirelms.com`. Ang **API Key** ay key na
ginawa ng administrador sa `/admin/integrations/api-keys` at nagsisimula sa
`qk_live_`. Ibigay lamang ang mga scope na kailangan ng workflow.
- **Quire OAuth2**: para sa workflow na dapat kumilos bilang partikular na tao.
Magrehistro ng OAuth client sa `/admin/integrations/oauth-clients` gamit ang
redirect address ng n8n (ipinapakita ito ng n8n sa credential), saka ilagay
ang client ID, secret, at mga scope.
## Mga action
Saklaw ng node na **Quire** ang mga user, kurso, enrollment, grupo, completion,
marka, sertipiko, submission, pagtatangka sa quiz, programa, order, email, at
organisasyon. Para sa bawat resource, may list, get, create, update, at delete
kung sinusuportahan ng API, pati upsert gamit ang external ID. Ito ang angkop
para sa pag-sync: patakbuhin man nang maraming ulit ang workflow, walang
madodobleng entry.
Binuo ang mga operation mula sa OpenAPI document ng Quire, kaya kapareho
ng bawat field ang [sanggunian ng API](https://docs.quirelms.com/api/). Maaari ring gamitin bilang
tool ng n8n AI agent ang bawat operation; mula sa sanggunian ng API ang
paglalarawan nito.
Default na ibinabalik ng mga list ang lahat ng pahina. I-off ang **Return All**
at magtakda ng limit para sa malalaking organisasyon.
## Trigger
Idagdag ang node na **Quire Trigger**, piliin ang credential at ang **Events**:
isang event ayon sa pangalan gaya ng `enrolment.created`, buong area gaya ng
`course.*`, o lahat. Kapag in-activate ang workflow, gagawa ang node ng webhook
subscription sa Quire para sa address ng n8n; kapag dineactivate, aalisin ang
subscription.
Sinusuri muna ang lagda ng bawat delivery bago patakbuhin ang workflow. Itinatapon
ang delivery na hindi mapatunayan at nagkakaroon ng error ang node, kaya hindi
makapagsisimula ng workflow ang pekeng request. May mga identifier ang `data`
ng event; magdagdag ng Quire node pagkatapos ng trigger para kunin ang buong record.
## Halimbawa: welcome email sa enrollment
1. **Quire Trigger** sa event na `enrolment.created`.
2. **Quire** node, resource na **Users**, operation na **Get**, gamit ang user ID
na `{{$json.data.user_id}}`.
3. **Quire** node, resource na **Courses**, operation na **Get**, gamit ang
course ID na `{{$json.data.course_id}}`.
4. Email o chat node gamit ang pangalan ng tao at pamagat ng kurso.
## Pag-troubleshoot
- **401** sa lahat ng tawag: magkaibang organisasyon ang Base URL at key, o
binawi na ang key.
- **403** sa isang operation: wala sa key ang scope na iyon. Idagdag ito sa
`/admin/integrations/api-keys`.
- Hindi gumagana ang trigger: kailangang maabot ng Quire ang webhook address ng
n8n sa HTTPS. Tingnan ang delivery log ng subscription sa `/admin/webhooks`.
Source: https://docs.quirelms.com/fil/integrations/n8n/index.mdx
