Operator Connect via le renvoi Teams

À quoi cela sert

Avec Operator Connect, le numéro de téléphone public reste chez l’opérateur, qui le livre directement dans Microsoft Teams, et non au SBC EasyUC. Pour qu’un appel vers un tel numéro atteigne tout de même un script EasyUC, EasyUC propose l’entrée d’appel Operator Connect through Teams forwarding.

Le trajet : l’appelant compose le numéro Operator Connect. Celui-ci est attribué à un compte de service Teams qui renvoie immédiatement chaque appel vers un numéro pilote Direct Routing. Le numéro pilote figure dans la route vocale d’EasyUC, si bien que l’appel arrive au SBC par le trunk. Le SBC lit dans le History-Info de l’appel quel numéro a été composé à l’origine et associe l’appel au bon script.

Le script peut être un script ACD ou la file d’attente d’un poste opérateur. Un Microsoft Teams Auto Attendant n’intervient pas. EasyUC peut vérifier les réglages requis sur le compte de service et les appliquer lui-même par Teams PowerShell.

Prérequis

Module de licence teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas.
Rôle EasyUC Teams avec les sous-droits SCRIPTS (ROLE_APP_TEAMS_SCRIPTS) et SCRIPTS bearbeiten (ROLE_APP_TEAMS_SCRIPTS_EDIT).
Direct Routing avec le SBC EasyUC fonctionne pour ce tenant, et au moins un script est joignable depuis Teams.
EasyUC est connecté à Teams PowerShell ou une app registration est enregistrée.
Un numéro Operator Connect qui peut être attribué à un utilisateur. Un numéro de service pour comptes de ressources ne convient pas.
Pour chaque numéro Operator Connect, un compte de service Teams dédié avec une licence Teams Phone et Enterprise Voice, auquel le numéro est attribué.
La politique d’appel du compte de service autorise le renvoi vers des numéros de téléphone. EasyUC ne vérifie pas ce point ; contrôlez-le dans Teams.
Un numéro Direct Routing libre comme numéro pilote. Il n’est attribué à aucun utilisateur ni aucune ressource et ne relève d’aucune règle pour numéros non attribués.
La politique de routage vocal globale du tenant ne contient pas l’usage PSTN d’EasyUC.

Pas à pas : configurer un script avec des numéros Operator Connect

Ouvrez le script dans le formulaire de script ou créez-le avec Create IVR.
Cochez Reachable via MS Teams et sélectionnez le Teams tenant.
Sous Call entry, sélectionnez la carte Operator Connect through Teams forwarding. Elle porte la mention not documented by Microsoft.
Sous Operator Connect numbers, choisissez un numéro dans la liste Add a number from the inventory et cliquez sur l’icône plus. S’il manque dans l’inventaire, cliquez sur Add a number by hand et saisissez le OC number.
Pour chaque numéro, vérifiez le champ Teams service account (UPN). EasyUC reprend le compte de l’inventaire ; vous pouvez le modifier à la main.
Répétez l’opération pour les autres numéros. 10 numéros au maximum par script sont autorisés.
Sous Pilot number (Direct Routing), saisissez le numéro pilote ou cliquez sur l’une des Suggestions. Les suggestions portent les libellés free, shared ou used by this script so far.
Cliquez sur Save. EasyUC ajoute le numéro pilote à la route vocale, jamais les numéros Operator Connect.

Pas à pas : vérifier et configurer le renvoi

Ouvrez la page du tenant et vérifiez que Routes in Teams affiche Up to date. Sinon, cliquez sur Update routes. Ce n’est qu’alors que le numéro pilote figure dans le motif de la route vocale.
Rouvrez le script et cliquez sur Check now. Par le service PowerShell, EasyUC lit si l’utilisateur, le numéro, la politique, le renvoi et le numéro pilote concordent. Rien n’est modifié.
Lisez les points de contrôle sous Pilot number and trunk et, pour chaque numéro, via l’icône Check items. L’état par numéro est OK, Note, Error ou not checked.
Dans la ligne d’un numéro, cliquez sur Set up forwarding.
Laissez Assign the policy (EasyUC voice routing policy) et Set forwarding (immediately to the pilot number) cochés.
Si Replace the existing forwarding apparaît, le compte renvoie déjà ailleurs. Ne cochez cette case que si ce renvoi peut être écrasé.
Cliquez sur Preview et lisez Planned steps. Si une étape est marquée blocked, rien n’est exécuté.
Cliquez sur Run et confirmez l’invite “EasyUC now changes the settings of … in Microsoft Teams. Continue?”.
Attendez « The setup is complete. » Notez l’encadré State before avec le renvoi et la politique antérieurs, pour une éventuelle restauration.
Cliquez de nouveau sur Check now. Tous les points de contrôle doivent afficher OK.
Appelez le numéro Operator Connect depuis le réseau mobile. Dans l’historique des appels, From affiche votre numéro mobile et To le numéro Operator Connect avec la mention « via pilot … ».

