Comparteix a través de

Conectar Azure Communications Gateway a Operator Connect o Teams Phone Mobile

  • Article

Después de implementar Azure Communications Gateway y conectarlo a la red principal, deberá conectarlo al sistema telefónico de Microsoft. También deberá incorporarlo a los entornos de Operator Connect o Teams Phone Mobile.

En este artículo se describe cómo configurar de Azure Communications Gateway para Operator Connect y Teams Phone Mobile. Después de finalizar los pasos de este artículo, prepárese para el tráfico en directo con Operator Connect, Teams Phone Mobile y Azure Communications Gateway.

Sugerencia

En este artículo se da por supuesto que el equipo de incorporación de Azure Communications Gateway de Microsoft también le está incorporando a Operator Connect o Teléfono Teams para dispositivos móviles. Si eligió un asociado de incorporación diferente para Operator Connect o Teams Phone Mobile, deberá pedirle que se ocupe de los cambios en los entornos de Operator Connect o Teams Phone Mobile.

Requisitos previos

Es necesario implementar Azure Communications Gateway.

Deberá tener acceso a una cuenta de usuario con el rol Administrador global de Microsoft Entra.

Debe asignar números de prueba de "comprobación del servicio". Estos números se usan por los programas Operator Connect y Teams Phone Mobile para realizar pruebas continuas de llamadas. Las implementaciones de producción necesitan seis números para cada servicio. Las implementaciones de laboratorio necesitan tres números para cada servicio.

  • Si seleccionó el servicio que va a configurar como parte de la implementación de Azure Communications Gateway, ya habrá asignado números para el servicio.
  • De lo contrario, elija los números de teléfono ahora (en formato E.164 e incluyendo el código de país) y los nombres para identificarlos. Se recomiendan los nombres del formulario OC1 y OC2 (para Operator Connect), así como TPM1 y TPM2 (para Teams Phone Mobile).

También será necesario asignar al menos un número de prueba para cada servicio para las pruebas de integración.

Si desea configurar Teams Phone Mobile y no lo seleccionó al implementar Azure Communications Gateway, elija:

  • El número usado en Teams Phone Mobile para acceder a la respuesta interactiva de voz de mensajería de voz (IVR) desde los marcadores nativos.

  • El método para enrutar llamadas de Teams Phone Mobile al sistema telefónico de Microsoft. Elija entre las siguientes opciones:

    • MCP integrado (MCP en Azure Communications Gateway).
    • MCP local.
    • Otro método para enrutar llamadas.

Habilitar el servicio de asistencia de Operator Connect o Teams Phone Mobile

Nota:

Si seleccionó Operator Connect o Teams Phone Mobile al implementar Azure Communications Gateway, omita este paso y vaya a Agregar la aplicación Project Synergy al inquilino de Azure.

  1. Inicie sesión en Azure Portal.
  2. En la barra de búsqueda de la parte superior de la página, busque el recurso de Communications Gateway y selecciónelo.
  3. En la barra de menús lateral, en Servicios de comunicaciones, seleccione Operator Connect o Teams Phone Mobile (según corresponda) para abrir una página para el servicio.
  4. Seleccione Configuración de Operator Connect o Configuración de Teams Phone Mobile.
  5. Rellene los campos y, a continuación, seleccione Revisar y crear y Crear.
  6. Seleccione la página Información general del recurso.
  7. Seleccione Agregar líneas de prueba y agregue las líneas de comprobación de servicio que eligió en Requisitos previos. Establezca el Propósito de prueba en Automático.

    Importante

    No agregue los números para las pruebas de integración. Configurará números para las pruebas de integración al realizar pruebas de integración y prepararse para el tráfico en directo.

  8. Espere a que el recurso se actualice. Cuando el recurso esté listo, el campo Estado de aprovisionamiento de la información general del recurso cambiará a "Completado". Se recomienda iniciar sesión periódicamente para ver si el campo Estado de aprovisionamiento se establece en "Completado". Este paso podría tardar hasta dos semanas.

Adición de la aplicación Project Synergy al inquilino de Azure

Antes de iniciar este paso, compruebe que el campo Estado de aprovisionamiento del recurso se establezca en "Completado".

Nota:

Este paso y el paso siguiente (Asignar un usuario administrador a la aplicación Project Synergy) lo configurarán como operador en los entornos de Teams Phone Mobile y Operator Connect. Si ya ha llevado a cabo la incorporación, vaya a Buscar el identificador de aplicación del recurso de Azure Communication Gateway.

Los programas Operator Connect y Teams Phone Mobile requieren que el inquilino de Microsoft Entra contenga una aplicación de Microsoft denominada Project Synergy. Operator Connect y Teams Phone Mobile heredan permisos e identidades del inquilino de Microsoft Entra a través de la aplicación Project Synergy. La aplicación Project Synergy también permite la configuración de Operator Connect o Teams Phone Mobile y la asignación de usuarios y grupos a roles específicos.

