مرجع تكامل Webex Video مع Microsoft Teams

ملخص

يعمل تكامل فيديو Webex لـ Microsoft Teams على تمكين أجهزة الفيديو من Cisco وSIP من الانضمام إلى اجتماعات Microsoft Teams.

إليك كيفية تحسين التكامل لتجربة مستخدم الجهاز عند انضمامه إلى اجتماعات Microsoft Teams المستضافة في مؤسستك:

تجربة اجتماع Webex - شاشة متعددة مع خيارات تخطيط مرنة
قائمة المشاركين تعرض كلا من المشاركين في تكامل Microsoft والفيديو
مشاركة المحتوى ثنائي الاتجاه بين الجهاز وMicrosoft Teams
مؤشرات حالة الاجتماع على الجهاز، بما في ذلك التسجيل والنسخ المكتوبة والمشارك الذي ينتظر في الردهة

عند نشر تكامل الفيديو مع خدمة التقويم الهجين في Webex، تحصل أجهزة الفيديو لديك أيضًا على تجربة الانضمام إلى الاجتماع المبسطة بزر واحد للضغط (OBTP).

نظرة عامة على البنية

يتيح برنامج Microsoft Cloud Video Interop (CVI) للشركاء مثل Cisco تقديم الخدمات التي تنضم لأجهزة الفيديو إلى اجتماعات Microsoft Teams.

صورة هندسة CVI على أساس https://docs.microsoft.com/en-us/microsoftteams/cloud-video-interop — ***بنية الحلول***

يعد Webex Video Integration لـ Microsoft Teams حل Cloud Video Interop من حلول Microsoft التابعة لطرف خارجي مؤهل وتم إنشاؤه على النظام الأساسي السحابي لتطبيق Webex. تتوفر إمكانات شريك CVI في سحابة Webex من أي مكان يستطيع المتصلون إجراء مكالمات من شركة إلى شركة على الإنترنت العامة. توفر خدمات Webex المشتركة الإدارة والبنية الأساسية للاتصالات وأنظمة الاستجابة الصوتية التفاعلية والردهات. توفر مجموعات وسائط Webex الموجودة في جميع أنحاء العالم تحويل الترميز وترجمات البروتوكول وأدوار روبوت Teams.

باستخدام هذه البنية، تجري أجهزة الفيديو مكالمات إلى عناوين SIP URI معينة تستضيفها Webex. تقوم خدمات Webex بالرد على المكالمات وتعيينها لمجموعات نظام الوسائط ذات الصلة جغرافيًا والتي تعمل في Microsoft Azure. يقوم IVR بتجميع تفاصيل الاجتماع إذا لزم الأمر، ويقوم روبوت CVI الخاص بـ Microsoft Teams في مجموعة وسائط Webex بإجراء الاتصال بالبنية الأساسية لاجتماعات Microsoft Teams. توفر مجموعات الوسائط الاتصال المتتالي بين المشارك المتصل من خلال Webex وبقية المؤتمر المستضاف على Microsoft Teams. يعمل الحل بأكمله كخدمة سحابية.

يتيح تكامل الفيديو للأجهزة الانضمام إلى اجتماعات Teams على النحو التالي:

إذا تم تمكين الاجتماع من أجل CVI، فيمكن للجهاز الانضمام باستخدام معرف الفيديو ومفتاح المستأجر.
إذا لم يتم تمكين الاجتماع من أجل CVI، فيمكن للجهاز الانضمام كضيف (انضمام متعدد المستأجرين) باستخدام معرف الاجتماع ورمز المرور.

يمكنك تحسين تجربة المستخدم عن طريق إضافة خدمات Webex الأخرى. على سبيل المثال، تضغط خدمة التقويم المختلط تلقائيا على تفاصيل الاجتماع وأزرار الانضمام المبسطة إلى أجهزة الفيديو عندما يحين وقت الانضمام إلى الاجتماع.

معالجة البيانات

يستخدم تكامل الفيديو البيانات التالية لتوصيل الأجهزة باجتماعات Microsoft Teams وتوفير ميزات داخل الاجتماع:

تسجيل تطبيق المؤسسة: أثناء عملية التوفير، يستخدم المسؤول تطبيق Webex Video Integration لمنح الأذونات للوصول إلى مستأجر Microsoft الخاص بالمؤسسة عند استخدام Microsoft Graph API. للحصول على مزيد من المعلومات، ارجع إلى تكامل فيديو Webex في مركز إدارة Microsoft Entra.
مفتاح المستأجر" الذي يوفره Webex: هذه قيمة لكل عميل يتم استخدامها في عناوين SIP عندما يتصل الجهاز بخدمة VIMT.
معرف الاجتماع: تقوم Microsoft Teams بتعيين هذا المعرف عند إنشاء الاجتماع، وتضمينه في دعوة الاجتماع.

