n8n

ថ្នាំងសហគមន៍ Quire សម្រាប់ n8n ផ្តល់ឱ្យអ្នកនូវថ្នាំងសកម្មភាពសម្រាប់ REST API និងថ្នាំងទ្រូហ្វិកដែលចាប់ផ្តើមលំហូរការងារនៅពេលមានអ្វីកើតឡើងក្នុង Quire។ វាគ្មានការពឹងផ្អែកលើការរត់ទេ ដូច្នេះវាមិនបន្ថែមអ្វីលើការដំឡើង n8n របស់អ្នកក្រៅពីវាផ្ទាល់ទេ។

ការដំឡើង

ក្នុង n8n បើក ការកំណត់ រួចថ្នាំងសហគមន៍ ជ្រើសរើស ដំឡើង ហើយបញ្ចូល @quire/n8n-node។ លើ n8n self-hosted អ្នកជំនួសអាចដំណើរការ npm install @quire/n8n-node ក្នុងថតអ្នកប្រើ n8n រួចចាប់ផ្តើមឡើងវិញ។

ការតភ្ជាប់

បង្កើតលិខិតសម្គាល់មួយ។ ពីរប្រភេទត្រូវបានផ្តល់៖

• សោ API របស់ Quire៖ Base URL ជាអាសយដ្ឋានអង្គការរបស់អ្នកដោយគ្មានសញ្ញាចុងក្រោយ ដូចជា https://acme.quirelms.com។ API Key ជាសោដែលអ្នកគ្រប់គ្រងបានបង្កើតនៅ /admin/integrations/api-keys ចាប់ផ្តើមដោយ qk_live_។ ផ្តល់ឱ្យវាតែវិស័យដែលលំហូរការងារត្រូវការប៉ុណ្ណោះ។
• Quire OAuth2៖ សម្រាប់លំហូរការងារដែលគួរធ្វើសកម្មភាពដូចជាមនុស្សជាក់លាក់។ ចុះឈ្មោះអតិថិជន OAuth មួយនៅ /admin/integrations/oauth-clients ជាមួយអាសយដ្ឋានត្រឡប់របស់ n8n (n8n បង្ហាញវាលើលិខិតសម្គាល់) រួចបញ្ចូល client ID សំណង់ និងវិស័យ។

សកម្មភាព

ថ្នាំង Quire គ្របដណ្តប់លើអ្នកប្រើ វគ្គសិក្សា ការចុះឈ្មោះ ក្រុម ការបញ្ចប់ ពិន្ទុ វិញ្ញាបនបត្រ ការដាក់ស្នើ ការសាកល្បងសំណួរ កម្មវិធី ការបញ្ជាទិញ អ៊ីមែល និងអង្គការ។ នីមួយៗផ្តល់បញ្ជី ទទួល បង្កើត កែ និងលុប នៅពេល API ផ្តល់ ហើយ upsert តាម ID ក្រៅ ដែលជាអ្វីដែលអ្នកចង់បានសម្រាប់ការសមកាលកម្ម៖ ដំណើរការលំហូរការងារដដែលពីរដង ហើយគ្មានអ្វីត្រូវបានធ្វើឡើងពីរដង។

ប្រតិបត្តិកម្មត្រូវបានបង្កើតពីឯកសារ OpenAPI របស់ Quire ដូច្នេះពួកវាផ្គូផ្គងឯកសារយោង APIវាលមួយទៅមួយវាល។ ប្រតិបត្តិកម្មនីមួយៗក៏អាចប្រើជាឧបករណ៍ដោយភ្នាក់ងារ AI របស់ n8n ផង។ សេចក្តីពិពណ៌នាមកពីឯកសារយោង API។

បញ្ជីត្រឡប់ទំព័រទាំងអស់តាមលំនាំដើម។ បិត ត្រឡប់ទាំងអស់ រួចកំណត់កម្រិតសម្រាប់អង្គការធំ។

ទ្រូហ្វិក

បន្ថែមថ្នាំង ទ្រូហ្វិក Quire ជ្រើសលិខិតសម្គាល់ រួចជ្រើស ព្រឹត្តិការណ៍៖ ព្រឹត្តិការណ៍តាមឈ្មោះដូចជា enrolment.created ផ្នែកទាំងមួយដូចជា course.* ឬអ្វីៗទាំងអស់។ នៅពេលអ្នកធ្វើឱ្យលំហូរការងារចូលជាធរមាន ថ្នាំងបង្កើតការចុះឈ្មោះ webhook ក្នុង Quire សម្រាប់អាសយដ្ឋានរបស់ n8n នៅពេលអ្នកធ្វើឱ្យវាឈប់ ការចុះឈ្មោះត្រូវបានយកចេញ។

ហត្ថលេខានៃការផ្ញើនីមួយៗត្រូវបានពិនិត្យមុននឹងលំហូរការងារដំណើរការ។ ការផ្ញើដែលមិនផ្ទៀងផ្ទាត់ត្រូវបានទម្លាក់ជាមួយកំហុសថ្នាំង ដូច្នេះសំណើដែលក្លែងបន្លំមិនអាចចាប់ផ្តើមលំហូរការងាររបស់អ្នកបានទេ។ data របស់ព្រឹត្តិការណ៍ផ្ទុកអត្តសញ្ញាណ បន្ថែមថ្នាំង Quire បន្ទាប់ពីទ្រូហ្វិកដើម្បីទាញយកកំណត់ត្រាពេញ។

ឧទាហរណ៍៖ អ៊ីមែលស្វាគមន៍នៅពេលចុះឈ្មោះ

1. ទ្រូហ្វិក Quire លើ enrolment.created។
2. ថ្នាំង Quire ធនធាន អ្នកប្រើ ប្រតិបត្តិកម្ម ទទួល ជាមួយ ID អ្នកប្រើ {{$json.data.user_id}}។
3. ថ្នាំង Quire ធនធាន វគ្គសិក្សា ប្រតិបត្តិកម្ម ទទួល ជាមួយ {{$json.data.course_id}}។
4. ថ្នាំងអ៊ីមែល ឬការជជែករបស់អ្នក ប្រើឈ្មោះមនុស្ស និងចំណងជើងវគ្គសិក្សា។

ការដោះស្រាយបញ្ហា

• 401 លើការហៅទាំងអស់៖ Base URL និងសោស្ថិតក្នុងអង្គការខុសៗគ្នា ឬសោត្រូវបានដក។
• 403 លើប្រតិបត្តិកម្មមួយ៖ សោខ្វះវិស័យនោះ។ បន្ថែមវានៅ /admin/integrations/api-keys។
• ទ្រូហ្វិកមិនដែលបង្កើតទេ៖ អាសយដ្ឋាន webhook របស់ n8n ត្រូវតែអាចឈានដល់បានពី Quire តាម HTTPS។ ពិនិត្យកំណត់ត្រាការផ្ញើនៃការចុះឈ្មោះនៅ /admin/webhooks។