---
title: "n8n"
description: "Automasikan Quire dengan n8n dan nod komuniti Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Nod komuniti Quire untuk n8n memberikan anda sebuah nod tindakan untuk REST API
dan nod pemicu yang memulakan aliran kerja apabila sesuatu berlaku dalam Quire.
Ia tiada kebergantungan masa laksana, jadi ia tidak menambah apa-apa kepada
instans n8n anda selain dirinya sendiri.

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

Dalam n8n, buka **Settings**, kemudian **Community nodes**, pilih **Install**,
dan masukkan `@quire/n8n-node`. Pada n8n kendiri, anda boleh sebaliknya menjalankan
`npm install @quire/n8n-node` dalam folder pengguna n8n dan memulakan semula.

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

Cipta satu kelayakan. Dua jenis ditawarkan:

- **Quire API Key**: **Base URL** ialah alamat organisasi anda tanpa garis miring
  di hujungnya, seperti `https://acme.quirelms.com`. **API Key** ialah kunci yang dicipta
  oleh pentadbir di `/admin/integrations/api-keys`, bermula `qk_live_`. Berikannya
  hanya skop yang diperlukan oleh aliran kerja tersebut.
- **Quire OAuth2**: untuk aliran kerja yang sepatutnya bertindak sebagai seseorang
  tertentu. Daftarkan pelanggan OAuth di `/admin/integrations/oauth-clients`
  dengan alamat pengalihan n8n (n8n memaparkannya pada kelayakan tersebut),
  kemudian masukkan ID pelanggan, rahsia dan skop.

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

Nod **Quire** merangkumi pengguna, kursus, pendaftaran, kumpulan, penyiakan,
gred, sijil, penyerahan, percubaan kuiz, program, pesanan, e-mel dan organisasi.
Setiap satu menawarkan senarai, dapat, cipta, kemas kini dan padam di mana API
menyediakannya, serta upsert mengikut ID luaran, yang memang anda mahukan untuk
satu penyegerakan: jalankan aliran kerja yang sama dua kali dan tiada apa-apa
diduplikasikan.

Operasi dijana daripada dokumen OpenAPI Quire, jadi ia sepadan dengan
[rujukan API](https://docs.quirelms.com/api/), medan demi medan. Setiap operasi juga boleh digunakan
sebagai alat oleh ejen AI n8n; huraiannya datang daripada rujukan API.

Senarai mengembalikan setiap halaman secara lalai. Matikan **Return All** dan
tetapkan satu had untuk organisasi yang besar.

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

Tambah nod **Quire Trigger**, pilih kelayakan tersebut, dan pilih
**Peristiwa**: satu peristiwa mengikut nama seperti `enrolment.created`,
seluruh bidang seperti `course.*`, atau segala-galanya. Apabila anda
mengaktifkan aliran kerja itu, nod mencipta langganan webhook dalam Quire untuk
alamat n8n; apabila anda menyahaktifkannya, langganan itu dibuang.

Tandatangan setiap penghantaran disemak sebelum aliran kerja berjalan. Penghantaran
yang tidak sah akan dibuang bersama ralat nod, jadi satu permintaan yang dipalsukan
tidak boleh memulakan aliran kerja anda. Peristiwa `data` membawa pengenal; tambah
nod Quire selepas pemicu untuk mendapatkan rekod penuh.

## Contoh: e-mel alu-aluan semasa pendaftaran <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** pada `enrolment.created`.
2. Nod **Quire**, sumber **Users**, operasi **Get**, dengan ID pengguna
   `{{$json.data.user_id}}`.
3. Nod **Quire**, sumber **Courses**, operasi **Get**, dengan
   `{{$json.data.course_id}}`.
4. Nod e-mel atau sembang anda, menggunakan nama orang tersebut dan tajuk kursus.

## Penyelesaian masalah <!--quire:troubleshooting-->

- **401** pada setiap panggilan: Base URL dan kunci tersebut adalah milik dua
  organisasi berbeza, atau kunci telah dibatalkan.
- **403** pada satu operasi: kunci itu tiada skop tersebut. Tambahkannya di
  `/admin/integrations/api-keys`.
- Pemicu tidak pernah berlaku: alamat webhook n8n mesti boleh dicapai daripada
  Quire melalui HTTPS. Semak log penghantaran langganan di
  `/admin/webhooks`.

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