يحتاج المستخدمون إلى معرف الاجتماع للانضمام إلى الاجتماعات من عملاء Teams، أو عن طريق انضمام الضيف المباشر، أو عن طريق الانضمام عبر المستأجر باستخدام خدمة VIMT.

يستخدم دمج الفيديو هذا المعرّف لتحديد اجتماع Microsoft Teams المستهدف أثناء الانضمام عبر مستأجر.
رمز مرور الاجتماع: تقوم Microsoft Teams بتعيين رمز مرور حساس لحالة الأحرف عند إنشاء الاجتماع، وتضمينه في دعوة الاجتماع. يحتاج المستخدمون إلى رمز مرور للانضمام إلى اجتماع باستخدام معرف الاجتماع.

يستخدم تكامل الفيديو رمز المرور هذا للوصول إلى اجتماع Microsoft Teams المستهدف أثناء الانضمام عبر مستأجر.
معرف الفيديو: يقوم Microsoft Teams بتعيين هذا المعرف لاجتماع عند إنشائه بواسطة مستخدم تم تمكين CVI. يتضمن Microsoft Teams معرف الفيديو في دعوة الاجتماع.

يستخدم دمج الفيديو معرف الفيديو ومعرف مستأجر Microsoft الخاص بالعميل للحصول على عنوان URL الخاص بالانضمام إلى الاجتماع من واجهة Microsoft Graph API.

(قامت Microsoft بتحديث التسمية إلى "معرف الفيديو" من "معرف مؤتمر VTC".)
معرف مستأجر Microsoft الخاص بالعميل: يستخدم لتحديد مؤسسة Microsoft المستهدفة عند الاتصال بواجهة برمجة تطبيقات Microsoft Graph. يستخدم أيضا في الواجهة الإدارية للخدمة لتحديد مستأجر Microsoft المزود.
أسماء المجالات التي تم التحقق منها من قبل مستأجر Microsoft: تستخدم كتسميات في الواجهة الإدارية للخدمة لتحديد مستأجر Microsoft المزود.
معلومات الاجتماع: عندما يطلب أحد المشاركين الانضمام إلى اجتماع Microsoft Teams من خلال تكامل الفيديو، تقوم الخدمة باسترداد تفاصيل هذا الاجتماع بما في ذلك موضوع الاجتماع والمنظم والتاريخ/الوقت وتفاصيل الاتصال. بمجرد الاتصال، تقوم الخدمة باسترداد المعلومات في الوقت الفعلي مثل تسميات المشاركين والقدرات وحالة المشاركين المتصلين باجتماع Teams من واجهة برمجة تطبيقات Microsoft Graph واستخدامها لتسهيل الاجتماع المباشر.

عند تمكين Hybrid Calendar Service لصندوق بريد، تستخدم خدمة التقويم ارتباط المزيد من المعلومات ، الموجود في نص إدخالات التقويم التي تتضمنه، لتحديد "مفتاح المستأجر" للاجتماع ومعرف الفيديو.
الوسائط والمحتوى في الوقت الفعلي: عندما ينضم أحد المشاركين إلى اجتماع Microsoft Teams من خلال تكامل الفيديو، يقوم تبادل Webex وMicrosoft Teams بتشفير محتوى الصوت والفيديو ومعدل الإطارات المرتفع لتمكين تجربة الصوت والفيديو المتبادلة بينهما.

إذا قمت بنشر تكامل الفيديو مع خدمة التقويم الهجين، ارجع أيضًا إلى خدمة التقويم الهجين في Webex مع مرجع تكامل Microsoft 365.

المصادقة والتخويل

يتفاعل Webex مع بيئة Microsoft Teams باستخدام واجهة برمجة التطبيقات الخاصة بـ Microsoft Graph. يعالج موفر هوية Microsoft (IdP) المستند إلى مجموعة النظراء المصادقة لواجهة برمجة تطبيقات Microsoft Graph. تتم الموافقة على الطلبات المقدمة إلى واجهة برمجة تطبيقات Microsoft Graph من خلال تقديم الرموز المميزة لحاملها الصادرة عن Microsoft IdP. تستخدم جميع الاتصالات بموفر الهوية Microsoft وواجهة برمجة تطبيقات الرسم البياني اتصالات ويب مؤمنة بطبقة النقل الآمنة TLS.

