Rendre les scripts joignables via Microsoft Teams

À quoi cela sert

Un script peut répondre à des appels composés dans Microsoft Teams ou provenant du réseau téléphonique via Teams. L'appel parvient alors à EasyUC par le Session Border Controller intégré et suit le même déroulement d'appel qu'un appel CUCM.

Il existe trois points d'entrée. Avec Direct Routing, EasyUC gère lui-même la route vocale vers son propre SBC. Avec Operator Connect through Teams forwarding, un compte de service Teams porte le numéro Operator Connect et renvoie immédiatement vers un numéro pilote Direct Routing ; le SBC affecte l'appel au script grâce au History-Info. Avec Operator Connect over a public destination, le numéro reste chez l'opérateur et est renvoyé via le réseau téléphonique vers un numéro de destination distinct ; EasyUC ne met en place pour cela aucun chemin d'exécution propre.

Microsoft ne documente pas le chemin passant par le renvoi Teams. L'interface utilisateur le signale donc par not documented by Microsoft.

Prérequis

Module de licence teams. Pour les scripts avec un numéro CUCM, en plus cucm.
Autorisation pour les scripts : ROLE_APP_ACD_WORKSPACE avec ROLE_APP_ACD_SCRIPTS et ROLE_APP_ACD_SCRIPTS_EDIT ; sans le module ACD, ROLE_APP_TEAMS_WORKSPACE avec ROLE_APP_TEAMS_SCRIPTS et ROLE_APP_TEAMS_SCRIPTS_EDIT. Les administrateurs avec ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN ou ROLE_SUPER_ADMIN disposent de toutes les autorisations du domaine.
Un tenant Teams connecté et actif, avec SBC et Trunk configurés (chapitres "Configurer le SBC Teams" et "Tenant Teams et connexion Graph"). Sans tenant, le formulaire affiche : No Teams tenant is connected yet. Add one under Session Border Controller first.
Pour définir automatiquement la route vocale : un enregistrement d'application (app registration) au niveau du tenant. Sans lui, la route n'est définie que tant qu'un administrateur Teams est connecté sur la page du tenant.
Pour Operator Connect via le renvoi Teams : pour chaque numéro entrant, un compte de service Teams distinct avec une licence Teams Phone et Enterprise Voice, auquel le numéro Operator Connect est affecté, ainsi qu'un numéro Direct Routing libre comme pilote. ForwardCallHistory doit être activé sur la passerelle EasyUC dans Teams.

Pas à pas : Direct Routing

Ouvrez Calling Features → Calls → Calling Features et cliquez sur Edit au niveau du script.
Activez Reachable via MS Teams. Pour un script sans numéro CUCM, sélectionnez à la place Microsoft Teams only sous Reachable via en haut.
Sélectionnez le tenant sous Teams tenant.
Sélectionnez la vignette Direct Routing sous Call entry.
Saisissez le numéro au format international sous Number dialled in Teams, par exemple +49 40 1234567.
Cliquez sur Save. EasyUC définit la route vocale de ce numéro dans Teams.
Attendez le message Route in Teams set. Dans l'intervalle, Updating the route in Teams … s'affiche à cet endroit ; cela peut prendre jusqu'à deux minutes. Vous pouvez quitter la page, le résultat apparaît aussi dans la liste des scripts.

Pas à pas : Operator Connect via le renvoi Teams

Ouvrez le script avec Edit, activez Reachable via MS Teams et sélectionnez le Teams tenant.
Sélectionnez la vignette Operator Connect through Teams forwarding sous Call entry.
Ajoutez les numéros entrants sous Operator Connect numbers : avec Add a number from the inventory ou Add a number by hand. Dix numéros au maximum sont possibles par script.
Dans chaque ligne, saisissez le OC number et le Teams service account (UPN) auquel le numéro est affecté.
Sous Pilot number (Direct Routing), saisissez un numéro Direct Routing qui n'est affecté à aucun utilisateur ni à aucune ressource. Sous Suggestions, EasyUC propose des numéros pilotes libres ainsi que des numéros pilotes déjà partagés.
Cliquez sur Save. C'est toujours l'état enregistré qui est vérifié et configuré.
Cliquez sur Check now. EasyUC lit, via le service PowerShell, si l'utilisateur, le numéro, la stratégie, le renvoi et le pilote concordent. Rien n'est modifié à cette occasion.
Dans une ligne comportant une erreur ou une remarque, cliquez sur Set up forwarding.
Laissez cochés Assign the policy (EasyUC voice routing policy) et Set forwarding (immediately to the pilot number). Si l'utilisateur renvoie déjà ailleurs, définissez en plus Replace the existing forwarding.
Cliquez sur Preview, vérifiez les Planned steps et cliquez sur Run. Confirmez la question.
Cliquez de nouveau sur Check now et appelez le numéro Operator Connect depuis l'extérieur.

Pas à pas : Operator Connect via une destination publique

