Share via

الاتصال Azure Communications Gateway إلى توصيل المشغل أو Teams الهاتف Mobile

  • مقالة

بعد نشر Azure Communications Gateway وتوصيلها بشبكتك الأساسية، تحتاج إلى توصيلها بنظام هاتف Microsoft. تحتاج أيضا إلى الإلحاق ببيئات توصيل المشغل أو Teams الهاتف Mobile.

توضح هذه المقالة كيفية إعداد Azure Communications Gateway توصيل المشغل وTeams الهاتف Mobile. بعد الانتهاء من الخطوات الواردة في هذه المقالة، يمكنك التحضير لنسبة استخدام الشبكة المباشرة باستخدام توصيل المشغل وTeams الهاتف Mobile وAzure Communications Gateway.

تلميح

تفترض هذه المقالة أن فريق إلحاق Azure Communications Gateway من Microsoft يقوم أيضا بإلحاقك توصيل المشغل و/أو Teams الهاتف Mobile. إذا اخترت شريك إلحاق مختلف ل توصيل المشغل أو Teams الهاتف Mobile، فستحتاج إلى مطالبتهم بترتيب تغييرات على بيئات توصيل المشغل و/أو Teams الهاتف Mobile.

المتطلبات الأساسية

يجب نشر Azure Communications Gateway.

يجب أن يكون لديك حق الوصول إلى حساب مستخدم مع دور microsoft Entra Global مسؤول istrator.

يجب تخصيص أرقام اختبار "التحقق من الخدمة". يتم استخدام هذه الأرقام من قبل توصيل المشغل وTeams الهاتف Mobile لاختبار المكالمات المستمرة. تحتاج عمليات نشر الإنتاج إلى ستة أرقام لكل خدمة. تحتاج عمليات نشر المعمل إلى ثلاثة أرقام لكل خدمة.

  • إذا حددت الخدمة التي تقوم بإعدادها كجزء من نشر Azure Communications Gateway، فقد قمت بتخصيص أرقام للخدمة بالفعل.
  • وإلا، فاختر أرقام الهواتف الآن (بتنسيق E.164 وتضمين رمز البلد) والأسماء لتعريفها. نوصي بأسماء النموذج OC1 وOC2 (توصيل المشغل) وTPM1 وTPM2 (ل Teams الهاتف Mobile).

يجب عليك أيضا تخصيص رقم اختبار واحد على الأقل لكل خدمة لاختبار التكامل.

إذا كنت ترغب في إعداد Teams الهاتف Mobile ولم تحدده عند نشر Azure Communications Gateway، فاختر:

  • الرقم المستخدم في Teams الهاتف Mobile للوصول إلى Voicemail Interactive Voice Response (IVR) من المشاركين الأصليين.

  • طريقة توجيه مكالمات Teams الهاتف Mobile إلى نظام هاتف Microsoft. اختر من:

    • MCP المتكامل (MCP في Azure Communications Gateway).
    • MCP المحلي.
    • طريقة أخرى لتوجيه المكالمات.

تمكين دعم توصيل المشغل أو Teams الهاتف Mobile

إشعار

إذا حددت توصيل المشغل أو Teams الهاتف Mobile عند نشر Azure Communications Gateway، فتخط هذه الخطوة وانتقل إلى إضافة تطبيق Project Synergy إلى مستأجر Azure.

  1. قم بتسجيل الدخول إلى بوابة Azure.
  2. في شريط البحث في أعلى الصفحة، ابحث عن مورد بوابة الاتصالات وحدده.
  3. في شريط القوائم الجانبي، ضمن خدمات الاتصالات، حدد توصيل المشغل أو Teams الهاتف Mobile (حسب الاقتضاء) لفتح صفحة للخدمة.
  4. حدد إعدادات توصيل المشغل أو إعدادات Teams الهاتف Mobile.
  5. املأ الحقول، ثم حدد Review + create and Create.
  6. حدد صفحة Overview للمورد الخاص بك.
  7. حدد Add test lines وأضف خطوط التحقق من الخدمة التي اخترتها في Prerequisites. تعيين الغرض من الاختبار إلى Automated.

    هام

    لا تقم بإضافة أرقام لاختبار التكامل. ستقوم بتكوين أرقام لاختبار التكامل عند إجراء اختبار التكامل والاستعداد لنسبة استخدام الشبكة المباشرة.

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

إضافة تطبيق Project Synergy إلى مستأجر Azure

قبل بدء هذه الخطوة، تحقق من أن حقل حالة التزويد للمورد الخاص بك هو "مكتمل".

إشعار

تقوم هذه الخطوة والخطوة التالية (تعيين مستخدم مسؤول لتطبيق Project Synergy) بإعدادك كمشغل في بيئات Teams الهاتف Mobile (TPM) توصيل المشغل (OC). إذا كنت قد مررت بالفعل بالإلحاق، فانتقل إلى البحث عن معرف التطبيق لمورد Azure Communication Gateway.

