n8n

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

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

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

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. 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

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

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

• 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.