للتفاعل مع وسائط Microsoft Teams كخدمة، يمكنك تسجيل تكامل فيديو Webex كروبوت وسائط يستضيفه التطبيق وموجود في مستأجر Microsoft 365 تتم إدارته بواسطة Cisco. تتطلب روبوتات Teams إذنا مسبقا لتتمكن من التواصل مع مستأجر Microsoft 365 الخاص بالمؤسسة.

أثناء التكوين الأولي، تطلب الخدمة تفويضا لمجموعة محددة مسبقا من الأذونات. يمنح المسؤول أذونات التطبيق هذه عن طريق اتباع تدفق الموافقة الموضح أدناه.

بمجرد الموافقة عليها، يمكن لخدمة Webex طلب الرموز المميزة للحامل، مع الأذونات الصحيحة ونطاق العميل، من Microsoft OAuth v2.0 IdP. تستخدم الخدمة الرموز المميزة للحامل لتفويض الطلبات إلى Microsoft Graph API للحصول على تفاصيل التوريد والفحوص الصحية وتشغيل روبوت Teams.

المصادقة وموافقة مسؤول Microsoft

يستطيع مسؤولو المؤسسة الذين يلعبون دور المسؤول الكامل استخدام Control Hub لإعداد خدمة دمج الفيديو لمؤسستهم.

تتطلب عملية التوفير مصادقة مسؤول عمومي لمستأجر Microsoft 365 الذي ينتمي إليه مستخدموك وموافقته. يمكن منح أذونات التطبيق المطلوبة لتشغيل روبوت Teams فقط من قبل مسؤول عام لمستأجر Microsoft باستخدام تدفق موافقة المسؤول التالي.

يتضمن التدفق الخطوات التالية عالية المستوى:

سجّل الدخول إلى Control Hub، وابحث عن إعداد دمج الفيديو وبدء تشغيله (للتعرف على خطوات الإعداد التفصيلية، ارجع إلى نشر دمج فيديو Webex من أجل Microsoft Teams).

أثناء عملية الإعداد، تتم إعادة توجيه المستعرض الخاص بك إلى سحابة Microsoft من أجل المصادقة والموافقة.
سجّل الدخول كمسؤول عام لمستأجر Microsoft.

يطلب التطبيق إذنك للقيام بما يلي:
- تسجيل الدخول وقراءة ملف التعريف الخاص بك
- قراءة إعدادات RBAC الخاصة بالدليل
وذلك حتى يتمكن التطبيق من التحقق من أن حسابك مصرح به داخل المستأجر الخاص بك لمنح الأذونات اللازمة.
حدد المربع الموافقة نيابة عن مؤسستك، ثم انقر على قبول.

يقوم التطبيق بتسجيل دخولك والتحقق من أذوناتك.

بعد أن تتم المصادقة عليك بنجاح، يطالبك التطبيق مرة أخرى. هذه المرة، تعرض المطالبة الأذونات التي يحتاج إليها التطبيق لتوصيل أجهزة الفيديو باجتماعات Microsoft Teams بنجاح.

تعرض المطالبة اسم التطبيق ومجال المورّد والأذونات المطلوبة.
انقر على قبول لمنح هذه الأذونات لتطبيق تكامل فيديو Webex.

تمت إعادة توجيهك مرة أخرى إلى Control Hub، حيث يمكنك رؤية أوامر PowerShell المخصصة التي تحتاجها لإكمال تكوين Microsoft Teams.
استخدم PowerShell لإنهاء تكوين Microsoft Teams، ثم أغلق لوحة Control Hub.

تختبر عملية الإعداد استدعاء Microsoft Graph API للمؤسسة. في حالة نجاحه، يكتمل الإعداد. إذا لم يكن الأمر كذلك ، فيمكن للمسؤول تجربة عملية التخويل مرة أخرى.

تم منح الأذونات

يتطلب دمج فيديو Webex لـ Microsoft Teams أذونات صريحة في مستأجر Microsoft الخاص بك. هذه الأذونات غير قابلة للتخصيص ويتم تكوينها تلقائيًا من خلال عملية الإعداد في Control Hub.

يتم استخدام مجموعتين منفصلتين من الأذونات:

