n8n

Quire-ის საზოგადოების კვანძი n8n-ისთვის გაძლევთ მოქმედების კვანძს REST API-ისთვის და ტრიგერის კვანძს, რომელიც სამუშაო პროცესს იწყებს, როცა Quire-ში რაღაც ხდება. მას არ აქვს გაშვების დროის დამოკიდებულებები, ამიტომ ის თქვენს n8n ინსტანსს არაფერს უმატებს თავის გარდა.

ინსტალაცია

n8n-ში გახსენით პარამეტრები, შემდეგ საზოგადოების კვანძები, აირჩიეთ ინსტალაცია და შეიყვანეთ @quire/n8n-node. თვითმართვად n8n-ზე ამის ნაცვლად შეგიძლიათ გაუშვათ npm install @quire/n8n-node n8n-ის მომხმარებლის საქაღალდეში და გადატვირთოთ.

შეერთება

შექმენით რწმუნებათა სიგელი. ორი სახეობაა შეთავაზებული:

• 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 AI აგენტის მიერ; მისი აღწერა API-ის ცნობრიდან მოდის.

სიები ნაგულისხმევად ყველა გვერდს აბრუნებენ. გამორთეთ ყველას დაბრუნება და დააყენეთ ლიმიტი დიდი ორგანიზაციებისთვის.

ტრიგერი

დაამატეთ Quire ტრიგერის კვანძი, აირჩიეთ რწმუნებათა სიგელი და აირჩიეთ მოვლენები: მოვლენა სახელით, როგორიცაა enrolment.created, მთელი არე, როგორიცაა course.*, ან ყველაფერი. სამუშაო პროცესის გააქტიურებისას კვანძი ქმნის ვებჰუკის გამოწერას Quire-ში n8n-ის მისამართისთვის; მისი დეაქტივაციისას გამოწერა იშლება.

თითოეული მიწოდების ხელმოწერა მოწმდება სამუშაო პროცესის გაშვებამდე. მიწოდება, რომელიც ვერ დასტურდება, კვანძის შეცდომით იშლება, ასე რომ გაყალბებული მოთხოვნა ვერ დაიწყებს თქვენს სამუშაო პროცესს. მოვლენის data ატარებს იდენტიფიკატორებს; დაამატეთ Quire კვანძი ტრიგერის შემდეგ სრული ჩანაწერის ასაღებად.

მაგალითი: მისალმების ელფოსტა ჩარიცხვაზე

1. Quire ტრიგერი 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-ში.