الربط مع زووم Zoom

**من خلال ربط منصتك التعليمية مع Zoom، يمكنك إضافة الجلسات واللقاءات المباشرة والفصول الافتراضية إلى دوراتك، لتعزيز التفاعل والتواصل وتحسين التجارب التدريبية بشكل عام. **

**جدول المحتويات ** ** **

خطوات ربط Zoom مع منصتك التعليمية

1. الخطوة الأولى: إنشاء تطبيق في Zoom وتفعيل مفاتيح الربط

2. الخطوة الثانية: تثبيت تطبيق Zoom في منصة مساق

3. الخطوة الثالثة: تفعيل تطبيق S2S في سوق تطبيقات Zoom

4. الخطوة الرابعة: تفعيل "Webhooks"

5. الخطوة الخامسة: تفعيل التطبيق

**شاهد هذا الفيديو لمعرفة كيفية ربط منصتك مع Zoom: **

** **

خطوات ربط Zoom مع منصتك التعليمية

1. الخطوة الأولى:إنشاء تطبيق في Zoom وتفعيل مفاتيح الربط

• اذهب إلى سوق تطبيقات Zoom: [[رابط سوق تطبيقات Zoom]
• سجّل الدخول إلى حسابك في Zoom: إذا لم يكن لديك حساب، فإنشاء حساب جديد أمر سهل ومجاني.

انقر على "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" في الحقل المناسب.

**

• ***اضغط على "تثبيت التطبيق" لاستكمال الربط.

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://)

ضغط على "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" في صفحة تعديل الحدث.

5. الخطوة الخامسة: تفعيل التطبيق

• انتقل إلى تبويب "Activation".

اضغط على "Activate your app" لإكمال تفعيل التطبيق.*

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

*

| الآن تم ربط تطبيق Zoom في منصتك بشكل كامل، وتستطيع إضافة فصول افتراضية وجلسات مباشرة بكل سهولة.

• ***

تحديث في: 08/02/2025