مجموعة من الأذونات التي يوافق عليها المستخدم والتي يتم استخدامها أثناء الإعداد للتحقق من معلومات المستأجر المستهدف
مجموعة من الأذونات الممنوحة بواسطة موافقة المسؤول على تطبيق المؤسسة في دليل Entra الخاص بك. تتيح هذه المجموعة للخدمة الوصول إلى بيئة Microsoft Teams الخاصة بك

الأذونات التي وافق عليها المستخدم

في أثناء إعداد الخدمة، نطلب الأذونات التالية من المستخدم الذي قام بتسجيل الدخول. وهي تسمح بالوصول إلى مستأجر Microsoft للتحقق من المعلومات المتعلقة بالمستأجر المستهدف. نحن نستخدم هذه الأذونات فقط أثناء إعداد التكامل؛ ولا يتم تخزينها.

يمكنك مراجعة الأذونات التي وافق عليها المستخدم في صفحة الأذونات الخاصة بالتطبيق في دليل Entra الخاص بك.

الجدول رقم 1. الأذونات التي وافق عليها المستخدم ولماذا تحتاج عملية الإعداد إليها
يلزم الحصول على إذن	الغرض
"تسجيل الدخول وقراءة ملف تعريف المستخدم" (User.read)	يُستخدم لقراءة ملف تعريف المستخدم الذي قام بتسجيل الدخول لتحديد مستأجر المستخدم.
"قراءة إعدادات دليل RBAC" (RoleManagement.Read.Directory)	يُستخدم للتحقق مما إذا كان المستخدم الذي سجّل الدخول عضوًا في مجموعات أمان المسؤول المعروفة في Entra ID.
"الحفاظ على إمكانية الوصول إلى البيانات التي منحتها صلاحية الوصول إليها" (offline_access)	السماح للخدمة برؤية البيانات التي منحتها صلاحية الوصول إليها دون تسجيل دخول مستخدمين.

أذونات الخدمة

يمنح تدفق موافقة مسؤول Microsoft الأذونات التالية إلى "دمج فيديو Cisco Webex لتطبيق MS Teams للمؤسسات" في المستأجر الخاص بك. تقوم هذه الأذونات بتمكين خدمة Webex من الوصول إلى بيئة Teams الخاصة بك.

تستمر الأذونات في التطبيق في دليل Entra الخاص بك حتى تقوم بإزالة خدمة Webex، التي تزيل التطبيق أيضًا.

الجدول رقم 2. منح المسؤول الأذونات وسبب احتياج خدمة Webex لها
الإذن	الاستخدام
قراءة النطاقات (Domain.Read.All)	يسمح للخدمة بقراءة أسماء النطاقات التي تم التحقق منها للمستأجر. يستخدم مركز التحكم أسماء المجالات لتحديد المستأجر الذي ترتبط به الخدمة.
بدء المكالمات الصادرة من 1 إلى 1 من التطبيق (Calls.Start.All)	يسمح بإنشاء مكالمات بواسطة الروبوت لمستخدمي Microsoft Teams. (محجوزة للاستخدام في المستقبل.)
بدء المكالمات الجماعية الصادرة من التطبيق (Calls.InitiateGroupCall.All)	يسمح بإنشاء مكالمات بواسطة الروبوت لمجموعة من مستخدمي Microsoft Teams. (محجوزة للاستخدام في المستقبل.)
الانضمام إلى المكالمات الجماعية والاجتماعات كتطبيق (Calls.JoinGroupCall.All)	يسمح للروبوت بالانضمام إلى المكالمات الجماعية والاجتماعات المجدولة في مؤسستك بامتيازات مستخدم الدليل. يستخدم للانضمام إلى المشاركين المصرح لهم بتجاوز ردهة Microsoft Teams.
الانضمام إلى المكالمات الجماعية والاجتماعات كضيف (Calls.JoinGroupCallAsGuest.All)	يسمح هذا الإعداد للروبوت بالانضمام إلى المكالمات الجماعية والاجتماعات المجدولة في مؤسستك كضيف. يستخدم للانضمام إلى المشاركين غير المصرح لهم بتجاوز ردهة انتظار Microsoft Teams.
الوصول إلى تدفقات الوسائط في مكالمة كتطبيق (Calls.AccessMedia.All)	يسمح للروبوت بالوصول المباشر إلى تدفقات الوسائط في مكالمة، بدون مستخدم مسجل الدخول.
قراءة تفاصيل الاجتماع عبر الإنترنت (OnlineMeetings.Read.All)	يسمح للخدمة بقراءة تفاصيل الاجتماع عبر الإنترنت في مؤسستك. تستخدم للبحث عن معرفات مؤتمرات VTC وحلها في اجتماعات Microsoft Teams.
تسجيل الدخول وقراءة ملف تعريف المستخدم (User.read)	مطلوب للأذونات الأخرى المدرجة. التكامل لا يستخدمه مباشرة.

