Configurer le trunk et les routes vocales dans Teams

À quoi cela sert

Pour que Teams envoie des appels au SBC EasyUC, le tenant Teams a besoin de quatre objets : une passerelle PSTN avec le nom d’hôte et le port du SBC, un usage PSTN, une route vocale avec un motif de numéros et une politique de routage vocal. EasyUC crée lui-même ces objets par Teams PowerShell et les tient à jour.

EasyUC construit le motif de numéros de la route vocale à partir des numéros des scripts pour lesquels Reachable via MS Teams est activé avec ce tenant. Teams n’envoie donc par le trunk que les appels vers ces numéros de script. Le SBC rejette tout autre numéro. Sans numéro de script, EasyUC ne crée pas de route vocale.

EasyUC ne modifie que ses propres objets. Par défaut, ils sont nommés EasyUC- suivi du premier label du nom d’hôte du SBC. La passerelle est explicitement créée comme activée, avec SIP OPTIONS, sans media bypass et avec transmission de History-Info et de P-Asserted-Identity. EasyUC n’attribue pas ici la politique à des utilisateurs individuels.

Prérequis

Module de licence teams. Sans ce module, l’espace de travail EasyUC Teams n’apparaît pas.
Rôle EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) avec les sous-droits TENANTS (ROLE_APP_TEAMS_TENANTS) pour la lecture et TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) pour la modification.
Le certificat du tenant est émis, le service SBC fonctionne, le pare-feu est ouvert.
Le domaine du nom d’hôte du SBC est validé dans le tenant Microsoft 365.
EasyUC est connecté à Teams PowerShell ou une app registration est enregistrée (chapitre « Accès Graph et connexion de l’administrateur Teams »).
Au moins un script est joignable par ce tenant et possède un numéro (chapitre « Rendre un script joignable via Microsoft Teams »). Sinon, seule la passerelle est créée, sans route vocale.
Les utilisateurs Teams qui doivent appeler les numéros de script disposent d’une licence Teams Phone et d’Enterprise Voice.

Pas à pas : configurer le trunk pour la première fois

Ouvrez Teams Tenants, cliquez sur le tenant et, dans la section Settings, allez à l’encadré Set up the trunk in Teams.
Vérifiez que PowerShell service reachable et Signed in ou Signs in automatically sont affichés.
Sous Scripts over this trunk, vérifiez que vos scripts figurent dans la liste avec l’état Reachable.
Décidez pour Enable for all users (global policy). Sans la coche, seuls les utilisateurs auxquels vous attribuez la politique EasyUC utilisent les routes vocales. En cas de doute, laissez la case décochée.
Cliquez sur Show what would happen. L’aperçu lit seulement et ne modifie rien dans le tenant.
Lisez The preview covers these numbers et These steps would run. Chaque étape porte un libellé : will be created, will be changed, will be removed ou already in place.
Cliquez sur Set up the trunk now.
Lisez l’invite de confirmation. Elle indique le nom d’hôte, le port et le nombre de numéros de script. Confirmez avec OK.
Attendez Steps and their result. Chaque étape affiche executed, already in place, failed ou not run (aborted).
Contrôlez la ligne Set up in Microsoft. Elle affiche yes avec le nom d’hôte, le port, enabled et sends SIP OPTIONS.
Attendez quelques minutes et cliquez sur l’icône d’actualisation en haut à droite. Reached from Microsoft affiche alors « Microsoft answers our OPTIONS », et OPTIONS from Microsoft affiche une heure récente.

Pas à pas : attribuer la politique de routage vocal aux utilisateurs

Sans l’option globale, vous devez attribuer vous-même la politique EasyUC aux utilisateurs. EasyUC ne le fait pas lors de la configuration du trunk.
Ouvrez le centre d’administration Teams du client et allez aux politiques de routage vocal.
Sélectionnez la politique dont le nom commence par EasyUC-. L’aperçu dans EasyUC indique le nom exact.
Attribuez la politique aux utilisateurs qui doivent appeler des numéros de script depuis Teams.
Attendez-vous à ce que Teams n’applique l’attribution qu’après un certain temps.

Pas à pas : synchroniser les routes vocales après une modification

Lorsque vous enregistrez un script, EasyUC synchronise lui-même la route dans Teams. Le formulaire du script affiche « Updating the route in Teams … », puis « Route in Teams set » avec les numéros.
Sans app registration, cette synchronisation ne s’exécute que tant qu’un administrateur Teams est connecté sur la page du tenant.
Pour une synchronisation manuelle, ouvrez l’encadré Voice routes for the script numbers et cliquez sur Synchronise now. Cela peut prendre jusqu’à deux minutes.
Lisez le résultat : « Route in Teams set: … » ou « Teams updated: no script number is reachable over this tenant any more, so no EasyUC route is left there. »
Si la passerelle ou la politique globale doivent aussi être ajustées, cliquez plutôt sur Update routes et confirmez l’invite. Synchronise now ne modifie jamais la passerelle PSTN ni la politique globale.

