n8n-д зориулсан Quire-н нийтийн node нь REST API-д зориулсан үйлдлийн node, мөн Quire дээр юу нэгэн зүйл болоход урсгал эхлүүлдэг триггерийн node өгдөг. Үүнд ажиллагааны хамаарал байхгүй тул та өөрийн n8n instance-д зөвхөн өөрөө нь нэмэгдэнэ.
Суулгах
n8n дээр Тохиргоо нээгээд, дараа нь Нийтийн node-ууд руу орж, Суулгах-ыг сонгоод @quire/n8n-node оруулна уу. Өөрийн сервер дээрх n8n дээр та оронд нь n8n хэрэглэгчийн хавтас дээр npm install @quire/n8n-node ажиллуулаад дахин ачаалж болно.
Холболт
Итгэмжлэл үүсгэнэ үү. Хоёр төрөл санал болгогддог:
- Quire API түлхүүр: Base URL нь таны байгууллагын хаяг бөгөөд эцэст нь слэшгүй, жишээ нь
https://acme.quirelms.com. API түлхүүр нь администратор/admin/integrations/api-keysдээр үүсгэсэн,qk_live_-оор эхэлдэг түлхүүр юм. Зөвхөн урсгалд хэрэгтэй эрхүүдийг өгнө үү. - Quire OAuth2: тодорхой хүний нэрийн өмнөөс ажиллах ёстой урсгалуудад.
/admin/integrations/oauth-clientsдээр n8n-ийн чиглүүлэх хаягийн хамт OAuth клиент бүртгээд (n8n үүнийг итгэмжлэл дээр харуулдаг), дараа нь клиентийн ID, нууц, эрхүүдийг оруулна уу.
Үйлдлүүд
Quire node нь хэрэглэгч, сургалт, элсэлт, бүлэг, дуусалт, дүн, гэрчилгээ, илгээлт, шалгалтын оролдлого, хөтөлбөр, захиалга, имэйл, байгууллагуудыг хамрана. Бүр нь API боломжтой газартаа list, get, create, update, delete санал болгох бөгөөд мөн гадаад ID-гаар upsert хийдэг — энэ нь синхрончилолд хэрэгтэй зүйл юм: ижил урсгалыг хоёр удаа ажиллуулсан ч юуг ч давхардуулахгүй.
Үйлдлүүд нь Quire-н OpenAPI баримт бичгээс үүсгэгддэг тул API-н гарын авлага-тай тал бүрээр таарна. Бүх үйлдлийг n8n AI agent хэрэгсэл болгон ч мөн ашиглах боломжтой; түүний тайлбар API-н гарын авлагаас авдаг.
Жагсаалтууд өгөгдсөнөөр бүх хуудсыг буцаана. Их байгууллагуудын хувьд Бүгдийг буцаах-ыг унтраагаад хязгаар тогтооно уу.
Триггер
Quire Trigger node нэмээд, итгэмжлэлээ сонгоод, Үйл явдлууд-ыг сонгоно уу: нэрээрээ үйл явдал жишээ нь enrolment.created, бүтэн хэсэг жишээ нь course.*, эсвэл бүгд. Та урсгалыг идэвхжүүлэхэд node нь n8n-ийн хаягийн тулд Quire дээр вебхүүкийн захиалга үүсгэдэг; унтраахад захиалга арилгагдана.
Хүргэлт бүрийн гарын үсгийг урсгал ажиллахаас өмнө шалгадаг. Шалгалт өнгөрөөгүй хүргэлтийг node-ийн алдаатайгаар унагадаг тул хуурамч хүсэлт таны урсгалыг эхлүүлж чадахгүй. Үйл явдлын data нь идентификаторууд агуулдаг; бүрэн бүртгэлийг авахын тулд триггерийн дараа Quire node нэмнэ үү.
Жишээ: элсэлт дээр мэндчилгээний имэйл
- Quire Trigger нь
enrolment.createdдээр. - Quire node, нөөц Хэрэглэгчид, үйлдэл Авах, хэрэглэгчийн ID
{{$json.data.user_id}}-тэй. - Quire node, нөөц Сургалтууд, үйлдэл Авах,
{{$json.data.course_id}}-тэй. - Таны имэйл эсвэл чат node — хүний нэр, сургалтын гарчиг ашигласан.
Алдаа шийдвэрлэх
- 401 бүх дуудлагад: Base URL болон түлхүүр өөр байгууллаганд хамаарах, эсвэл түлхүүр цуцлагдсан.
- 403 нэг үйлдэл дээр: түлхүүрт тэр эрх дутагдаж байна.
/admin/integrations/api-keysдээр нэмнэ үү. - Триггер хэзээ ч дуудагдахгүй: n8n-ийн вебхүүкийн хаяг нь Quire-ээс HTTPS ашиглан хүртээмжтэй байх ёстой.
/admin/webhooksдээр захиалгын хүргэлтийн логийг шалгана уу.