n8n | Quire

Quire-ді n8n және Quire қауымдастық түйінімен автоматтандырыңыз.

n8n-ге арналған Quire қауымдастық түйіні REST API-ге арналған әрекет түйінін және Quire-де бірдеңе болғанда жұмыс процесін бастайтын триггер түйінін береді. Оның жұмыс уақыты тәуелділіктері жоқ, сондықтан n8n данаңызға өзінен басқа ештеңе қоспайды.

Орнату

n8n-де Settings ашып, содан кейін Community nodes таңдап, Install таңдап, @quire/n8n-node енгізіңіз. Өз хостингіңіздегі n8n-де оның орнына n8n пайдаланушы қалтасында npm install @quire/n8n-node іске қосып, қайта іске қосуға болады.

Қосылу

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: белгілі бір адам ретінде әрекет етуі керек жұмыс процестеріне арналған. /admin/integrations/oauth-clients мекенжайында n8n қайта бағыттау мекенжайымен OAuth клиентін тіркеңіз (n8n оны тіркелгі дерегінде көрсетеді), содан кейін клиент ID-ін, құпиясын және ауқымдарын енгізіңіз.

Әрекеттер

Quire түйіні пайдаланушыларды, курстарды, жазылуларды, топтарды, аяқтауларды, бағаларды, сертификаттарды, жіберулерді, тест әрекеттерін, бағдарламаларды, тапсырыстарды, пошта мен ұйымдарды қамтиды. Әрқайсысы API ұсынатын жерде тізімдеу, алу, жасау, жаңарту және жоюды ұсынады және сыртқы ID бойынша upsert — синхрондауға керегі осы: сол жұмыс процесін екі рет іске қосыңыз, ештеңе қайталанбайды.

Операциялар Quire OpenAPI құжатынан жасалады, сондықтан олар API анықтамасына өрісбе-өріс сәйкес келеді. Әр операцияны n8n ЖИ агенті құрал ретінде де пайдалана алады; оның сипаттамасы API анықтамасынан келеді.

Тізімдер әдепкі бойынша әр бетті қайтарады. Үлкен ұйымдар үшін Return All өшіріп, шектеу қойыңыз.

Триггер

Quire Trigger түйінін қосып, тіркелгі дерегін таңдап, Events таңдаңыз: аты бойынша оқиға, мысалы enrolment.created, тұтас сала, мысалы course.*, немесе барлығы. Жұмыс процесін іске қосқанда түйін n8n мекенжайына Quire-де вебхук жазылымын жасайды; өшіргенде жазылым жойылады.

Әр жеткізудің қолтаңбасы жұмыс процесі іске қосылмас бұрын тексеріледі. Тексерілмейтін жеткізу түйін қатесімен тасталады, сондықтан жалған сұраныс жұмыс процесіңізді бастай алмайды. Оқиғаның data идентификаторларды алып жүреді; толық жазбаны алу үшін триггерден кейін Quire түйінін қосыңыз.

Мысал: жазылғанда қарсы алу хаты

enrolment.created оқиғасында Quire Trigger.
Пайдаланушы ID-імен {{$json.data.user_id}} Users ресурсы, Get операциясы бар Quire түйіні.
{{$json.data.course_id}} мәнімен Courses ресурсы, Get операциясы бар Quire түйіні.
Адамның аты мен курс атауын пайдаланатын пошта немесе чат түйініңіз.

Ақауларды жою

Әр шақыруда 401: Base URL мен кілт әртүрлі ұйымдарға тиесілі немесе кілт қайтарып алынған.
Бір операцияда 403: кілтте бұл ауқым жоқ. Оны /admin/integrations/api-keys мекенжайында қосыңыз.
Триггер ешқашан іске қосылмайды: n8n вебхук мекенжайы Quire-ден HTTPS арқылы қолжетімді болуы керек. Жазылымның жеткізу журналын /admin/webhooks мекенжайында тексеріңіз.