مرجع أذونات الرسم البياني ل Microsoft: https://docs.microsoft.com/en-us/graph/permissions-reference

نظرة عامة على روبوتات اجتماعات Microsoft: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview

الوصول إلى الاجتماعات

عادة ما يتم التعامل مع المشاركين الذين يتصلون من خلال تكامل الفيديو كمستخدمين ضيوف لاجتماعات Microsoft Teams ويمكن وضعهم في ردهة (غرفة انتظار). يجب على مستخدم Microsoft Teams قبول مشارك موجود في ساحة الانتظار يدويا قبل أن يتمكن المشارك من سماع المشاركين الآخرين أو رؤيتهم.

يمكنك التحكم في سلوك ردهة انتظار Microsoft Teams من خلال نهج الاجتماعات التي قام بتعيينها مسؤول في Microsoft Teams ومن خلال خيارات الاجتماع التي حددها منظم الاجتماع. بشكل افتراضي، يجب على مستخدمي Microsoft Teams الضيوف استخدام ساحة الانتظار. لمزيد من المعلومات حول سياسات اجتماعات Teams، راجع إدارة نهج الاجتماعات في Teams.

إذا كان يستطيع المستخدمون المجهولون الانضمام إلى اجتماع في وضع إيقاف التشغيل: يمكن فقط للمشاركين الموثوق بهم، الذين يُسمح لهم بتجاوز الردهة، الانضمام إلى الاجتماع باستخدام تكامل فيديو Webex.

دائمًا ما ينضم المشاركون الذين يستخدمون الانضمام عبر المستأجر (بما في ذلك استخدام معرّف الاجتماع ورمز المرور) كضيوف. تفشل محاولات الانضمام هذه إذا قامت المؤسسة التي تستضيف الاجتماع بتعطيل يمكن للمستخدمين المجهولين الانضمام إلى اجتماع.

تجاوز الردهة للمشاركين الموثوق بهم

يتم التعامل مع المشاركين الذين يتصلون بتكامل الفيديو باستخدام الطرق التالية باعتبارهم مشاركين موثوق بهم وينضمون إلى اجتماعات Microsoft Teams دون وضعهم في ردهة:

الأجهزة المسجلة في مؤسسة Webex الخاصة بك كأجهزة مسجلة في Webex
الاتصال من نطاقات SIP التي تمت إضافتها والتحقق من ملكيتها لمؤسستك في Control Hub

يتم التعامل مع المشاركين الموثوق بهم كمشاركين داخل مؤسستك. يستطيع المشاركون الذين يتصلون من خلال هذه المسارات الموثوقة تجاوز الردهة إذا قام المنظم بتقييد إعدادات ردهة اجتماع Teams. إذا تم تعيين خيار من يمكنه تجاوز الردهة؟ على خيار الاجتماع "المنظمون وأنا" أو "الأشخاص الذين أدعوهم"، يتم تجاهل المشاركين الموثوق بهم الذين يحاولون الانضمام، ويتم وضع جميع المتصلين بـ VIMT في ردهة اجتماع Teams عند الانضمام إلى اجتماع.

دائمًا ما ينضم المشاركون الذين يستخدمون الانضمام عبر المستأجر (بما في ذلك استخدام معرّف الاجتماع ورمز المرور) كضيوف. يعني هذا أنه حتى المشاركين الموثوق بهم الذين ينضمون بهذه الطريقة يجب عليهم الانتظار في الردهة حتى يقبلهم المضيف.

لمزيد من المعلومات حول إضافة نطاقات SIP والتحقق منها، راجع عملية التحقق من النطاق لأجهزة فيديو SIP.

تكامل فيديو Webex في مركز إدارة Microsoft Entra

لا توجد متطلبات صيانة للتطبيق بعد قيامك بتفويض خدمة دمج الفيديو للوصول إلى مستأجر Microsoft 365 الخاص بك. يمكنك التحقق من وجودها والنطاق في قائمة تطبيقات المؤسسة في مركز مسؤول Microsoft Entra.

لا يتم تشغيل أي تطبيق أو برنامج فعلي في المستأجر كجزء من هذا التكامل. يكون إدخال تطبيق المؤسسة هو التعريف والنقطة المقابلة للتفويض الممنوح لهوية تطبيق Webex.