---
title: "n8n"
description: "Otomatiskan Quire dengan n8n dan node komunitas Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Node komunitas Quire untuk n8n menyediakan node aksi bagi REST API dan node pemicu yang memulai alur kerja saat sesuatu terjadi di Quire. Node ini tidak memiliki dependensi runtime, sehingga tidak menambahkan apa pun ke instans n8n Anda selain dirinya sendiri.

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

Di n8n, buka **Settings**, lalu **Community nodes**, pilih **Install**, dan masukkan `@quire/n8n-node`. Pada n8n yang dihosting sendiri, Anda juga dapat menjalankan `npm install @quire/n8n-node` di folder pengguna n8n lalu memulai ulang.

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

Buat kredensial. Ada dua jenis:

- **Quire API Key**: **Base URL** adalah alamat organisasi tanpa garis miring di akhir, misalnya `https://acme.quirelms.com`. **API Key** adalah kunci yang dibuat administrator di `/admin/integrations/api-keys`, dengan awalan `qk_live_`. Berikan cakupan yang diperlukan alur kerja saja.
- **Quire OAuth2**: untuk alur kerja yang harus bertindak sebagai orang tertentu. Daftarkan klien OAuth di `/admin/integrations/oauth-clients` dengan alamat pengalihan n8n (ditampilkan n8n di kredensial), lalu masukkan ID klien, rahasia, dan cakupannya.

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

Node **Quire** mencakup pengguna, kursus, pendaftaran, grup, penyelesaian, nilai, sertifikat, pengumpulan, percobaan kuis, program, pesanan, email, dan organisasi. Setiap sumber daya menawarkan list, get, create, update, dan delete jika API menyediakannya, serta upsert berdasarkan ID eksternal. Pilihan terakhir cocok untuk sinkronisasi: jalankan alur kerja yang sama dua kali dan data tidak akan terduplikasi.

Operasi dibuat dari dokumen OpenAPI Quire sehingga sesuai dengan setiap kolom di [referensi API](https://docs.quirelms.com/api/). Setiap operasi juga dapat digunakan sebagai alat oleh agen AI n8n; deskripsinya berasal dari referensi API.

Secara default, daftar mengembalikan semua halaman. Nonaktifkan **Return All** dan tetapkan batas untuk organisasi besar.

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

Tambahkan node **Quire Trigger**, pilih kredensial, lalu pilih **Events**: peristiwa berdasarkan nama seperti `enrolment.created`, seluruh area seperti `course.*`, atau semua peristiwa. Saat alur kerja diaktifkan, node membuat langganan webhook di Quire untuk alamat n8n; saat dinonaktifkan, langganan dihapus.

Tanda tangan setiap pengiriman diverifikasi sebelum alur kerja berjalan. Pengiriman yang tidak lolos verifikasi ditolak dengan kesalahan node sehingga permintaan palsu tidak dapat memulai alur kerja. `data` pada peristiwa memuat ID; tambahkan node Quire setelah pemicu untuk mengambil rekaman lengkap.

## Contoh: email sambutan saat pendaftaran <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** untuk `enrolment.created`.
2. Node **Quire**, sumber **Users**, operasi **Get**, dengan ID pengguna `{{$json.data.user_id}}`.
3. Node **Quire**, sumber **Courses**, operasi **Get**, dengan ID kursus `{{$json.data.course_id}}`.
4. Node email atau chat Anda, menggunakan nama orang dan judul kursus.

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

- **401** pada semua panggilan: Base URL dan kunci berasal dari organisasi berbeda, atau kunci telah dicabut.
- **403** pada satu operasi: kunci tidak memiliki cakupan itu. Tambahkan di `/admin/integrations/api-keys`.
- Pemicu tidak pernah berjalan: alamat webhook n8n harus dapat dijangkau Quire melalui HTTPS. Periksa log pengiriman langganan di `/admin/webhooks`.

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