Para agregar la aplicación Project Synergy:

  1. Compruebe si el módulo Microsoft Entra ID (AzureAD) está instalado en PowerShell. Instálelo si fuera necesario.
    1. Abra PowerShell.
    2. Ejecute el comando siguiente y compruebe si AzureAD aparece en la salida. 
      Get-Module -ListAvailable
    3. Si AzureAD no apareciera en la salida, instale el módulo.
      1. Cierre la ventana actual de PowerShell.
      2. Abra PowerShell como administrador.
      3. Ejecute el siguiente comando: 
        Install-Module AzureAD
      4. Cierre la ventana de administración de PowerShell.
  2. Inicie sesión en Azure Portal como Administrador global de Microsoft Entra.
  3. Seleccione Microsoft Entra ID.
  4. Seleccionar Propiedades.
  5. Desplácese hacia abajo hasta el campo Id. de inquilino. El identificador de inquilino aparece en el cuadro. Anote el id. de inquilino.
  6. Abra PowerShell.
  7. Ejecute el siguiente cmdlet y reemplace <TenantID> por el id. de inquilino que anotó en el paso 5. 
    Connect-AzureAD -TenantId "<TenantID>"
New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"

Asignación de un usuario administrador a la aplicación Project Synergy

El usuario que configure Azure Communications Gateway deberá tener el rol de usuario Administrador en la aplicación Project Synergy. Asígneles este rol en Azure Portal.

  1. En Azure Portal, vaya a Microsoft Entra ID y, luego, Aplicaciones empresariales usando el menú de la izquierda. Como alternativa, puede buscar Aplicaciones empresariales en la barra de búsqueda; se encuentra en el encabezado secundario Servicios.
  2. Establezca el filtro Tipo de aplicación en Todas las aplicaciones mediante el menú desplegable.
  3. Seleccione Aplicar.
  4. Busque Project Synergy usando la barra de búsqueda. Debería aparecer la aplicación.
  5. Seleccione la aplicación Project Synergy.
  6. Seleccione Usuarios y grupos en el menú de la izquierda.
  7. Seleccione Agregar usuario o grupo.
  8. Especifique el usuario que deba configurar Azure Communications Gateway y asígnele el rol Administrador.

Precaución

No cambie ninguna de las siguientes configuraciones de Operator Connect en el inquilino (ya sea a través del portal de configuración de Operator Connect o a través de las API de Operator Connect).

  • Perfiles de llamada con un sufijo CommsGw en el portal de configuración o NameSuffix en las API de Operator Connect
  • Troncos con FQDN que acaban en .commsgw.azure.com

Administramos esta configuración por usted. Es probable que la edición de esta configuración cause problemas con el servicio Azure Communications Gateway.

Busque el identificador de aplicación del recurso de Azure Communication Gateway

Cada recurso de Puerta de enlace de comunicaciones de Azure recibe automáticamente una identidad administrada asignada por el sistema, que Puerta de enlace de comunicaciones de Azure usa para conectarse a la API Operator Connect. Es necesario encontrar el identificador de aplicación de la identidad administrada, de modo que pueda conectar Azure Communications Gateway a la API Operator Connect en Configuración de roles de aplicación para Azure Communications Gateway y Agregar los identificadores de aplicación para Azure Communications Gateway a Operator Connect.

  1. Inicie sesión en Azure Portal.
  2. Si aún no conoce el nombre del recurso de Puerta de enlace de comunicaciones de Azure, busque Puerta de enlace y anote el nombre del recurso.
  3. Busque el nombre del recurso de Puerta de enlace. Debería ver una aplicación empresarial con ese valor en el subtítulo Microsoft Entra ID. Es posible que tenga que seleccionar Continuar buscando en Microsoft Entra ID para encontrarlo.
  4. Seleccione la aplicación empresarial.
  5. Compruebe que el Nombre coincida con el nombre del recurso de Communications Gateway.
  6. Anote el id. de la aplicación.

Configuración de los roles de aplicación para Azure Communications Gateway

Azure Communications Gateway contiene servicios que necesitan acceder a la API de Operator Connect en su nombre. Para habilitar este acceso, es necesario conceder roles de aplicación específicos a la identidad administrada asignada por el sistema para Azure Communications Gateway en la aplicación empresarial Project Synergy. Creó la aplicación empresarial Project Synergy en Agregar la aplicación Project Synergy al inquilino de Azure.

Debe realizar este paso una vez para cada recurso de Puerta de enlace de comunicaciones de Azure que quiera usar para Operator Connect o Teléfono Teams móvil.

Importante

La concesión de permisos tiene dos partes: configurar la identidad administrada asignada por el sistema para Azure Communications Gateway con los roles adecuados (este paso) y agregar el id. de aplicación de la identidad administrada al entorno de Operator Connect o Teams Phone Mobile. Más adelante, agregará el id. de la aplicación al entorno de Operator Connect o Teams Phone Mobile, en Agregar los id. de aplicación para Azure Communications Gateway a Operator Connect.