Ouvrez le script avec Edit, activez Reachable via MS Teams et sélectionnez le Teams tenant.
Sélectionnez la vignette Operator Connect over a public destination sous Call entry.
Sélectionnez le numéro entrant public sous Operator Connect number. Utilisez Search pour restreindre la liste.
Sous Public EasyUC destination, saisissez un numéro public distinct qui atteint déjà ce serveur EasyUC via CUCM, un fournisseur SIP ou une autre connexion RTC.
Cliquez sur Save.
Configurez le renvoi du numéro Operator Connect vers la destination EasyUC chez l'opérateur ou sur votre entrée PBX/SIP. EasyUC enregistre uniquement l'affectation au script et ne crée aucune route Direct Routing pour le numéro Operator Connect.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Reachable via MS Teams	Interrupteur. Verrouillé lorsqu'aucun tenant n'est connecté ; toujours activé pour les scripts réservés à Teams.
Teams tenant	Obligatoire. Un tenant désactivé affiche la remarque This tenant is switched off. Calls only arrive once it is active again.
Number dialled in Teams	Direct Routing uniquement. `+` suivi de l'indicatif du pays et du numéro, 7 à 16 chiffres au total, saisie de 40 caractères au maximum. Les espaces, tirets et parenthèses sont supprimés. Par tenant, un numéro mène à exactement un script.
Operator Connect numbers	Renvoi Teams uniquement. Dans chaque ligne OC number et Teams service account (UPN), plus le Status de la dernière vérification : OK, Note, Error, not checked, unknown.
Pilot number (Direct Routing)	Renvoi Teams uniquement. EasyUC l'inclut dans la route vocale, jamais le numéro Operator Connect. Un numéro pilote partagé par plusieurs scripts est possible ; les scripts ne se distinguent alors que par le History-Info, et un appel direct vers le pilote est rejeté.
Check now	Lit l'état dans Teams. Points vérifiés par numéro : l'utilisateur Teams existe, le numéro OC est affecté, Enterprise Voice est actif, la licence Teams Phone est présente, la voice routing policy contient l'usage EasyUC, le renvoi est actif (immédiat), la destination du renvoi est le numéro pilote et non un terminal Teams d'une console d'opérateur. Pour le pilote et le Trunk : le pilote figure dans la route vocale EasyUC, le pilote n'est affecté à aucun objet, la passerelle envoie le History-Info, la stratégie Global ne contient pas l'usage EasyUC, le SBC accepte le pilote.
Set up forwarding	Modifie uniquement l'utilisateur sélectionné via le service PowerShell. La stratégie Global reste inchangée. Sous State before, le résultat indique la stratégie et le renvoi précédents pour permettre le retour en arrière.
Manual setup guide	Sept étapes à suivre dans le Teams admin center si le service PowerShell ne doit pas être utilisé.
Operator Connect number	Numéro de destination public uniquement. Sélection parmi les numéros que Microsoft signale pour le tenant.
Public EasyUC destination	Numéro de destination public uniquement. Format international. Doit différer du numéro Operator Connect.

Vérifier le résultat et circonscrire les erreurs

Dans la liste des scripts, le numéro Teams avec le point d'entrée s'affiche sous le numéro. Avec le renvoi Teams, s'ajoute via pilot avec le numéro pilote et l'état de la vérification.
The route in Teams was not updated ou Updating the route in Teams failed, chacun avec un motif : ouvrez le tenant avec Open the tenant page et vérifiez l'enregistrement d'application ou la connexion de l'administrateur Teams.
Die Teams-Nummer muss im internationalen Format mit führendem + angegeben werden, zum Beispiel +49 40 1234567. (Le numéro Teams doit être indiqué au format international avec un + initial, par exemple +49 40 1234567.)
Bitte den Teams-Tenant auswählen, über den das Script erreichbar sein soll. (Veuillez sélectionner le tenant Teams par lequel le script doit être joignable.)
The Operator Connect number and the pilot number must differ so that no call loop arises.
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.
The number … is already used in this tenant (script "…"). Par tenant, un numéro mène à exactement un script.
Das EasyUC-Gateway in Teams sendet keine History-Info (ForwardCallHistory ist aus). (La passerelle EasyUC dans Teams n'envoie pas de History-Info ; ForwardCallHistory est désactivé.) Sans lui, le SBC ne peut pas affecter un numéro Operator Connect renvoyé. Activez ForwardCallHistory sur la passerelle.
The PowerShell service for Microsoft Teams is not reachable. La vérification et la configuration sont alors impossibles ; utilisez le guide de configuration manuelle.
Limites du renvoi Teams selon l'interface utilisateur : chaque numéro entrant nécessite un compte de service avec une licence Teams Phone. Le nombre d'appels simultanés qui passent par un numéro d'utilisateur n'a pas été testé. L'utilisateur peut modifier lui-même le renvoi ; vérifiez donc régulièrement l'état.