تتطلب برامج توصيل المشغل وTeams الهاتف Mobile من مستأجر Microsoft Entra أن يحتوي على تطبيق Microsoft يسمى Project Synergy. ترث توصيل المشغل وTeams الهاتف Mobile الأذونات والهويات من مستأجر Microsoft Entra من خلال تطبيق Project Synergy. يسمح تطبيق Project Synergy أيضا بتكوين توصيل المشغل أو Teams الهاتف Mobile وتعيين المستخدمين والمجموعات لأدوار محددة.

لإضافة تطبيق Project Synergy:

  1. تحقق مما إذا كانت الوحدة النمطية Microsoft Entra ID (AzureAD) مثبتة في PowerShell. قم بتثبيته إذا لزم الأمر.
    1. افتح PowerShell.
    2. قم بتشغيل الأمر التالي وتحقق مما إذا كان AzureAD يظهر في الإخراج. 
      Get-Module -ListAvailable
    3. إذا AzureAD لم يظهر في الإخراج، فقم بتثبيت الوحدة النمطية.
      1. أغلق نافذة PowerShell الحالية.
      2. افتح PowerShell كمسؤول.
      3. قم بتشغيل الأمر التالي. 
        Install-Module AzureAD
      4. أغلق نافذة مسؤول PowerShell.
  2. سجل الدخول إلى مدخل Microsoft Azure ك Microsoft Entra Global مسؤول.
  3. حدد معرف Microsoft Entra.
  4. حدد الخصائص.
  5. ثم قم بالتمرير لأسفل إلى حقل Tenant ID. معرف المستأجر الخاص بك في المربع. دون معرف المستأجر الخاص بك.
  6. افتح PowerShell.
  7. قم بتشغيل الأمر cmdlet التالي، مع <TenantID> استبدال بمعرف المستأجر الذي لاحظته لأسفل في الخطوة 5. 
    Connect-AzureAD -TenantId "<TenantID>"
New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"

تعيين مستخدم مسؤول لتطبيق Project Synergy

يحتاج المستخدم الذي يقوم بإعداد Azure Communications Gateway إلى أن يكون له دور المستخدم مسؤول في تطبيق Project Synergy. قم بتعيين هذا الدور لهم في مدخل Microsoft Azure.

  1. في مدخل Microsoft Azure، انتقل إلى معرف Microsoft Entra ثم تطبيقات المؤسسة باستخدام القائمة اليمنى. بدلا من ذلك، يمكنك البحث عن تطبيقات المؤسسة في شريط البحث؛ إنه ضمن العنوان الفرعي للخدمات .
  2. قم بتعيين عامل تصفية نوع التطبيق إلى جميع التطبيقات باستخدام القائمة المنسدلة.
  3. حدد تطبيق.
  4. ابحث عن Project Synergy باستخدام شريط البحث. يجب أن يظهر التطبيق.
  5. حدد تطبيق Project Synergy.
  6. حدد Users and groups من القائمة الجانبية اليسرى.
  7. حدد Add user/group.
  8. حدد المستخدم الذي يجب عليه إعداد Azure Communications Gateway ومنحه دور مسؤول.

تنبيه

لا تقم بتغيير أي من تكوينات توصيل المشغل التالية في المستأجر الخاص بك (سواء من خلال مدخل تكوين توصيل المشغل أو من خلال واجهات برمجة التطبيقات توصيل المشغل).

  • استدعاء ملفات التعريف مع لاحقة CommsGw في مدخل التكوين أو NameSuffix على واجهات برمجة التطبيقات توصيل المشغل
  • الجذوع مع FQDNs تنتهي ب .commsgw.azure.com

نحن ندير هذا التكوين نيابة عنك. من المحتمل أن يؤدي تحرير هذا التكوين إلى حدوث مشكلات في خدمة Azure Communications Gateway.

ابحث عن معرف التطبيق لمورد Azure Communication Gateway

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

  1. قم بتسجيل الدخول إلى بوابة Azure.
  2. إذا كنت لا تعرف بالفعل اسم مورد بوابة الاتصالات، فابحث عن Communications Gateways ولاحظ اسم المورد.
  3. ابحث عن اسم مورد الاتصالات الخاص بك. يجب أن تشاهد تطبيق مؤسسة بهذه القيمة ضمن العنوان الفرعي لمعرف Microsoft Entra. قد تحتاج إلى تحديد متابعة البحث في معرف Microsoft Entra للعثور عليه.
  4. حدد تطبيق المؤسسة.
  5. تحقق من أن الاسم يطابق اسم مورد بوابة الاتصالات.
  6. دون ملاحظة عن معرف التطبيق.

