---
title: "n8n"
description: "Quire-ді n8n және Quire қауымдастық түйінімен автоматтандырыңыз."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

n8n-ге арналған Quire қауымдастық түйіні REST API-ге арналған әрекет түйінін
және Quire-де бірдеңе болғанда жұмыс процесін бастайтын триггер түйінін береді.
Оның жұмыс уақыты тәуелділіктері жоқ, сондықтан n8n данаңызға өзінен басқа
ештеңе қоспайды.

## Орнату <!--quire:install-->

n8n-де **Settings** ашып, содан кейін **Community nodes** таңдап, **Install**
таңдап, `@quire/n8n-node` енгізіңіз. Өз хостингіңіздегі n8n-де оның орнына n8n
пайдаланушы қалтасында `npm install @quire/n8n-node` іске қосып, қайта іске
қосуға болады.

## Қосылу <!--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>

Тіркелгі дерегін жасаңыз. Екі түрі ұсынылады:

- **Quire API Key**: **Base URL** — соңғы қиғаш сызықсыз ұйымыңыздың мекенжайы,
  мысалы `https://acme.quirelms.com`. **API Key** — әкімші `/admin/integrations/api-keys`
  мекенжайында жасаған кілт, `qk_live_` басталады. Оған жұмыс процесіне қажет
  ауқымдарды ғана беріңіз.
- **Quire OAuth2**: белгілі бір адам ретінде әрекет етуі керек жұмыс процестеріне
  арналған. `/admin/integrations/oauth-clients` мекенжайында n8n қайта бағыттау
  мекенжайымен OAuth клиентін тіркеңіз (n8n оны тіркелгі дерегінде көрсетеді), содан
  кейін клиент ID-ін, құпиясын және ауқымдарын енгізіңіз.

## Әрекеттер <!--quire:actions-->

**Quire** түйіні пайдаланушыларды, курстарды, жазылуларды, топтарды, аяқтауларды,
бағаларды, сертификаттарды, жіберулерді, тест әрекеттерін, бағдарламаларды, тапсырыстарды,
пошта мен ұйымдарды қамтиды. Әрқайсысы API ұсынатын жерде тізімдеу, алу, жасау,
жаңарту және жоюды ұсынады және сыртқы ID бойынша upsert — синхрондауға керегі осы:
сол жұмыс процесін екі рет іске қосыңыз, ештеңе қайталанбайды.

Операциялар Quire OpenAPI құжатынан жасалады, сондықтан олар [API анықтамасына](https://docs.quirelms.com/api/)
өрісбе-өріс сәйкес келеді. Әр операцияны n8n ЖИ агенті құрал ретінде де пайдалана
алады; оның сипаттамасы API анықтамасынан келеді.

Тізімдер әдепкі бойынша әр бетті қайтарады. Үлкен ұйымдар үшін **Return All** өшіріп,
шектеу қойыңыз.

## Триггер <!--quire:trigger-->

**Quire Trigger** түйінін қосып, тіркелгі дерегін таңдап, **Events** таңдаңыз:
аты бойынша оқиға, мысалы `enrolment.created`, тұтас сала, мысалы `course.*`,
немесе барлығы. Жұмыс процесін іске қосқанда түйін n8n мекенжайына Quire-де вебхук
жазылымын жасайды; өшіргенде жазылым жойылады.

Әр жеткізудің қолтаңбасы жұмыс процесі іске қосылмас бұрын тексеріледі. Тексерілмейтін
жеткізу түйін қатесімен тасталады, сондықтан жалған сұраныс жұмыс
процесіңізді бастай алмайды. Оқиғаның `data` идентификаторларды алып жүреді; толық
жазбаны алу үшін триггерден кейін Quire түйінін қосыңыз.

## Мысал: жазылғанда қарсы алу хаты <!--quire:example-welcome-email-on-enrolment-->

1. `enrolment.created` оқиғасында **Quire Trigger**.
2. Пайдаланушы ID-імен `{{$json.data.user_id}}` **Users** ресурсы, **Get** операциясы бар
   **Quire** түйіні.
3. `{{$json.data.course_id}}` мәнімен **Courses** ресурсы, **Get** операциясы бар
   **Quire** түйіні.
4. Адамның аты мен курс атауын пайдаланатын пошта немесе чат түйініңіз.

## Ақауларды жою <!--quire:troubleshooting-->

- Әр шақыруда **401**: Base URL мен кілт әртүрлі ұйымдарға тиесілі немесе кілт
  қайтарып алынған.
- Бір операцияда **403**: кілтте бұл ауқым жоқ. Оны
  `/admin/integrations/api-keys` мекенжайында қосыңыз.
- Триггер ешқашан іске қосылмайды: n8n вебхук мекенжайы Quire-ден HTTPS арқылы
  қолжетімді болуы керек. Жазылымның жеткізу журналын `/admin/webhooks`
  мекенжайында тексеріңіз.

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