n8n | Quire

Аўтаматызуйце Quire праз n8n і вузел Quire ад супольнасці.

Вузел супольнасці Quire для n8n дае вузел дзеянняў для REST API і вузел трыгера, які запускае працоўны працэс, калі ў Quire нешта адбываецца. У яго няма залежнасцей выканання, таму ён дадае да вашага n8n толькі сябе.

Усталяванне

У n8n адкрыйце Settings, затым Community nodes, выберыце Install і ўвядзіце @quire/n8n-node. Калі n8n размешчаны самастойна, можна таксама выканаць npm install @quire/n8n-node у тэчцы карыстальніка n8n і перазапусціць яго.

Падключэнне

The API keys page with a key named for an n8n automation. — Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.

Стварыце ўліковыя даныя. Даступны два віды:

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 (ён паказаны ў даных уліковага запісу), затым увядзіце ID кліента, сакрэт і вобласці доступу.

Дзеянні

Вузел Quire працуе з карыстальнікамі, курсамі, залічэннямі, групамі, завяршэннямі, ацэнкамі, сертыфікатамі, здадзенымі работамі, спробамі тэстаў, праграмамі, заказамі, электроннай поштай і арганізацыямі. Для кожнага рэсурсу ён прапануе спіс, атрыманне, стварэнне, абнаўленне і выдаленне, калі гэта падтрымлівае API, а таксама upsert паводле знешняга ID. Гэта падыходзіць для сінхранізацыі: паўторны запуск таго ж працоўнага працэсу не стварае дублікатаў.

Аперацыі генеруюцца з дакумента OpenAPI Quire, таму яны дакладна адпавядаюць даведцы API. Кожную аперацыю можна таксама выкарыстоўваць як інструмент ШІ-агента n8n; апісанне бярэцца з даведкі API.

Па змаўчанні спісы вяртаюць усе старонкі. Для вялікіх арганізацый выключыце Return All і задайце ліміт.

Трыгер

Дадайце вузел Quire Trigger, выберыце ўліковыя даныя і Events: асобную падзею, напрыклад enrolment.created, цэлы раздзел кшталту course.* або ўсе падзеі. Пры актывацыі працоўнага працэсу вузел стварае ў Quire падпіску на вэбхук з адрасам n8n; пры дэактывацыі падпіска выдаляецца.

Перад запускам працоўнага працэсу правяраецца подпіс кожнай дастаўкі. Неправераная дастаўка адхіляецца з памылкай вузла, таму падроблены запыт не можа запусціць ваш працоўны працэс. Поле data падзеі змяшчае ідэнтыфікатары; дадайце пасля трыгера вузел Quire, каб атрымаць поўны запіс.

Прыклад: прывітальны ліст пасля залічэння

Трыгер Quire Trigger на enrolment.created.
Вузел Quire, рэсурс Users, аперацыя Get, ID карыстальніка {{$json.data.user_id}}.
Вузел Quire, рэсурс Courses, аперацыя Get, ID курса {{$json.data.course_id}}.
Ваш вузел электроннай пошты або чата з імем чалавека і назвай курса.

Дыягностыка праблем

401 пры кожным выкліку: базавы URL і ключ належаць розным арганізацыям або ключ быў адкліканы.
403 для адной аперацыі: ключ не мае патрэбнай вобласці доступу. Дадайце яе ў /admin/integrations/api-keys.
Трыгер не запускаецца: адрас вэбхукаў n8n павінен быць даступны з Quire праз HTTPS. Праверце журнал даставак падпіскі ў /admin/webhooks.