Siga estos pasos en el inquilino que contenga la aplicación Project Synergy.

  1. Compruebe si el módulo Microsoft Graph (Microsoft.Graph) está instalado en PowerShell. Instálelo si fuera necesario.
    1. Abra PowerShell.
    2. Ejecute el comando siguiente y compruebe si Microsoft.Graph aparece en la salida. 
      Get-Module -ListAvailable
    3. Si Microsoft.Graph no apareciera en la salida, instale el módulo.
      1. Cierre la ventana actual de PowerShell.
      2. Abra PowerShell como administrador.
      3. Ejecute el siguiente comando: 
        Install-Module -Name Microsoft.Graph -Scope CurrentUser
      4. Cierre la ventana de administración de PowerShell.
  2. Inicie sesión en Azure Portal como Administrador global de Microsoft Entra.
  3. Seleccione Microsoft Entra ID.
  4. Seleccionar Propiedades.
  5. Desplácese hacia abajo hasta el campo Id. de inquilino. El identificador de inquilino aparece en el cuadro. Anote el id. de inquilino.
  6. Abra PowerShell.
  7. Ejecute el siguiente cmdlet y reemplace <TenantID> por el id. de inquilino que anotó en el paso 5. 
    Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
    Si se le pide que conceda permisos para herramientas de línea de comandos de Microsoft Graph, seleccione Aceptar para conceder permisos.
  8. Ejecute el siguiente cmdlet y reemplace <CommunicationsGatewayName> por el nombre del recurso de Puerta de enlace de comunicaciones de Azure. 
    $acgName = "<CommunicationsGatewayName>"
  9. Ejecute los comandos de PowerShell siguientes. Estos comandos agregan los siguientes roles para Azure Communications Gateway: TrunkManagement.Read, TrunkManagement.Write, partnerSettings.Read, NumberManagement.Read, NumberManagement.Write, Data.Read y 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. Para finalizar la sesión actual, desconéctese de Microsoft Graph. 
    Disconnect-MgGraph

Proporcionar información adicional al equipo de incorporación

Nota:

Este paso es necesario para configurarlo como operador en los entornos de Teams Phone Mobile and Operator Connect. Omita este paso si ha terminado de incorporarse.

Antes de que el equipo de incorporación pueda terminar de incorporarle a los entornos de Operator Connect o Teams Phone Mobile, deberá proporcionarles información adicional.

  1. Espere a que el equipo de incorporación le proporcione un formulario para recopilar la información adicional.
  2. Complete el formulario y proporcióneselo al equipo de incorporación.
  3. Espere a que el equipo de incorporación confirme que se haya completado el proceso de incorporación.

Si aún no dispusiera de equipo de incorporación, póngase en contacto con azcog-enablement@microsoft.com, proporcionando el id. de suscripción de Azure y los detalles de contacto.

Pruebe el acceso al portal de Operator Connect

Importante

Antes de probar el acceso al portal de Operator Connect, espere a que el equipo de incorporación confirme que se haya completado el proceso de incorporación.

Vaya a la página principal de Operator Connect y compruebe que pueda iniciar sesión.

Agregar los id. de aplicación para Azure Communications Gateway a Operator Connect

Es necesario habilitar Azure Communications Gateway en el entorno de Operator Connect o Teams Phone Mobile. Este proceso requiere configurar el entorno con dos id. de aplicación:

Para agregar los id. de aplicación:

  1. Inicie sesión en el portal de Operator Connect.
  2. Agregue un nuevo id. de aplicación para el id. de aplicación que encontró para la identidad administrada.
  3. Agregue un segundo id. de aplicación para el valor 8502a0ec-c76d-412f-836c-398018e2312b.

Registre el nombre de dominio de la implementación en Microsoft Entra

Microsoft Teams solo enviará tráfico a aquellos dominios que confirme que posea. La implementación de Azure Communications Gateway recibe automáticamente un nombre de dominio completo (FQDN) generado automáticamente. Es necesario agregar este nombre de dominio al inquilino de Microsoft Entra como nombre de dominio personalizado, compartir los detalles con el equipo de incorporación y, a continuación, comprobar el nombre de dominio. Este proceso confirma que posee el dominio.

  1. Vaya a Información general del recurso Azure Communications Gateway y seleccione Propiedades. Busque el campo denominado Dominio. Este nombre es el nombre de dominio de la implementación.
  2. Complete el procedimiento siguiente: Agregue el nombre de dominio personalizado a Microsoft Entra ID.
  3. Comparta la información de registro TXT de DNS con el equipo de incorporación. Espere a que el equipo de incorporación confirme que el registro TXT de DNS se haya configurado correctamente.
  4. Complete el procedimiento siguiente: Compruebe el nombre de dominio personalizado.

Paso siguiente

Preparación del tráfico en directo con Operator Connect y Teams Phone Mobile