إعداد أدوار التطبيق لبوابة اتصالات Azure

تحتوي بوابة اتصالات Azure على خدمات تحتاج إلى الوصول إلى واجهة برمجة تطبيقات توصيل المشغل نيابة عنك. لتمكين هذا الوصول، يجب منح أدوار تطبيق معينة للهوية المدارة المعينة من قبل النظام لبوابة اتصالات Azure ضمن Project Synergy Enterprise Application. لقد أنشأت تطبيق Project Synergy Enterprise في إضافة تطبيق Project Synergy إلى مستأجر Azure.

يجب تنفيذ هذه الخطوة مرة واحدة لكل مورد Azure Communications Gateway تريد استخدامه توصيل المشغل أو Teams الهاتف Mobile.

هام

يتضمن منح الأذونات جزأين: تكوين الهوية المدارة المعينة من قبل النظام ل Azure Communications Gateway مع الأدوار المناسبة (هذه الخطوة) وإضافة معرف التطبيق للهوية المدارة إلى بيئة توصيل المشغل أو Teams الهاتف Mobile. ستضيف معرف التطبيق إلى بيئة توصيل المشغل أو Teams الهاتف Mobile لاحقا، في إضافة معرفات التطبيق لبوابة اتصالات Azure إلى توصيل المشغل.

قم بالخطوات التالية في المستأجر الذي يحتوي على تطبيق Project Synergy.

  1. تحقق مما إذا كانت الوحدة النمطية Microsoft Graph (Microsoft.Graph) مثبتة في PowerShell. قم بتثبيته إذا لزم الأمر.
    1. افتح PowerShell.
    2. قم بتشغيل الأمر التالي وتحقق مما إذا كان Microsoft.Graph يظهر في الإخراج. 
      Get-Module -ListAvailable
    3. إذا Microsoft.Graph لم يظهر في الإخراج، فقم بتثبيت الوحدة النمطية.
      1. أغلق نافذة PowerShell الحالية.
      2. افتح PowerShell كمسؤول.
      3. قم بتشغيل الأمر التالي. 
        Install-Module -Name Microsoft.Graph -Scope CurrentUser
      4. أغلق نافذة مسؤول PowerShell.
  2. سجل الدخول إلى مدخل Microsoft Azure ك Microsoft Entra Global مسؤول istrator.
  3. حدد معرف Microsoft Entra.
  4. حدد الخصائص.
  5. ثم قم بالتمرير لأسفل إلى حقل Tenant ID. معرف المستأجر الخاص بك في المربع. دون معرف المستأجر الخاص بك.
  6. افتح PowerShell.
  7. قم بتشغيل الأمر cmdlet التالي، مع <TenantID> استبدال بمعرف المستأجر الذي لاحظته لأسفل في الخطوة 5. 
    Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
    إذا تمت مطالبتك بمنح أذونات لأدوات سطر أوامر Microsoft Graph، فحدد قبول لمنح الأذونات.
  8. قم بتشغيل الأمر cmdlet التالي، مع <CommunicationsGatewayName> استبدال باسم مورد Azure Communications Gateway. 
    $acgName = "<CommunicationsGatewayName>"
  9. شغّل أوامر PowerShell التالية. تضيف هذه الأوامر الأدوار التالية لبوابة اتصالات Azure: TrunkManagement.Read، TrunkManagement.Write، partnerSettings.Read، NumberManagement.Read، NumberManagement.Write، Data.Read. Data.Write 
    # Get the Service Principal ID for Project Synergy (Operator Connect)
$projectSynergyApplicationId = "eb63d611-525e-4a31-abd7-0cb33f679599"
$projectSynergyEnterpriseApplication = Get-MgServicePrincipal -Filter "AppId eq '$projectSynergyApplicationId'" # "Application.Read.All"

# Required Operator Connect - Project Synergy Roles
$trunkManagementRead = "72129ccd-8886-42db-a63c-2647b61635c1"
$trunkManagementWrite = "e907ba07-8ad0-40be-8d72-c18a0b3c156b"
$partnerSettingsRead = "d6b0de4a-aab5-4261-be1b-0e1800746fb2"
$numberManagementRead = "130ecbe2-d1e6-4bbd-9a8d-9a7a909b876e"
$numberManagementWrite = "752b4e79-4b85-4e33-a6ef-5949f0d7d553"
$dataRead = "eb63d611-525e-4a31-abd7-0cb33f679599"
$dataWrite = "98d32f93-eaa7-4657-b443-090c23e69f27"
$requiredRoles = $trunkManagementRead, $trunkManagementWrite, $partnerSettingsRead, $numberManagementRead, $numberManagementWrite, $dataRead, $dataWrite

