Interopérabilité de Teams : les appels

Dans le cadre de cette préversion, les kits de développement logiciel (SDK) Azure Communication Services peuvent être utilisés pour créer des applications qui permettent aux utilisateurs BYOI (bring your own identity) de démarrer des appels 1:1 avec des utilisateurs Teams. La tarification Standard d’Azure Communication Services s’applique à ces utilisateurs, mais aucuns frais supplémentaires ne sont facturés pour la capacité d’interopérabilité. Les applications personnalisées créées avec Azure Communication Services pour se connecter et communiquer avec les utilisateurs Teams ou les applications vocales Teams peuvent être utilisées par des utilisateurs finaux ou par des bots, et il n’y a aucune différence dans la façon dont elles sont présentées aux utilisateurs Teams dans les applications Teams, sauf si le développeur de l’application l’indique explicitement par un nom d’affichage.

Pour activer l’appel entre vos utilisateurs Azure Communication Services et votre tenant Teams, autorisez votre tenant via le formulaire et activez la connexion entre le tenant et la ressource Communication Services.

Activer l’interopérabilité dans votre locataire Teams

Un utilisateur Microsoft Entra avec un rôle Administrateur Teams peut exécuter la cmdlet PowerShell avec le module Microsoft Teams pour activer la ressource Communication Services dans le locataire.

1. Préparer le module Microsoft Teams

Tout d’abord, ouvrez PowerShell et vérifiez l’existence du module Teams avec la commande suivante :

Get-module *teams* 

Si vous ne voyez pas le module MicrosoftTeams, installez-le d’abord. Pour installer le module, vous devez exécuter PowerShell en tant qu’administrateur. Exécutez ensuite la commande suivante :

	Install-Module -Name MicrosoftTeams

Vous êtes alors informé des modules à installer, que vous pouvez confirmer avec une réponse Y ou A. Si le module est installé mais obsolète, vous pouvez exécuter la commande suivante pour mettre à jour le module :

	Update-Module MicrosoftTeams

2. Se connecter au module Microsoft Teams

Une fois le module installé et prêt, vous pouvez vous connecter au module MicrosftTeams avec la commande suivante. Une fenêtre interactive vous invite à vous connecter. Le compte d’utilisateur que vous utilisez doit avoir des autorisations d’administrateur Teams. Sinon, vous pouvez obtenir une réponse access denied aux étapes suivantes.

Connect-MicrosoftTeams

3. Activer la configuration du locataire

L’interopérabilité avec les ressources Communication Services est contrôlée par la configuration du locataire et la stratégie attribuée. Le locataire Teams a une seule configuration de locataire, et les utilisateurs Teams ont une stratégie générale ou une stratégie personnalisée attribuée. Pour plus d’informations, consultez Attribuer des stratégies dans Teams.

Une fois connecté, vous pouvez exécuter l’applet de commande Set-CsTeamsAcsFederationConfiguration pour activer la ressource Communication Services dans votre locataire. Remplacez le texte IMMUTABLE_RESOURCE_ID par un ID de ressource immuable dans votre ressource de communication. Plus de détails sur l’obtention de ces informations sont disponibles ici.

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

4. Activer une stratégie de locataire

Chaque utilisateur Teams a une External Access Policy attribuée qui détermine si les utilisateurs Communication Services peuvent appeler cet utilisateur Teams. Utilisez l’applet de commande Set-CsExternalAccessPolicy pour vérifier que la stratégie attribuée à l’utilisateur Teams a défini EnableAcsFederationAccess sur $true

Set-CsExternalAccessPolicy -Identity Global -EnableAcsFederationAccess $true

Obtenir l’ID d’utilisateur Teams

Pour démarrer un appel avec un utilisateur Teams ou une application Teams Voice, vous avez besoin d’un identificateur de la cible. Vous disposez des options suivantes pour récupérer l’ID :

• Interface utilisateur de Microsoft Entra ID ou avec une synchronisation d’annuaire locale Microsoft Entra Connect
• De manière programmatique via l’API Microsoft Graph

Appel

Avec le kit de développement logiciel (SDK) d’appel, un utilisateur ou un point de terminaison Communication Services peut démarrer un appel 1:1 avec des utilisateurs Teams, identifiés par leur ID d’objet Microsoft Entra. Vous pouvez facilement modifier une application existante qui appelle d’autres utilisateurs Communication Services pour qu’elle appelle des utilisateur Teams.

Gérer les appels - Guide pratique d’Azure Communication Services | Microsoft Docs

Appel d’un autre point de terminaison Communication Services à l’aide de communicationUserId :

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

Appel d’un utilisateur Teams à l’aide de microsoftTeamsUserId :

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

Événements d’appel vocal et vidéo

Les événements d’appel vocal et vidéo de Communication Services sont déclenchés pour les appels entre un utilisateur de Communication Services et des utilisateurs de Teams.

Limitations et problèmes connus

• Cette fonctionnalité n’est actuellement pas disponible dans le kit de développement logiciel (SDK) d’appel .NET.
• Les utilisateurs Teams doivent être en mode « TeamsOnly ». Les utilisateurs Skype Entreprise ne peuvent pas recevoir d’appels un à un d’utilisateurs Communication Services.
• L’escalade vers un appel de groupe n’est pas prise en charge.
• L’enregistrement des appels Communication Services n’est pas disponible pour les appels un à un.
• Les fonctionnalités avancées de routage des appels, comme le transfert d’appels, le décroché des appels groupés, la sonnerie simultanée et la messagerie vocale, ne sont pas prises en charge.
• Les utilisateurs Teams ne peuvent pas définir les utilisateurs Communication Services comme cibles de transfert.
• De nombreuses fonctionnalités du client Teams ne fonctionnent pas comme attendu pendant les appels 1:1 avec les utilisateurs de Communication Services.
• Les appareils pour Teams et téléphones IP Skype tiers ne sont pas pris en charge.

Confidentialité

L’interopérabilité entre Azure Communication Services et Microsoft Teams permet à vos applications et à vos utilisateurs de participer à des appels et à des réunions Teams. Il vous incombe de vous assurer que les utilisateurs de votre application sont avertis quand l’enregistrement ou la transcription sont activés dans le cadre d’un appel ou d’une réunion Teams.

Microsoft indiquera via l’API Azure Communication Services que l’enregistrement ou la transcription a commencé. Vous devez communiquer ce fait en temps réel à vos utilisateurs dans l’interface utilisateur de votre application. Vous acceptez d’indemniser Microsoft pour tous les coûts et dommages résultant de votre non-respect de cette obligation.