Interoperabilidad de Teams: llamar

Artículo
02/03/2024

Importante

La funcionalidad descrita en este artículo se encuentra actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin un Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Como parte de esta versión preliminar, los SDK de Azure Communication Services se pueden usar para crear aplicaciones que permiten a los usuarios traer su propia identidad (BYOI) para iniciar llamadas 1:1 con usuarios de Teams. A estos usuarios se les aplican los precios estándar de Azure Communication Services, pero no hay ninguna tarifa adicional por la funcionalidad de interoperabilidad. Las aplicaciones personalizadas creadas con Azure Communication Services para conectarse y comunicarse con usuarios de Teams o aplicaciones de voz de Teams las pueden usar los usuarios finales o los bots, y no hay ninguna diferencia en cómo aparecen a los usuarios de Teams en las aplicaciones de Teams, a menos que el desarrollador de la aplicación indique explícitamente un nombre para mostrar.

Para habilitar la llamada entre los usuarios de Communication Services y el inquilino de Teams, permita al inquilino a través del formulario y habilite la conexión entre el inquilino y el recurso de Communication Services.

Habilitar interoperabilidad en el inquilino de Teams

El usuario de Microsoft Entra con el rol de administrador de Teams puede ejecutar el cmdlet de PowerShell con el módulo de MicrosoftTeams para habilitar el recurso de Communication Services en el inquilino.

1. Preparar el módulo de Microsoft Teams

En primer lugar, abra PowerShell y valide la existencia del módulo de Teams con el siguiente comando:

Get-module *teams*

Si no ve el módulo MicrosoftTeams, instálelo primero. Para instalar el módulo debe ejecutar PowerShell como administrador. Luego, ejecute el siguiente comando:

	Install-Module -Name MicrosoftTeams

Se le informará sobre los módulos que se instalarán, que puede confirmar con una respuesta Y o A. Si el módulo está instalado pero no está actualizado, puede ejecutar el siguiente comando para actualizar el módulo:

	Update-Module MicrosoftTeams

2. Conexión al módulo de Microsoft Teams

Cuando el módulo esté instalado y listo, puede conectarse al módulo MicrosoftTeams con el siguiente comando. Se le pedirá que inicie sesión con una ventana interactiva. La cuenta de usuario que va a usar debe tener permisos de administrador de Teams. De lo contrario, puede obtener una respuesta access denied en los pasos siguientes.

Connect-MicrosoftTeams

3. Habilitar la configuración del inquilino

La interoperabilidad con los recursos de Communication Services se controla mediante la configuración de inquilinos y la directiva asignada. El inquilino de Teams tiene una configuración de inquilino único y los usuarios de Teams tienen asignada directiva global o directiva personalizada. Para más información, consulte Asignación de directivas en Teams.

Después de iniciar sesión correctamente, puede ejecutar el cmdlet Set-CsTeamsAcsFederationConfiguration para habilitar el recurso de Communication Services en el inquilino. Reemplace el texto IMMUTABLE_RESOURCE_ID por un identificador de recurso inmutable en el recurso de comunicación. Puede encontrar más detalles sobre cómo obtener esta información aquí.

$allowlist = @('IMMUTABLE_RESOURCE_ID')
Set-CsTeamsAcsFederationConfiguration -EnableAcsUsers $True -AllowedAcsResources $allowlist

4. Habilitar una directiva de inquilino

A cada usuario de Teams se le ha asignado un External Access Policy que determina si los usuarios de Communication Services pueden llamar a este usuario de Teams. Use el cmdlet Set-CsExternalAccessPolicy para asegurarse de que la directiva asignada al usuario de Teams ha establecido EnableAcsFederationAccess en $true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Obtención del identificador de usuario de Teams

Para iniciar una llamada con un usuario de Teams o una aplicación de Voz de Teams, necesita un identificador del destino. Tiene las siguientes opciones para recuperar el identificador:

Interfaz de usuario de Microsoft Entra ID o con sincronización de directorios local de Microsoft Entra Connect
Mediante programación a través de Microsoft Graph API

Llamar

Con el SDK de llamadas, un usuario o un punto de conexión de Communication Services pueden iniciar una llamada 1:1 con usuarios de Teams, identificados por su identificador de objeto de Microsoft Entra. Puede modificar fácilmente una aplicación existente que llame a otros usuarios de Communication Services para que llame a un usuario de Teams.

Administración de llamadas: una guía paso a paso sobre Azure Communication Services en Microsoft Docs

Llamada a otro punto de conexión de Communication Services mediante communicationUserId:

const acsCallee = { communicationUserId: '<Azure Communication Services User ID>' }
const call = callAgent.startCall([acsCallee]);

Llamada a un usuario de Teams mediante microsoftTeamsUserId:

const teamsCallee = { microsoftTeamsUserId: '<Teams User AAD Object ID>' }
const call = callAgent.startCall([teamsCallee]);

Eventos de llamadas de voz y videollamadas

Eventos de llamadas de voz y vídeo de Communication Services que se generan para las llamadas entre un usuario de Communication Services y usuarios de Teams.

Limitaciones y problemas conocidos

Esta funcionalidad no está disponible actualmente en el SDK de llamadas para .NET.
Los usuarios de Teams deben estar en modo "TeamsOnly". Los usuarios de Skype Empresarial no pueden recibir llamadas 1:1 de usuarios de Communication Services.
No se admite la conversión a una llamada de grupo.
La grabación de llamadas de Communication Services no está disponible para las llamadas 1:1.
No se admiten funcionalidades avanzadas de enrutamiento de llamadas, como el reenvío de llamadas, la respuesta de llamadas en grupo, la llamada simultánea y el correo de voz.
Los usuarios de Teams no pueden establecer usuarios de Communication Services como destinos de reenvío o transferencia.
Muchas características del cliente de Teams no funcionan según lo previsto durante las llamadas de 1:1 a los usuarios de Communication Services.
No se admiten dispositivos de Teams de terceros ni teléfonos IP de Skype.

Privacidad

La interoperabilidad entre Azure Communication Services y Microsoft Teams permite que las aplicaciones y los usuarios participen en llamadas y reuniones. Es su responsabilidad asegurarse de que se notifica a los usuarios de la aplicación cuando se habilita la grabación o la transcripción en una llamada o reunión de Teams.

Microsoft indicará a través de la API de Azure Communication Services que ha comenzado la grabación o transcripción. Debe comunicar este hecho en tiempo real a los usuarios dentro de la interfaz de usuario de la aplicación. Acepta la compensación de Microsoft por todos los costos y daños incurridos como resultado de su incumplimiento de esta obligación.

Compartir vía