# Locate the Azure Communications Gateway resource by name
$acgServicePrincipal = Get-MgServicePrincipal -Filter ("displayName eq '$acgName'")

# Assign the required roles to the managed identity of the Azure Communications Gateway resource
$currentAssignments = Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
foreach ($appRoleId in $requiredRoles) {
    $assigned = $currentAssignments | Where-Object { $_.AppRoleId -eq $AppRoleId }
    if (-not $assigned) {
        $params = @{
            principalId = $acgServicePrincipal.Id
            resourceId = $projectSynergyEnterpriseApplication.Id
            appRoleId = $appRoleId
        }
        New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id -BodyParameter $params
    }
}

# Check the assigned roles
Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
  10. لإنهاء جلسة العمل الحالية، اقطع الاتصال من Microsoft Graph. 
    Disconnect-MgGraph

توفير معلومات إضافية لفريق الإلحاق

إشعار

هذه الخطوة مطلوبة لإعدادك كمشغل في بيئات Teams الهاتف Mobile (TPM) توصيل المشغل (OC). تخطي هذه الخطوة إذا كنت قد تم إلحاقك بالفعل ب TPM أو OC.

قبل أن يتمكن فريق الإلحاق من الانتهاء من إلحاقك ببيئات توصيل المشغل و/أو Teams الهاتف Mobile، تحتاج إلى تزويدهم ببعض المعلومات الإضافية.

  1. انتظر حتى يوفر لك فريق الإلحاق نموذجا لجمع المعلومات الإضافية.
  2. أكمل النموذج وأعطه لفريق الإلحاق.
  3. انتظر حتى يؤكد فريق الإلحاق اكتمال عملية الإلحاق.

إذا لم يكن لديك فريق إلحاق بالفعل، فاتصل azcog-enablement@microsoft.comب ، مع توفير معرف اشتراك Azure وتفاصيل الاتصال.

اختبار الوصول إلى مدخل توصيل المشغل

هام

قبل اختبار الوصول إلى مدخل توصيل المشغل، انتظر حتى يؤكد فريق الإلحاق اكتمال عملية الإلحاق.

انتقل إلى الصفحة الرئيسية توصيل المشغل وتحقق من قدرتك على تسجيل الدخول.

إضافة معرفات التطبيق لبوابة اتصالات Azure إلى توصيل المشغل

يجب تمكين Azure Communications Gateway ضمن بيئة توصيل المشغل أو Teams الهاتف Mobile. تتطلب هذه العملية تكوين بيئتك باستخدام معرفين للتطبيق:

  • معرف التطبيق للهوية المدارة المعينة من قبل النظام التي وجدتها في البحث عن معرف التطبيق لمورد Azure Communication Gateway. يسمح معرف التطبيق هذا لبوابة اتصالات Azure باستخدام الأدوار التي قمت بإعدادها في إعداد أدوار التطبيق لبوابة اتصالات Azure.
  • معرف تطبيق قياسي لتطبيق مؤسسة AzureCommunicationsGateway تم إنشاؤه تلقائيا. هذا المعرف هو دائما 8502a0ec-c76d-412f-836c-398018e2312b.

لإضافة معرفات التطبيق:

  1. سجل الدخول إلى مدخل توصيل المشغل.
  2. أضف معرف تطبيق جديدا لمعرف التطبيق الذي عثرت عليه للهوية المدارة.
  3. أضف معرف تطبيق ثان للقيمة 8502a0ec-c76d-412f-836c-398018e2312b.

تسجيل اسم مجال النشر الخاص بك في Microsoft Entra

يرسل Microsoft Teams نسبة استخدام الشبكة فقط إلى المجالات التي تؤكد امتلاكك لها. يتلقى توزيع Azure Communications Gateway تلقائيا اسم مجال مؤهل بالكامل تم إنشاؤه تلقائيا (FQDN). تحتاج إلى إضافة اسم المجال هذا إلى مستأجر Microsoft Entra كاسم مجال مخصص، ومشاركة التفاصيل مع فريق الإلحاق ثم التحقق من اسم المجال. تؤكد هذه العملية أنك تملك المجال.

  1. انتقل إلى نظرة عامة على مورد Azure Communications Gateway وحدد Properties. ابحث عن الحقل المسمى Domain. هذا الاسم هو اسم مجال النشر الخاص بك.
  2. أكمل الإجراء التالي: إضافة اسم المجال المخصص إلى معرف Microsoft Entra.
  3. شارك معلومات سجل DNS TXT مع فريق الإلحاق. انتظر حتى يؤكد فريق الإلحاق أن سجل DNS TXT قد تم تكوينه بشكل صحيح.
  4. أكمل الإجراء التالي: تحقق من اسم المجال المخصص.

الخطوة التالية

الاستعداد لحركة المرور المباشرة باستخدام توصيل المشغل وTeams الهاتف Mobile