---
title: "n8n"
description: "Automatizujte Quire pomocí n8n a komunitního uzlu Quire."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

Komunitní uzel Quire pro n8n nabízí akční uzel pro REST API a spouštěcí uzel, který zahájí workflow při události v Quire. Nemá žádné závislosti za běhu, takže do instance n8n přidává pouze sebe.

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

V n8n otevřete **Settings**, pak **Community nodes**, zvolte **Install** a zadejte `@quire/n8n-node`. V self-hosted n8n můžete místo toho spustit `npm install @quire/n8n-node` ve složce uživatele n8n a službu restartovat.

## Připojení <!--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>

Vytvořte přihlašovací údaj. K dispozici jsou dva druhy:

- **Klíč API Quire**: **Base URL** je adresa vaší organizace bez koncového lomítka, například `https://acme.quirelms.com`. Do **API Key** vložte klíč vytvořený administrátorem na `/admin/integrations/api-keys`, který začíná na `qk_live_`. Přidělte mu pouze rozsahy potřebné pro workflow.
- **Quire OAuth2**: pro workflow jednající jménem konkrétního člověka. Zaregistrujte klienta OAuth na `/admin/integrations/oauth-clients` s přesměrovací adresou n8n (n8n ji zobrazí u přihlašovacího údaje) a zadejte ID klienta, tajný klíč a rozsahy.

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

Uzel **Quire** nabízí uživatele, kurzy, zápisy, skupiny, dokončení, známky, certifikáty, odevzdané práce, pokusy v kvízech, programy, objednávky, e-mail a organizace. Každý prostředek nabízí seznam, načtení, vytvoření, úpravu a smazání podle toho, co umožňuje API, i vložení nebo aktualizaci podle externího ID. To se hodí pro synchronizaci: při druhém spuštění stejného workflow se nic nezdvojí.

Operace se generují z dokumentu OpenAPI Quire, takže přesně odpovídají polím v [referenční dokumentaci API](https://docs.quirelms.com/api/). Každou operaci lze použít také jako nástroj agenta AI v n8n; popis se přebírá z referenční dokumentace API.

Výchozí nastavení vrátí všechny stránky seznamu. U velkých organizací vypněte **Return All** a zadejte limit.

## Spouštěč <!--quire:trigger-->

Přidejte uzel **Quire Trigger**, vyberte přihlašovací údaj a zvolte **Events**: událost podle názvu, například `enrolment.created`, celou oblast, například `course.*`, nebo všechny události. Po aktivaci workflow uzel vytvoří v Quire předplatné webhooku pro adresu n8n; po deaktivaci předplatné odebere.

Před spuštěním workflow se ověřuje podpis každého doručení. Neověřené doručení se zahodí s chybou uzlu, takže podvržený požadavek workflow nespustí. `data` události obsahuje identifikátory; celý záznam načtěte navazujícím uzlem Quire.

## Příklad: uvítací e-mail při zápisu <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** pro `enrolment.created`.
2. Uzel **Quire**, prostředek **Users**, operace **Get**, s ID uživatele `{{$json.data.user_id}}`.
3. Uzel **Quire**, prostředek **Courses**, operace **Get**, s ID kurzu `{{$json.data.course_id}}`.
4. Uzel e-mailu nebo chatu s použitím jména člověka a názvu kurzu.

## Řešení potíží <!--quire:troubleshooting-->

- **401** při každém volání: základní adresa a klíč patří různým organizacím nebo byl klíč odvolán.
- **403** u jedné operace: klíči chybí potřebný rozsah. Přidejte ho na `/admin/integrations/api-keys`.
- Spouštěč se nespustí: adresa webhooku n8n musí být pro Quire dostupná přes HTTPS. Zkontrolujte protokol doručení předplatného na `/admin/webhooks`.

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