n8n

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

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í

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

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

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

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íží

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