Rendre un script joignable via Microsoft Teams

À quoi cela sert

Le trunk seul ne mène encore nulle part. Seul un script définit quel numéro peut être appelé depuis Teams et ce qu’il advient de l’appel : annonce, menu, file d’attente, agents ou poste opérateur. Pour cela, vous activez Reachable via MS Teams dans le script, sélectionnez le tenant et saisissez le numéro.

Par tenant, un numéro mène à un seul script. Depuis Teams, le SBC n’accepte que les appels vers ces numéros de script et rejette tout autre numéro. À l’enregistrement, EasyUC définit lui-même la route vocale du numéro dans Teams.

Un script peut en plus avoir un numéro CUCM ou n’être joignable que par Teams. Sans le module CUCM, chaque script est un pur script Teams.

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). Avec le module ACD, ce sont les droits de la zone ACD qui s’appliquent aux scripts.
Un tenant Teams existe et est actif.
Pour la synchronisation automatique de la route : une inscription d’application (app registration) sur le tenant ou un administrateur Teams connecté.
Un numéro au format international qui doit être composé dans Teams. Il ne doit appartenir à aucun autre script du tenant.

Pas à pas : créer un nouveau script avec un numéro Teams

Ouvrez la liste des scripts. Avec le module ACD, passez par l’espace de travail Calling Features ; sans le module ACD, par EasyUC Teams → Teams → IVR Scripts.
Cliquez sur Create IVR.
Sous Name, saisissez un nom, par exemple Zentrale.
Si le module CUCM est actif, choisissez soit CUCM number, soit Microsoft Teams only sous Reachable via. Avec Microsoft Teams only, le script n’a ni numéro CUCM ni CTI route point.
Cochez Reachable via MS Teams. Pour un pur script Teams, la case est toujours cochée.
Sous Teams tenant, sélectionnez le tenant. La sélection affiche le nom d’hôte du SBC entre parenthèses.
Sous Call entry, sélectionnez la carte Direct Routing.
Sous Number dialled in Teams, saisissez le numéro, par exemple +49 40 1234567.
Renseignez les autres paramètres du script (langue, voix, message d’accueil) comme décrit dans le chapitre sur la configuration d’un script ACD/IVR.
Laissez IVR enabled coché et cliquez sur Save.
Attendez « Script saved. » et la ligne « Route in Teams set » avec votre numéro. Teams peut mettre quelques minutes à appliquer la modification.

Pas à pas : rendre un script CUCM existant joignable aussi via Teams

Ouvrez le script depuis la liste des scripts.
Laissez Reachable via sur CUCM number.
Cochez Reachable via MS Teams.
Sélectionnez le Teams tenant et la carte Direct Routing.
Saisissez le Number dialled in Teams.
Cliquez sur Save. Le script est alors joignable par le numéro CUCM et par le numéro Teams.

Pas à pas : vérifier la joignabilité

Ouvrez EasyUC Teams → Teams → Teams Tenants et cliquez sur le tenant.
Sous Scripts over this trunk, vérifiez que le script figure dans la liste avec son numéro et l’état Reachable.
Dans l’encadré Voice routes for the script numbers, vérifiez que Routes in Teams affiche Up to date. Sinon, cliquez sur Synchronise now.
Appelez le numéro depuis un client Teams dont l’utilisateur dispose de la politique EasyUC.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Reachable via	Uniquement avec les modules CUCM et Teams : CUCM number ou Microsoft Teams only. Le passage à Microsoft Teams only supprime le CTI route point dans CUCM à l’enregistrement ; le retour en arrière le recrée.
Reachable via MS Teams	Active l’entrée d’appel par Teams pour ce script.
Teams tenant	Tenant par le trunk duquel arrivent les appels. Obligatoire lorsque l’entrée Teams est activée.
Call entry	Direct Routing : EasyUC gère la route vocale vers son SBC. Operator Connect through Teams forwarding : voir le chapitre dédié. Operator Connect over a public destination : voie transitoire sans chemin d’exécution EasyUC ; EasyUC ne fait que mémoriser l’association.
Number dialled in Teams	Format international avec un + initial, 7 à 16 chiffres au total, 40 caractères au maximum. Les espaces, traits d’union et parenthèses sont supprimés.
Call Control Group	Uniquement pour les scripts avec un numéro CUCM : groupe de ports CTI sur lesquels les appelants sont mis en attente.
Call recording	Record every call of this script avec Keep recordings (days) de 1 à 3650 et confirmation de la mention légale.
IVR enabled	Sans la coche, le script est désactivé. La page du tenant affiche alors Script switched off, et le numéro n’est pas accepté.

Vérifier le résultat et circonscrire les erreurs

Succès : le formulaire du script affiche « Route in Teams set: … », la page du tenant indique le script comme Reachable, et un appel depuis Teams atteint le message d’accueil du script.
“No Teams tenant is connected yet. Add one under Session Border Controller first.” Créez d’abord le tenant.
“This tenant is switched off. Calls only arrive once it is active again.” Cochez Trunk active sur le tenant.
“Expected: + followed by the country code and the number, 7 to 16 digits in total.” Corrigez le format du numéro.
“This tenant has no app registration stored. The route is then only set while a Teams admin is signed in on the tenant page.” Connectez-vous ou enregistrez une app registration.
“The route in Teams was not updated” ou “Updating the route in Teams failed” Cliquez sur Open the tenant page, vérifiez la connexion et cliquez ensuite sur Synchronise now.
Statut Number already used by another script sur la page du tenant : deux scripts se partagent le numéro. Modifiez l’un des deux.
„Ein reines Teams-Script ist nur über Microsoft Teams erreichbar: bitte „Über MS Teams erreichbar“ einschalten, den Teams-Tenant und einen vollständigen Eingangsweg wählen.“ Ajoutez le tenant et le numéro.
„Bitte die CUCM-Nummer angeben, unter der das Script in CUCM erreichbar ist.“ Vous avez choisi CUCM number, mais n’avez saisi aucun numéro.