Console d'opérateur dans Microsoft Teams

À quoi cela sert

La console d'opérateur peut être intégrée à Microsoft Teams en tant qu'application personnelle. L'opérateur l'ouvre dans la barre d'applications de Teams et se connecte avec le compte Teams actif. Le mot de passe n'est pas transmis à EasyUC. Teams charge la page de la console d'opérateur depuis votre propre serveur EasyUC.

L'application est interne au tenant. Chaque exploitant gère sa propre inscription d'application Entra et charge son propre package d'application dans Teams. Il n'y a pas de publication dans le Teams Store public.

La question de savoir quel appareil l'opérateur utilise pour téléphoner est indépendante de ce qui précède. L'application Microsoft Teams et un téléphone de bureau Teams sont disponibles comme appareils. Avec les deux, l'opérateur répond à l'appel dans Teams.

Prérequis

Modules de licence acd et teams.
Un nom DNS complet (FQDN) pour EasyUC et HTTPS sur le port 443 avec une chaîne de certificats reconnue par Teams et par les navigateurs. Les simples adresses IP et les certificats auto-signés ne conviennent pas pour un onglet Teams.
Des pages contenant une politique de confidentialité et des conditions d'utilisation, accessibles via HTTPS.
Dans Microsoft Entra : l'autorisation de créer une inscription d'application. Dans le Teams admin center : l'autorisation de charger et d'approuver une application personnalisée.
Un tenant Teams connecté dans EasyUC. Les opérateurs sont affectés à la console avec leur Teams account (UPN) ou avec un appareil Teams.
Le package d'application est généré avec un outil fourni avec le produit. Contactez le fabricant ou votre administrateur système à ce sujet.

Pas à pas : inscrire l'application Entra

Dans le Microsoft Entra admin center, ouvrez Identity → Applications → App registrations → New registration.
Saisissez un nom, par exemple EasyUC Attendant, et sélectionnez Accounts in this organizational directory only. Ne saisissez pas d'URI de redirection.
Notez Directory (tenant) ID et Application (client) ID.
Dans le manifeste de l'application, définissez la valeur requestedAccessTokenVersion sous api sur 2.
Sous Expose an API, créez l'URI d'ID d'application api://<fqdn>/<client-id>.
Créez l'étendue déléguée access_as_user (consentement des administrateurs et des utilisateurs, activée).
Sous Authorized client applications, saisissez les deux clients Teams de Microsoft (Teams bureau/mobile et Teams web) et autorisez l'étendue pour eux.

Pas à pas : charger et approuver le package d'application

Faites générer le package d'application pour votre nom d'hôte et votre ID client. Il contient exactement manifest.json, color.png et outline.png, et ni mots de passe ni secrets client.
Ouvrez le Teams admin center, puis Teams apps → Manage apps.
Cliquez sur Actions → Upload new app et chargez le fichier ZIP.
Approuvez l'application pour le groupe d'opérateurs. Elle apparaît sous Built for your org.
Si nécessaire, utilisez une stratégie de configuration pour installer l'application automatiquement et l'épingler dans la barre d'applications.

Pas à pas : se connecter à Teams et répondre aux appels

Dans Teams, ouvrez l'application EasyUC Attendant. La page affiche Attendant console in Microsoft Teams.
Cliquez sur Sign in with Teams. EasyUC utilise votre connexion Teams active.
Sélectionnez votre appareil, par exemple Microsoft Teams (softphone), et cliquez sur Start.
Lorsqu'un appel apparaît, répondez-y dans Microsoft Teams. La console affiche Please answer in Microsoft Teams. à cet effet.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Application ID URI	`api://<fqdn>/<client-id>`. Doit correspondre exactement à la valeur du package d'application.
Scope	`access_as_user`. La connexion au serveur EasyUC ne nécessite ni autorisation Microsoft Graph ni secret client.
App package	Étendue d'installation personnelle, manifeste conforme au schéma Teams 1.22. Pour une mise à jour, utilisez le même ID client et augmentez le numéro de version.
Sign in with Microsoft	Dans le navigateur, en dehors de Teams : connexion via une fenêtre Microsoft ou un code de connexion. Si plusieurs organisations existent, sélectionnez la vôtre sous Microsoft organization.
Device Microsoft Teams app	Répondez dans Microsoft Teams. Teams fait sonner l'utilisateur : tous les appareils Teams de ce compte sonnent en même temps.
Device Microsoft Teams desk phone	Répondez sur le téléphone Teams. Téléphone de bureau certifié Teams, connecté avec le compte de l'opérateur.
Paths	La vue d'ensemble et la liste de contrôle indiquent, pour chaque chemin, quels appels parviennent à un appareil Teams. Après avoir répondu à un appel Teams, l'opérateur commande la mise en attente, le raccrochage et le transfert dans le client Teams.

Vérifier le résultat et circonscrire les erreurs

L'application ouvre la console d'opérateur dans Teams, et après Sign in with Teams, la sélection de l'appareil apparaît.
The attendant console could not be initialized in Microsoft Teams. Please reopen it in Teams. La page n'a pas été chargée depuis Teams, ou l'intégration est bloquée. Vérifiez le nom d'hôte et le certificat.
Sign-in with your Microsoft Teams account failed. Please try again. Vérifiez l'URI d'ID d'application, l'étendue et les applications clientes autorisées.
This Microsoft account is not enabled for the attendant console. Le compte n'est affecté à aucun opérateur. Saisissez le compte Teams pour l'opérateur.
Microsoft sign-in has not been fully configured yet. Please contact your administrator. ou No organization has been configured for Microsoft sign-in yet.
The Microsoft sign-in window was blocked. Allow pop-ups for EasyUC and try again.
La page reste vide dans Teams : le serveur web ne doit pas interdire l'intégration par Teams. EasyUC ne l'autorise que pour la page d'entrée de la console d'opérateur ; un proxy en amont ne doit pas écraser l'en-tête.
Les appels ne sont pas remis alors que l'opérateur est prêt : désactivez la Voicemail et le renvoi sur non-réponse pour l'utilisateur Teams et vérifiez le chemin vers les appareils Teams dans la liste de contrôle.