الربط مع زووم Zoom
نشرح في هذا الدليل كيفية ربط منصتك التعليمية مع تطبيق Zoom والذي سيساعدك في تعزيز وتطوير التجارب التعليمية وتحسين التفاعل في المنصة عبر إضافة الجلسات واللقاءات المباشرة والمحاضرات الافتراضية الحية وعقد الاجتماعات وغيرها الكثير.
يمكنك مشاهدة الفيديو التالي لمعرفة طريقة تثبيت تطبيق Zoom وربطه بمنصتك
إليك خطوات الربط مع زوم بالتفصيل، من المهم اتباعها بدقة حتى يتم الربط بصورة صحيحة:
الذهاب إلى سوق تطبيقات Zoom
الآن يمكنك تسجيل الدخول إلى حسابك في Zoom. في حال لم يكن لديك حساب على زووم، يجب إنشاء واحد جديد من خلال الضغط على "إنشاء حساب Sign Up"
تنويه: لا تحتاج إلى الاشتراك في باقات زوم حتى يتم الربط.
الضغط على القائمة المنسدلة «Develop»، ثم الضغط على خيار «Build Server-to-Server App» من القائمة
ستظهر بعدها نافذة منبثقة تطلب منك الموافقة على شروط الاستخدام والأحكام.
وضع «اسم المنصةApp Name» ثم الضغط على «إنشاء Create»
تنتقل الآن إلى صفحة التفعيل والبيانات الخاصة بالتطبيق الذي أنشئته
توجّه إلى لوحة التحكم في منصتك التعليمية واختر "سوق التطبيقات" من القائمة الجانبية
ابحث على تطبيق Zoom واضغط على زر "تثبيت التطبيق"
تظهر الآن حقول ملئ بيانات يجب إكمالها
- في حقل "نوع التطبيق" اختر «Server-to-Server OAuth»
- انسخ مفاتيح Account ID وClient ID وClient Secret من صفحة App Credentials التي فعّلتها في سوق تطبيقات Zoom وألصقهم في الحقول المناسبة
- إضافة "Webhook Secret Token " من صفحة "Feature" في تطبيق S2S الذي أنشئناه في سوق تطبيقات زووم
- الضغط على "تثبيت التطبيق" في المنصة لاستكمال خطوات الربط الأخرى
تنتقل الآن إلى صفحة «المعلومات Information» في صفحة التطبيق الذي أنشأته
- اكتب اسم منصتك التعليمية
- اكتب وصف عن التطبيق أو المنصة
- أدخل اسم الشركة
- أدخِل اسمك وبريدك الإلكتروني في مكانهما المخصصين والذين سيتواصل عبرهما منصة زووم لإعلامك بالتحديثات والإشعارات بشأن التطبيق
- أخيرًا، اضغط «متابعة Continue» أسفل الصفحة
ستنتقل إلى صفحة «سكوبس Scopes». اضغط على «Add Scopes».
والمقصود بالـ«سكوبس Scopes» هي الصلاحيات التي يمكن الوصول إليها من قبل التطبيق. يجب التأكد من تحديد الخيارات التالية:
نصائح المحترفين: يمكنك نسخ كل صلاحية من الصلاحيات التي في القائمة والبحث عنها وتحديدها بدلاً من إيجادها بشكل يدوي
- meeting:read:meeting:admin
- meeting:update:meeting:admin
- meeting:delete:meeting:admin
- meeting:write:meeting:admin
- meeting:write:invite_links:admin
- meeting:read:meeting:master
- cloud_recording:read:list_recording_files:admin
- cloud_recording:read:list_account_recordings:admin
- cloud_recording:read:list_user_recordings:admin
- report:read:meeting:admin
- report:read:webinar:admin
- report:read:upcoming_meetings_webinars:admin
- report:read:cloud_recording:admin
- report:read:user:admin
- user:read:list_users:admin
- user:read:token:admin
- user:read:settings:admin
- user:read:user:admin
- webinar:read:list_webinars:admin
- webinar:read:webinar:admin
- webinar:update:webinar:admin
- webinar:write:invite_links:admin
- webinar:delete:webinar:admin
- webinar:write:webinar:admin
- webinar:read:webinar:master
يجب عليك الآن تفعيل أحداث "Webhooks " من صفحة "Feature" في تطبيق S2S الذي أنشئناه في سوق تطبيقات زووم، والمقصود بالـ "Webhooks" هي أحداث تقنية ينفذها التطبيق لتزويد تطبيقات أخرى بمعلومات/بيانات عند حدوثها بشكل مباشر. مثلًا في حالة تطبيق زووم، ستحصل على تنبيهات عندما يبدأ اللقاءات الافتراضية، لتساعدك في تحسين وتطوير تجارب المستخدم في منصتك.
الذهاب إلى تبويب "Feature" في تطبيق S2S في سوق تطبيقات زووم
تفعيل "Event Subscriptions"
الضغط على "Add Event Subscription"
سيُطلب منك ملئ حقول البيانات وتحديد طريقة جلب البيانات، اختر "Webhook"
في حقل "Event notification endpoint URL"، سيطلب منك إدخال الرابط الذي ستُرسل إليه التنبيهات والأحداث
أدخِل الرابط التالي في هذا الحقل:
https://api.msaaq.com/apps/zoom/webhook
الآن عليك إنشاء "Header" عن طريق الضغط على "Authentication Header Option" ثم اختيار "Custom Header"
يجب عليك بعد ذلك ملء بيانات الحقول، ففي "Header Key" ضع "academy"، وفي "Header Value" ضع رابط منصتك التعليمية.
عند إضافة قيمة "Header Value" يجب التأكد من أن رابط المنصة لا يحتوي على أي لواحق زائدة مثل Https
يجب عليك الآن إنشاء عدة "أحداث Events" عبر الضغط على "Add Event" في نفس الصفحة
ثم بعد ذلك عليك تفعيل الأحداث التالية:
- Start Meeting
- End Meeting
- Meeting has been created
- Meeting has been updated
- Meeting has been deleted
- Start Webinar
- End Webinar
- Webinar has been created
- Webinar has been updated
- Webinar has been deleted
- All Recordings have completed
ثم الضغط على "Done"
ثم الضغط على "Save".
سيظهر لك الآن إشعار يفيد بأن الأحداث المُنشأة "Webhook" يحتاج إلى تأكيد. اضغط على علامة "التعديل" ثم في شاشة بيانات الحدث نضغط على "Validate"
ستنتقل إلى «Activation»، اضغط على «Activate your app» لإكمال تفعيل التطبيق في سوق تطبيقات Zoom
بعد ذلك ستظهر لك شاشة تشير إلى إتمام عملية التفعيل والربط
الآن تم ربط تطبيق Zoom في منصتك بشكل كامل، وتستطيع إضافة دروس افتراضية عبر منصة زووم بكل سهولة.
دليل إضافة الدروس والمواد التعليمية إلى الدورات التدريبية.
كيفية إضافة درس أو اجتماع Zoom
يمكنك مشاهدة الفيديو التالي لمعرفة طريقة تثبيت تطبيق Zoom وربطه بمنصتك
ربط Zoom مع منصتك التعليمية
إليك خطوات الربط مع زوم بالتفصيل، من المهم اتباعها بدقة حتى يتم الربط بصورة صحيحة:
1. إنشاء تطبيق في Zoom وخطوات تفعيل مفاتيح الربط
الذهاب إلى سوق تطبيقات Zoom
الآن يمكنك تسجيل الدخول إلى حسابك في Zoom. في حال لم يكن لديك حساب على زووم، يجب إنشاء واحد جديد من خلال الضغط على "إنشاء حساب Sign Up"
تنويه: لا تحتاج إلى الاشتراك في باقات زوم حتى يتم الربط.
الضغط على القائمة المنسدلة «Develop»، ثم الضغط على خيار «Build Server-to-Server App» من القائمة
ستظهر بعدها نافذة منبثقة تطلب منك الموافقة على شروط الاستخدام والأحكام.
وضع «اسم المنصةApp Name» ثم الضغط على «إنشاء Create»
تنتقل الآن إلى صفحة التفعيل والبيانات الخاصة بالتطبيق الذي أنشئته
2. تثبيت تطبيق Zoom وربطه في منصة مساق
توجّه إلى لوحة التحكم في منصتك التعليمية واختر "سوق التطبيقات" من القائمة الجانبية
ابحث على تطبيق Zoom واضغط على زر "تثبيت التطبيق"
تظهر الآن حقول ملئ بيانات يجب إكمالها
- في حقل "نوع التطبيق" اختر «Server-to-Server OAuth»
- انسخ مفاتيح Account ID وClient ID وClient Secret من صفحة App Credentials التي فعّلتها في سوق تطبيقات Zoom وألصقهم في الحقول المناسبة
- إضافة "Webhook Secret Token " من صفحة "Feature" في تطبيق S2S الذي أنشئناه في سوق تطبيقات زووم
- الضغط على "تثبيت التطبيق" في المنصة لاستكمال خطوات الربط الأخرى
3. تفعيل تطبيق S2S في سوق تطبيقات زووم
تنتقل الآن إلى صفحة «المعلومات Information» في صفحة التطبيق الذي أنشأته
- اكتب اسم منصتك التعليمية
- اكتب وصف عن التطبيق أو المنصة
- أدخل اسم الشركة
- أدخِل اسمك وبريدك الإلكتروني في مكانهما المخصصين والذين سيتواصل عبرهما منصة زووم لإعلامك بالتحديثات والإشعارات بشأن التطبيق
- أخيرًا، اضغط «متابعة Continue» أسفل الصفحة
ستنتقل إلى صفحة «سكوبس Scopes». اضغط على «Add Scopes».
والمقصود بالـ«سكوبس Scopes» هي الصلاحيات التي يمكن الوصول إليها من قبل التطبيق. يجب التأكد من تحديد الخيارات التالية:
نصائح المحترفين: يمكنك نسخ كل صلاحية من الصلاحيات التي في القائمة والبحث عنها وتحديدها بدلاً من إيجادها بشكل يدوي
Meeting
View all user meetings
- meeting:read:meeting:admin
View and manage all user meetings
- meeting:update:meeting:admin
- meeting:delete:meeting:admin
- meeting:write:meeting:admin
- meeting:write:invite_links:admin
View and manage sub account's user meetings
- meeting:read:meeting:master
Recording
View all user recordings
- cloud_recording:read:list_recording_files:admin
- cloud_recording:read:list_account_recordings:admin
- cloud_recording:read:list_user_recordings:admin
Report
View report data
- report:read:meeting:admin
- report:read:webinar:admin
- report:read:upcoming_meetings_webinars:admin
- report:read:cloud_recording:admin
- report:read:user:admin
User
View all user information
- user:read:list_users:admin
- user:read:token:admin
- user:read:settings:admin
- user:read:user:admin
Webinar
View all user Webinars
- webinar:read:list_webinars:admin
- webinar:read:webinar:admin
View and manage all user Webinars
- webinar:update:webinar:admin
- webinar:write:invite_links:admin
- webinar:delete:webinar:admin
- webinar:write:webinar:admin
View and manage sub account's user webinars
- webinar:read:webinar:master
4. تفعيل "Webhooks"
يجب عليك الآن تفعيل أحداث "Webhooks " من صفحة "Feature" في تطبيق S2S الذي أنشئناه في سوق تطبيقات زووم، والمقصود بالـ "Webhooks" هي أحداث تقنية ينفذها التطبيق لتزويد تطبيقات أخرى بمعلومات/بيانات عند حدوثها بشكل مباشر. مثلًا في حالة تطبيق زووم، ستحصل على تنبيهات عندما يبدأ اللقاءات الافتراضية، لتساعدك في تحسين وتطوير تجارب المستخدم في منصتك.
الذهاب إلى تبويب "Feature" في تطبيق S2S في سوق تطبيقات زووم
تفعيل "Event Subscriptions"
الضغط على "Add Event Subscription"
سيُطلب منك ملئ حقول البيانات وتحديد طريقة جلب البيانات، اختر "Webhook"
في حقل "Event notification endpoint URL"، سيطلب منك إدخال الرابط الذي ستُرسل إليه التنبيهات والأحداث
أدخِل الرابط التالي في هذا الحقل:
https://api.msaaq.com/apps/zoom/webhook
الآن عليك إنشاء "Header" عن طريق الضغط على "Authentication Header Option" ثم اختيار "Custom Header"
يجب عليك بعد ذلك ملء بيانات الحقول، ففي "Header Key" ضع "academy"، وفي "Header Value" ضع رابط منصتك التعليمية.
عند إضافة قيمة "Header Value" يجب التأكد من أن رابط المنصة لا يحتوي على أي لواحق زائدة مثل Https
يجب عليك الآن إنشاء عدة "أحداث Events" عبر الضغط على "Add Event" في نفس الصفحة
ثم بعد ذلك عليك تفعيل الأحداث التالية:
- Start Meeting
- End Meeting
- Meeting has been created
- Meeting has been updated
- Meeting has been deleted
- Start Webinar
- End Webinar
- Webinar has been created
- Webinar has been updated
- Webinar has been deleted
- All Recordings have completed
ثم الضغط على "Done"
ثم الضغط على "Save".
سيظهر لك الآن إشعار يفيد بأن الأحداث المُنشأة "Webhook" يحتاج إلى تأكيد. اضغط على علامة "التعديل" ثم في شاشة بيانات الحدث نضغط على "Validate"
5. تفعيل "Webhooks"
ستنتقل إلى «Activation»، اضغط على «Activate your app» لإكمال تفعيل التطبيق في سوق تطبيقات Zoom
بعد ذلك ستظهر لك شاشة تشير إلى إتمام عملية التفعيل والربط
الآن تم ربط تطبيق Zoom في منصتك بشكل كامل، وتستطيع إضافة دروس افتراضية عبر منصة زووم بكل سهولة.
اقرأ أيضًا:
دليل إضافة الدروس والمواد التعليمية إلى الدورات التدريبية.
كيفية إضافة درس أو اجتماع Zoom
تحديث في: 05/05/2024
شكرًا!