---
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/mk/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

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

Заедничкиот јазол Quire за n8n ви дава јазол за дејство за REST API и јазол-спустач што започнува проток на работа кога нешто се случува во Quire. Нема зависности во извршувањето, така што не додава ништо на вашата n8n-инстанца освен него самиот.

## Инсталирање <!--quire:install-->

Во n8n отворете **Поставки**, потоа **Заеднички јазоли**, изберете **Инсталирај** и внесете `@quire/n8n-node`. На самодржен n8n наместо тоа можете да ја извршите командата `npm install @quire/n8n-node` во корисничката папка на n8n и да го рестартирате.

## Поврзување <!--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>

Создадете потврда. Се нудат два вида:

- **Клуч за API на Quire**: **Base URL** е адресата на вашата организација без завршна црта, како `https://acme.quirelms.com`. **API Key** е клуч што администратор го создал на `/admin/integrations/api-keys`, што започнува со `qk_live_`. Дајте му само опсези што протокот на работа ги бара.
- **Quire OAuth2**: за протоци на работа што треба да дејствуваат во име на одредено лице. Регистрирајте OAuth-клиент на `/admin/integrations/oauth-clients` со адресата за преусмерување на n8n (n8n ја прикажува на потврдата), па внесете го ID-то на клиентот, тајната и опсезите.

## Дејства <!--quire:actions-->

Јазолот **Quire** ги опфаќа корисниците, курсевите, запишувањата, групите, завршувањата, оценките, сертификатите, предавањата, обидите од тест, програмите, нарачките, е-поштата и организациите. Секој нуди листање, земање, креирање, ажурирање и бришење таму каде што API-то го нуди, и вметнување или ажурирање по надворешен ID, што е она што го сакате за синхронизација: пуштете го истиот проток двапати и ништо не се дуплира.

Операциите се генерирани од OpenAPI-документот на Quire, така што се совпаѓаат со [референцата за API](https://docs.quirelms.com/api/) поле по поле. Секоја операција може исто така да се користи како алатка од AI-агентот на n8n; нејзиниот опис доаѓа од референцата за API.

Списоците ја враќаат секоја страница по стандард. Исклучете **Врати ги сите** и поставете лимит за големи организации.

## Спустач <!--quire:trigger-->

Додајте го јазолот **Quire Trigger**, изберете ја потврдата и изберете ги **Настаните**: настан по име како `enrolment.created`, цела област како `course.*` или сè. Кога ќе ја активирате работата, јазолот создава претплата на веб-кука во Quire за адресата на n8n; кога ќе ја деактивирате, претплатата се отстранува.

Потписот на секоја испорака се проверува пред да се изврши протокот. Испорака што не поминува во проверка се отфрла со грешка на јазолот, така што фалсификувано барање не може да го стартува вашиот проток. `data` на настанот носи идентификатори; додајте Quire-јазол по спустачот за да го повлечете целиот запис.

## Пример: порака за добредојде при запишување <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** на `enrolment.created`.
2. **Quire** јазол, ресурс **Users**, операција **Get**, со ID-то на корисникот `{{$json.data.user_id}}`.
3. **Quire** јазол, ресурс **Courses**, операција **Get**, со `{{$json.data.course_id}}`.
4. Вашиот јазол за е-пошта или разговор, со името на лицето и насловот на курсот.

## Решавање проблеми <!--quire:troubleshooting-->

- **401** на секој повик: Base URL и клучот припаѓаат на различни организации или клучот бил повлечен.
- **403** на една операција: клучот го нема тој опсег. Додајте го на `/admin/integrations/api-keys`.
- Спустачот никогаш не се активира: адресата на веб-кука на n8n мора да биде достапна од Quire преку HTTPS. Проверете го дневникот за испорака на претплатата на `/admin/webhooks`.

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