Pas à pas : configurer le renvoi à la main ou l’annuler

Dans le script, cliquez sur Manual setup guide. EasyUC affiche les sept étapes avec les valeurs de ce script.
Dans le centre d’administration Teams, attribuez au compte de service une politique de routage vocal avec l’usage EasyUC. Ne modifiez jamais la politique Global.
Dans le client Teams du compte de service ou dans le centre d’administration Teams, configurez le renvoi immédiat vers le numéro pilote.
Vérifiez avec Check now.
Pour annuler, rétablissez le renvoi du compte de service dans l’état indiqué sous State before et attribuez de nouveau la politique antérieure.
Faites passer le script à une autre entrée d’appel ou supprimez-le. Avec un numéro pilote partagé, la désactivation ne suffit pas.
Sur la page du tenant, cliquez sur Update routes afin qu’un numéro pilote qui n’est plus utilisé disparaisse de la route vocale.

Champs et options

Champs et options
Champ / action	Signification et utilisation
OC number	Numéro Operator Connect au format international avec un + initial, 40 caractères au maximum. 10 au maximum par script, sans doublon.
Teams service account (UPN)	Compte auquel le numéro est attribué dans Teams et qui assure le renvoi. 190 caractères au maximum. S’il diffère de l’inventaire, EasyUC signale « According to the inventory, the number is assigned to … ».
Pilot number (Direct Routing)	Numéro Direct Routing vers lequel le compte de service renvoie. Il ne doit être identique à aucun numéro Operator Connect du script. Les numéros Direct Routing non attribués n’apparaissent souvent pas dans l’inventaire ; le numéro peut être saisi librement.
Shared pilot number	Plusieurs scripts d’un tenant peuvent utiliser le même numéro pilote. Ils ne se distinguent alors que par le History-Info, et un appel direct vers le numéro pilote est rejeté.
Check now	Contrôle en lecture seule par Teams PowerShell. Avec de nombreux numéros, il peut rester incomplet ; Check the remaining numbers récupère le reste.
Check items for pilot and trunk	Pilot is in the EasyUC voice route, Pilot is not assigned to any object, Gateway sends History-Info (ForwardCallHistory), Global policy without the EasyUC usage, SBC accepts the pilot.
Check items per number	Teams user exists, OC number is assigned to the user, Enterprise Voice enabled, Teams Phone licence present, Voice routing policy contains the EasyUC usage, Forwarding enabled (immediate), Forwarding target is the pilot number, Not the Teams device of an attendant console.
Set up forwarding	Ne modifie que cet utilisateur, par le service PowerShell. La politique Global reste inchangée. Utilisable seulement après l’enregistrement du script.
Operator Connect over a public destination	Troisième carte sous Call entry, marquée comme voie transitoire. EasyUC ne mémorise que le numéro Operator Connect et un numéro de destination EasyUC public, et ne met en place aucun chemin d’exécution propre. Le renvoi doit être configuré chez l’opérateur.

Vérifier le résultat et circonscrire les erreurs

Succès : Check now affiche tous les points de contrôle comme OK, et l’appel de test vers le numéro Operator Connect atteint le script. Dans l’historique des appels, To affiche le numéro Operator Connect avec « via pilot … ».
“Please save the script first. Checks and setup use the saved state.” Enregistrez le script avant de lancer les contrôles.
“The EasyUC gateway in Teams sends no History-Info (ForwardCallHistory is off). Without it the SBC cannot match a forwarded Operator Connect number.” Cliquez sur Update routes sur la page du tenant ou activez ForwardCallHistory sur la passerelle PSTN dans Teams.
“The number … is the Teams device of an attendant console. A transfer to it would run back into EasyUC through the forwarding (call loop). Please use a dedicated service account.” Utilisez un autre compte.
“The Operator Connect number and the pilot number must differ so that no call loop arises.” Choisissez un autre numéro pilote.
“The number … is already used in this tenant (script …).” Le numéro appartient à un autre script.
“At least one step is blocked. Nothing is run.” Lisez le motif indiqué à l’étape, le plus souvent une politique tierce ou un renvoi existant.
“The PowerShell service for Microsoft Teams is not reachable.” Vérifiez le service et la connexion sur la page du tenant.
Point de contrôle Global policy without the EasyUC usage en tant que remarque : l’usage PSTN d’EasyUC est rattaché à la politique Global. Cela n’est pas recommandé pour cette voie.
L’utilisateur ou un administrateur peut modifier le renvoi à tout moment. Répétez Check now régulièrement. La liste de contrôle du poste opérateur classe en remarque un contrôle datant de plus de 7 jours.
Limites : chaque numéro Operator Connect nécessite un compte de service sous licence. Le nombre d’appels simultanés possibles sur un numéro d’utilisateur n’a pas été testé.