Cet article est dédié à la configuration du Trunk SIP C5 avec l'offre Direct Routing de Microsoft Teams
Introduction
Le client Microsoft Teams peut être utilisé en tant que softphone afin d’émettre et recevoir des appels extérieurs grâce la fonctionnalité Direct Routing.
Ce document est une aide à la configuration, nous vous invitons à consulter la documentation officiel de Microsoft pour plus de détails.
L'interconnexion entre l'instance Teams client et la plateforme OpenVNO s’effectue via un Trunk SIP C5. Ce dernier communique avec la plateforme Microsoft en TLS/SRTP.
Création du trunk SIP C5 Teams
La première étape est la commande d'un trunk SIP C5 Teams sur le SaaS Netwo.
Sélectionnez ensuite le nombre de canaux simultanés nécéssaire pour le Trunk
- Code INSEE : cela permet notamment de gérer le routage des appels d'urgence du trunk.
- Anti-fraude : Consommation maximal en euros sur une heure glissante, se repporter à la documentation sur le système anti-fraude
- Adresse du client final : l'adresse principale du client livré.
ℹ️ Un NDI par défaut sera utilisé parmi vos SDA disponibles, il est possible de le changer ultérieurement.
Une fois le trunk SIP C5 Teams livré, celui ne sera pas fonctionnel immédiatement, vous devez au préalable finaliser la configuration en suivant les étapes indiquées ci dessous.
Vous pouvez retrouver le trunk dans la rubriques Centre des opérations > Solution Voix Fixe > Trunk SIP C5.
Configuration Microsoft Teams
Netwo possède une instance Office 365 sur laquelle le client va s’interconnecter via l’instance du client final.
Le client final doit posséder une instance Office 365 Business avec à minima :
- Une licence business basic (5.60€ HT/mois)
- Une licence Microsoft Teams Phone Standard (7.50€ HT/mois)
Il existe d’autre modèle de licence donnant accès à la téléphonie sur Teams, voir auprès de Microsoft.
Le client final aura besoin d’autant de licences que d’utilisateurs Teams.
Vue d'ensemble des étapes de configuration
Pré-requis :
- Un accès administrateur au compte Office 365 du client final.
- Une licence Microsoft pour le Direct Routing doit être attribuer à l'administrateur.
- Le trunk C5 Teams livré dans le SaaS.
-
Une console Powershell (minimum version 7.5).
Configuration Instance Teams
- Configuration des domaines
- Ajout des domaines au format <login>.sbc[1-2].sipb2b.net
- Validation des TXT
- Configuration de Microsoft Teams Direct Routing
-
Ajout d’un enregistrement RTC.
-
Ajout d’un itinéraire de communication vocale.
-
Ajout d’un enregistrement RTC à la stratégie de routage.
-
-
Attribution de ressources en numérotation aux utilisateurs.
Configuration via le script
Afin de vous facilitez la mise en oeuvre, nous vous conseillons d'utiliser le script suivant afin de configurer le trunk de votre client sur son instance Teams.
Le script powershell : Télécharger le script
Lors de la configuration, le script vous demandera le login lié au trunk. Vous pouvez le retrouver dans l'onglet "Informations techniques" dans le Centre des opérations
Installation de powershell pour Mac
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install powershell/tap/powershell
pwsh
Installation du pack MS Teams
Install-Module -Name MicrosoftTeams
Connexion
Connect-MicrosoftTeams
Execution du script
A adapter avec le chemin réel du script
./script_msteams_netwo.ps1
Le script vous demandera à plusieurs reprise de vous connecter avec le compte administrateur.
⚠️ La prise en compte des informations afin de valider le domaine peut prendre jusqu'à plusieurs heures. N'hésitez pas à répéter l'opération de validation.
Durant l'exécution du script il sera demandé à l'utilisateur de charger les valeurs "TXT" sur le trunk SIP afin d'authentifier le trunk.
Les valeurs TXT sont à paramètrer dans Centre des opérations > Solution Voix Fixe > Trunk SIP C5 dans l'onglet "Configuration". Les deux valeurs TXT pour les deux domaines sont à configurer.
Configuration des utilisateurs
A la fin de l'éxecution du script il vous sera possible de configurer des SDA aux utilisateurs Teams. Les numéros doivent être au préalable assigner sur le Trunk SIP C5 dans la l'onglet "Numéros associés".
- "user@domain.com" par un utilisateur Teams valide.
- "+33181802849" par un numéro valide assigné au trunk.
Set-CsPhoneNumberAssignment -Identity "user@domain.com" -PhoneNumber "+33102030405" -PhoneNumberType DirectRouting
Grant-CsOnlineVoiceRoutingPolicy -Identity user@domain.com -PolicyName Telco
Configuration Manuel
1. Configuration des domaines
Dans le centre d'administration Office 365
Se rendre dans Paramètres > Domaines puis cliquez sur Ajouter un domaine
Vous pouvez retrouver les domaines à ajouter dans l'onglet "Informations techniques" dans le Centre des opérations sur le SaaS Netwo.
une fois le nom de domaine saisie, cliquez sur Utiliser ce domaine
Dans la page suivante, cliquez sur Plus d'options puis sélectionner Ajouter un enregistrement TXT aux enregistrements DNS du domaine.
Une valeur TXT vous sera alors attribué par Microsoft au format MS=ms42424242, copier cette valeur. Dans le SaaS Netwo remplir alors la valeur correspondant au domaine.
Une fois l'opération réaliser dans la SaaS, vous pouvez cliquer sur le bouton Vérifier dans Office 365.
⚠️ La prise en compte des informations afin de valider le domaine peut prendre jusqu'à plusieurs heures. N'hésitez pas à répéter l'opération de validation.
Sur l'étape d'après Microsoft vous proposera de vous connecter au domaine, cliquer sur Plus d'options et sélectionner "Ignorer et effectuer cette opération plus tard"
Répéter l'opération pour le deuxième domaine.
2. Configuration de Microsoft Teams Direct Routinga. Ajout d’un enregistrement RTC.
Pour la suite, RDV dans la page de l'administration Teams puis dans le menu Voix > Routage Direct
En haut à droit cliquer sur Gérer les enregistrements d'utilisation RTC puis cliquer sur Ajouter et remplir le champs avec la valeur "To Telco". Valider ensuite.
b. Ajout d’un itinéraire de communication vocale.
Toujours dans la même page, cliquer sur Itinéraires des communications vocales et ajouter. Avec les valeurs suivantes :
- Nom : To Telco
- Priorité : 1
- Modèle de numéro composé : ^.*$
- Ajouter des services SBC > Ajouter le SBC comme jonction dérivée puis rentrer les deux domaines : <login>.sbc1.sipb2b.net et <login>.sbc2.sipb2b.net
- Enregistrement d'utilisation RTC et sélectionner "To Telco"
Se rendre dans le menu Stratégies de routage des communications vocales puis cliquer sur Ajouter. Sélectionner "To Telco" puis appliquer. Ajout le nom de stratégie "Telco"
3. Attribution de ressources en numérotation aux utilisateurs.
- Se rendre dans la page Utilisateurs > Gérer les utilisateurs
- Sélectionner l’utilisateur à configurer
- Cliquer "Voix Entreprise" > Activer
- Cliquer ensuite sur Attribuer le numéro de téléphone
- Rentrer le numéro au format E164 => "+33102030405" avec l'option "Routage Direct"
- S'assurer que le numéro est bien configuré sur le trunk SIP également.
- Cliquer ensuite sur l'onglet Stratégie :
- Cliquer sur Modifier
- puis à la ligne "Sélectionnez Stratégie de routage des messages vocaux" sélectionner "To Telco"
- Répétez l'opération pour les autres utilisateurs.