Pas à pas : configurer le trunk à la main ou le supprimer

Sans le service PowerShell, cliquez sur Set it up by hand instead. EasyUC indique ce qui doit être créé dans le tenant Teams, y compris la commande complète New-CsOnlinePSTNGateway avec le nom d’hôte et le port de ce tenant.
Créez ensuite dans Teams une route vocale pour les numéros de script et attribuez une politique de routage vocal aux utilisateurs.
Pour supprimer, cliquez sur Remove the trunk et confirmez l’invite. EasyUC supprime ses objets dans l’ordre inverse. Plus aucun appel ne passe ensuite par le trunk.
Si l’usage PSTN est rattaché à la politique globale, EasyUC n’en retire que sa propre entrée. L’invite le signale.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Set up in Microsoft	État de la configuration chez Microsoft : not checked yet, not yet, yes ou exists, but does not match these settings. Suivent le nom d’hôte, le port, enabled/disabled et sends SIP OPTIONS/no SIP OPTIONS.
Reached from Microsoft	Mesuré sur votre propre SBC : indique si Microsoft répond aux OPTIONS du SBC et quand des OPTIONS de Microsoft sont arrivés pour la dernière fois. Microsoft n’expose cet état par aucune interface.
Routes in Teams	État de la dernière synchronisation : Up to date, Outdated ou Never synchronised, avec un horodatage.
Synchronise now	Reconstruit les routes vocales à partir des numéros de script actuels. Ne modifie que la route vocale, l’usage PSTN et la politique d’EasyUC.
Enable for all users (global policy)	Rattache l’usage PSTN de ce trunk à la politique Global. Cela modifie la politique par défaut de tous les utilisateurs avec Enterprise Voice dans ce tenant. S’applique uniquement à Update routes. Déconseillé avec des scripts qui utilisent Operator Connect through Teams forwarding.
Show what would happen	Aperçu en lecture seule avec les numéros couverts, les étapes et les remarques. Indique « Nothing to do: the trunk in Microsoft already matches these settings. » lorsque tout concorde.
Set up the trunk now / Update routes	Exécute les étapes de l’aperçu. Le libellé change dès que la passerelle existe chez Microsoft.
Remove the trunk	Supprime du tenant Teams la passerelle, la route vocale, l’usage PSTN et la politique d’EasyUC.
Set it up by hand instead	Déploie le guide de configuration sans le service PowerShell.
These commands ran	Liste des commandes exécutées sous forme de lignes lisibles, à des fins de documentation.

Vérifier le résultat et circonscrire les erreurs

Succès : Set up in Microsoft affiche yes, Reached from Microsoft affiche « Microsoft answers our OPTIONS », Routes in Teams affiche Up to date, et la liste des tenants indique le trunk comme active.
Microsoft n’envoie des OPTIONS qu’après l’arrivée de ceux du SBC. Si le trunk est encore down ou unknown au bout de quelques minutes, vérifiez le certificat, le nom d’hôte, le port TLS et le pare-feu.
„Microsoft kennt die Domain dieses SBC-Namens in diesem Tenant nicht. …“ Ajoutez le domaine dans le centre d’administration Microsoft 365 sous Settings → Domains et validez-le avec un enregistrement TXT. Pour un nom à deux niveaux de sous-domaine, le domaine situé après le premier label doit être enregistré exactement.
„Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Attribuez le rôle dans Microsoft Entra.
„Dem Tenant fehlt eine Voraussetzung an Lizenzen. Für Direct Routing brauchen die Benutzer eine Teams-Phone-Lizenz und Enterprise Voice.“ Vérifiez les licences dans le tenant.
„Erst mit einem Teams-Administrator anmelden oder unter Microsoft Graph eine App-Registrierung hinterlegen, dann meldet sich EasyUC selbst an.“ Les boutons restent verrouillés tant qu’aucune connexion n’existe.
„Die Antwort des Abgleichs kam nicht rechtzeitig zurück. Er kann dennoch durchgelaufen sein; der Stand oben wird gleich nachgezogen.“ Patientez et rechargez la page avant de synchroniser de nouveau.
“The gateway sends no History-Info (ForwardCallHistory off). Operator Connect through Teams forwarding needs it.” Concerne uniquement les scripts avec renvoi Teams. Cliquez sur Update routes pour qu’EasyUC aligne la passerelle sur ses réglages.
Un appel vers le numéro du script échoue alors que tout est au vert : vérifiez si la politique EasyUC est attribuée à l’utilisateur appelant, et attendez que Teams l’applique.