الربط مع زووم Zoom
من خلال ربط منصتك التعليمية مع Zoom، يمكنك إضافة الجلسات واللقاءات المباشرة والفصول الافتراضية إلى دوراتك، لتعزيز التفاعل والتواصل وتحسين التجارب التدريبية بشكل عام.
جدول المحتويات
خطوات ربط Zoom مع منصتك التعليمية
الخطوة الأولى: إنشاء تطبيق في Zoom وتفعيل مفاتيح الربط
الخطوة الثانية: تثبيت تطبيق Zoom في منصة مساق
الخطوة الثالثة: تفعيل تطبيق S2S في سوق تطبيقات Zoom
الخطوة الرابعة: تفعيل "Webhooks"
الخطوة الخامسة: تفعيل التطبيق
شاهد هذا الفيديو لمعرفة كيفية ربط منصتك مع Zoom:
اذهب إلى سوق تطبيقات Zoom: [[رابط سوق تطبيقات Zoom]
سجّل الدخول إلى حسابك في Zoom: إذا لم يكن لديك حساب، فإنشاء حساب جديد أمر سهل ومجاني.
تنويه: لا تحتاج إلى الاشتراك في باقات زووم حتى تنشئ حساب في سوق تطبيقات Zoom أو يتم الربط مع منصتك في مساق أو تنشئ تطبيق App.
انقر على "Develop" ثم اختر "Build Server-to-Server App".

تظهر شاشة منبثقة تطلب منك الموافقة على شروط الاستخدام والأحكام
تأكّد من اختيار "Server to Server OAuth App"، واضغط على "Create"

أدخل اسمًا لمنصتك في حقل "App Name"، واضغط على "Create"
انسخ مفاتيح Account ID و Client ID و Client Secret من صفحة "App Credentials". احتفظ بهذه المفاتيح لاستخدامها لاحقًا في الخطوة الثانية.

من صفحة "Feature"، انسخ "Webhook Secret Token". احتفظ بهذه القيمة أيضًا ستستخدمها في الخطوة الثانية.
### 2. الخطوة الثانية: تثبيت تطبيق Zoom في سوق تطبيقات مساق
في لوحة تحكم منصتك، اختر "سوق التطبيقات" من القائمة الجانبية
ابحث عن تطبيق Zoom واضغط على "تثبيت التطبيق"

املأ حقول بيانات الربط:
في حقل "نوع التطبيق"، اختر "Server-to-Server OAuth".
ألصِق مفاتيح Account ID و Client ID و Client Secret التي نسختها سابقًا في الحقول المخصّصة لها.
ألصِق "Webhook Secret Token" في الحقل المناسب.
اضغط على "تثبيت التطبيق" لاستكمال الربط.

في صفحة تطبيق Zoom الذي أنشأته، انتقل إلى تبويب "Information".
املأ المعلومات المطلوبة: اسم منصتك، ووصف، واسم الشركة، واسمك، وبريدك الإلكتروني

نصيحة: يمكنك نسخ كل صلاحية من الصلاحيات في القائمة والبحث عنها وتحديدها بدلاً من إيجادها بشكل يدوي]:
Meeting:
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
meeting:read:list_past_instances
meeting:read:list_past_instances:admin
Recording:
cloud_recording:read:list_recording_files:admin
cloud_recording:read:list_account_recordings:admin
cloud_recording:read:list_user_recordings:admin
Report:
report:read:meeting:admin
report:read:webinar:admin
report:read:upcoming_meetings_webinars:admin
report:read:cloud_recording:admin
report:read:list_meeting_participants:admin
report:read:user:admin
User:
user:read:list_users:admin
user:read:token:admin
user:read:settings:admin
user:read:user:admin
Webinar:
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" هي أحداث تقنية ينفذها التطبيق لتزويد تطبيقات أخرى بمعلومات/بيانات عند حدوثها بشكل مباشر. مثلًا في حالة تطبيق زووم، ستحصل على تنبيهات عندما يبدأ اللقاءات الافتراضية، لتساعدك في تحسين وتطوير تجارب المستخدم في منصتك. يمكن تفعيلها كالآتي:
في صفحة تطبيق Zoom، انتقل إلى تبويب "Feature".
فعّل "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: رابط منصتك التعليمية (بدون https://)
اضغط على "Add Events" وأضف الأحداث التالية:
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".
قم بتأكيد الأحداث (Webhooks) من خلال الضغط على "Validate" في صفحة تعديل الحدث.
انتقل إلى تبويب "Activation".
اضغط على "Activate your app" لإكمال تفعيل التطبيق.*
*بعد ذلك ستظهر لك شاشة تشير إلى إتمام عملية التفعيل والربط
| الآن تم ربط تطبيق Zoom في منصتك بشكل كامل، وتستطيع إضافة فصول افتراضية وجلسات مباشرة بكل سهولة.
**
جدول المحتويات
خطوات ربط Zoom مع منصتك التعليمية
الخطوة الأولى: إنشاء تطبيق في Zoom وتفعيل مفاتيح الربط
الخطوة الثانية: تثبيت تطبيق Zoom في منصة مساق
الخطوة الثالثة: تفعيل تطبيق S2S في سوق تطبيقات Zoom
الخطوة الرابعة: تفعيل "Webhooks"
الخطوة الخامسة: تفعيل التطبيق
شاهد هذا الفيديو لمعرفة كيفية ربط منصتك مع Zoom:
خطوات ربط Zoom مع منصتك التعليمية
1. الخطوة الأولى:إنشاء تطبيق في Zoom وتفعيل مفاتيح الربط
اذهب إلى سوق تطبيقات Zoom: [[رابط سوق تطبيقات Zoom]
سجّل الدخول إلى حسابك في Zoom: إذا لم يكن لديك حساب، فإنشاء حساب جديد أمر سهل ومجاني.
تنويه: لا تحتاج إلى الاشتراك في باقات زووم حتى تنشئ حساب في سوق تطبيقات Zoom أو يتم الربط مع منصتك في مساق أو تنشئ تطبيق App.
انقر على "Develop" ثم اختر "Build Server-to-Server App".

تظهر شاشة منبثقة تطلب منك الموافقة على شروط الاستخدام والأحكام
تأكّد من اختيار "Server to Server OAuth App"، واضغط على "Create"

أدخل اسمًا لمنصتك في حقل "App Name"، واضغط على "Create"
انسخ مفاتيح Account ID و Client ID و Client Secret من صفحة "App Credentials". احتفظ بهذه المفاتيح لاستخدامها لاحقًا في الخطوة الثانية.

من صفحة "Feature"، انسخ "Webhook Secret Token". احتفظ بهذه القيمة أيضًا ستستخدمها في الخطوة الثانية.

في لوحة تحكم منصتك، اختر "سوق التطبيقات" من القائمة الجانبية
ابحث عن تطبيق Zoom واضغط على "تثبيت التطبيق"

املأ حقول بيانات الربط:
في حقل "نوع التطبيق"، اختر "Server-to-Server OAuth".
ألصِق مفاتيح Account ID و Client ID و Client Secret التي نسختها سابقًا في الحقول المخصّصة لها.
ألصِق "Webhook Secret Token" في الحقل المناسب.
اضغط على "تثبيت التطبيق" لاستكمال الربط.

3. الخطوة الثالثة: تفعيل تطبيق S2S في سوق تطبيقات Zoom
في صفحة تطبيق Zoom الذي أنشأته، انتقل إلى تبويب "Information".
املأ المعلومات المطلوبة: اسم منصتك، ووصف، واسم الشركة، واسمك، وبريدك الإلكتروني

نصيحة: يمكنك نسخ كل صلاحية من الصلاحيات في القائمة والبحث عنها وتحديدها بدلاً من إيجادها بشكل يدوي]:
Meeting:
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
meeting:read:list_past_instances
meeting:read:list_past_instances:admin
Recording:
cloud_recording:read:list_recording_files:admin
cloud_recording:read:list_account_recordings:admin
cloud_recording:read:list_user_recordings:admin
Report:
report:read:meeting:admin
report:read:webinar:admin
report:read:upcoming_meetings_webinars:admin
report:read:cloud_recording:admin
report:read:list_meeting_participants:admin
report:read:user:admin
User:
user:read:list_users:admin
user:read:token:admin
user:read:settings:admin
user:read:user:admin
Webinar:
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

4. الخطوة الرابعة: تفعيل "Webhooks"
والمقصود بالـ "Webhooks" هي أحداث تقنية ينفذها التطبيق لتزويد تطبيقات أخرى بمعلومات/بيانات عند حدوثها بشكل مباشر. مثلًا في حالة تطبيق زووم، ستحصل على تنبيهات عندما يبدأ اللقاءات الافتراضية، لتساعدك في تحسين وتطوير تجارب المستخدم في منصتك. يمكن تفعيلها كالآتي:
في صفحة تطبيق Zoom، انتقل إلى تبويب "Feature".
فعّل "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: رابط منصتك التعليمية (بدون https://)

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".
قم بتأكيد الأحداث (Webhooks) من خلال الضغط على "Validate" في صفحة تعديل الحدث.
5. الخطوة الخامسة: تفعيل التطبيق
انتقل إلى تبويب "Activation".
اضغط على "Activate your app" لإكمال تفعيل التطبيق.*

*بعد ذلك ستظهر لك شاشة تشير إلى إتمام عملية التفعيل والربط

**
تحديث في: 08/02/2025
شكرًا!