n8n

n8n-ի Quire համայնքային հանգույցը տրամադրում է REST API-ի գործողության հանգույց և գործարկիչ հանգույց, որը մեկնարկում է աշխատանքային հոսքը, երբ Quire-ում ինչ-որ բան է տեղի ունենում։ Այն չունի գործարկման կախվածություններ, ուստի ձեր n8n օրինակին իրենից բացի ոչինչ չի ավելացնում։

Տեղադրել

n8n-ում բացեք Կարգավորումներ, ապա՝ Համայնքային հանգույցներ, ընտրեք Տեղադրել և մուտքագրեք @quire/n8n-node։ Ինքնուրույն հոսթավորված n8n-ի դեպքում կարող եք n8n օգտատիրոջ թղթապանակում գործարկել npm install @quire/n8n-node հրամանը և վերագործարկել։

Միանալ

Ստեղծեք հավատարմագիր։ Առաջարկվում է երկու տեսակ․

• Quire API բանալի․ Հիմնական URL-ը ձեր կազմակերպության հասցեն է՝ առանց վերջում շեղագծի, օրինակ՝ https://acme.quirelms.com։ API բանալին այն բանալին է, որը ադմինիստրատորը ստեղծել է /admin/integrations/api-keys էջում և սկսվում է qk_live_-ով։ Տվեք միայն աշխատանքային հոսքին անհրաժեշտ շրջանակները։
• Quire OAuth2․ աշխատանքային հոսքերի համար, որոնք պետք է գործեն կոնկրետ անձի անունից։ Գրանցեք OAuth հաճախորդ /admin/integrations/oauth-clients էջում՝ նշելով n8n-ի վերուղղման հասցեն (n8n-ը այն ցուցադրում է հավատարմագրի էջում), ապա մուտքագրեք հաճախորդի ID-ն, գաղտնի բանալին և շրջանակները։

Գործողություններ

Quire հանգույցն ընդգրկում է օգտատերեր, դասընթացներ, գրանցումներ, խմբեր, ավարտումներ, գնահատականներ, վկայականներ, աշխատանքների ներկայացումներ, թեստի փորձեր, ծրագրեր, պատվերներ, էլ․ փոստ և կազմակերպություններ։ Յուրաքանչյուրի համար հասանելի են ցանկում, ստանալ, ստեղծել, թարմացնել և ջնջել գործողությունները՝ եթե դրանք տրամադրում է API-ն, ինչպես նաև արտաքին ID-ով ավելացում կամ թարմացում։ Սա համաժամեցման համար պետք եղած տարբերակն է․ նույն աշխատանքային հոսքը երկու անգամ գործարկելիս կրկնօրինակներ չեն ստեղծվում։

Գործողությունները գեներացվում են Quire-ի OpenAPI փաստաթղթից, ուստի դաշտերով համապատասխանում են API-ի տեղեկատուին։ Յուրաքանչյուր գործողություն կարելի է օգտագործել նաև որպես գործիք n8n ԱԲ գործակալի համար․ նկարագրությունը վերցվում է API-ի տեղեկատուից։

Ցանկերը լռելյայն վերադարձնում են բոլոր էջերը։ Մեծ կազմակերպությունների համար անջատեք Վերադարձնել բոլորը և սահմանեք սահմանաչափ։

Գործարկիչ

Ավելացրեք Quire Trigger հանգույցը, ընտրեք հավատարմագիրը և նշեք Իրադարձությունները․ առանձին իրադարձություն, օրինակ՝ enrolment.created, ամբողջ բաժին, օրինակ՝ course.*, կամ բոլորը։ Աշխատանքային հոսքն ակտիվացնելիս հանգույցը Quire-ում n8n-ի հասցեի համար ստեղծում է վեբհուքի բաժանորդագրություն, իսկ ապաակտիվացնելիս հեռացնում է այն։

Մինչև աշխատանքային հոսքի գործարկվելը ստուգվում է յուրաքանչյուր առաքման ստորագրությունը։ Չհաստատվող առաքումը մերժվում է՝ հանգույցի սխալով, ուստի կեղծված հարցումը չի կարող մեկնարկել ձեր աշխատանքային հոսքը։ Իրադարձության data-ն պարունակում է նույնացուցիչներ․ ամբողջական գրառումը ստանալու համար գործարկիչից հետո ավելացրեք Quire հանգույց։

Օրինակ․ ողջույնի նամակ՝ գրանցվելիս

1. Quire Trigger՝ enrolment.created իրադարձությամբ։
2. Quire հանգույց՝ ռեսուրս Օգտատերեր, գործողություն Ստանալ, օգտատիրոջ ID-ն՝ {{$json.data.user_id}}։
3. Quire հանգույց՝ ռեսուրս Դասընթացներ, գործողություն Ստանալ, {{$json.data.course_id}} արժեքով։
4. Ձեր էլ․ փոստի կամ չաթի հանգույցը՝ օգտագործելով անձի անունը և դասընթացի վերնագիրը։

Խնդիրների լուծում

• Յուրաքանչյուր հարցման դեպքում 401․ հիմնական URL-ն ու բանալին տարբեր կազմակերպությունների են պատկանում, կամ բանալին չեղարկվել է։
• Մեկ գործողության դեպքում 403․ բանալին չունի անհրաժեշտ շրջանակը։ Ավելացրեք այն /admin/integrations/api-keys էջում։
• Գործարկիչը չի աշխատում․ n8n-ի վեբհուքի հասցեն պետք է հասանելի լինի Quire-ից՝ HTTPS-ով։ Ստուգեք բաժանորդագրության առաքման մատյանը /admin/webhooks էջում։