---
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/bg/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 отворете **Settings**, после **Community nodes**, изберете **Install** и въведете `@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>

Създайте удостоверение. Предлагат се два вида:

- **Quire API Key**: **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 го позволява, както и upsert по външен ID — подходящо за синхронизация: повторното изпълнение на работния поток не дублира нищо.

Операциите се генерират от OpenAPI документа на Quire и съвпадат поле по поле със [справочника за API](https://docs.quirelms.com/api/). Всяка може да се използва и като инструмент за ИИ агент в n8n; описанието ѝ идва от справочника.

По подразбиране списъците връщат всяка страница. За големи организации изключете **Return All** и задайте лимит.

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

Добавете възела **Quire Trigger**, изберете удостоверението и посочете **Events**: събитие по име като `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/bg/integrations/n8n/index.mdx