Collection: 3CX Configurer Microsoft Teams Business Voice avec 3CX
Configurer Microsoft Teams Business Voice avec 3CX
Étape 1 : Prérequis
- Activation de "User Sync" dans l’intégration Microsoft 365.
- Les utilisateurs de MS365 doivent avoir leur numéro de “Téléphone du bureau/Office phone” au format E.164.
- Le domaine pour le FQDN Teams doit être enregistré dans les Domaines du tenant MS365. *.onmicrosoft.com n’est pas supporté en tant que nom du FQDN du SBC.
- Certificat émis par une des autorités de certificats racines indiqués. (Les Wildcards ne sont pas supportées).
- Une des options suivantes doit être assignée aux utilisateurs MS365 :
- Microsoft 365 E5
- Plan Microsoft 365 + système de téléphonie Microsoft (add-on) ou Business Voice (add-on)
Étape 2 : Configurer le FQDN Teams
- Connectez-vous à la console d’administration 3CX et allez dans “Paramètres” > “Intégration Microsoft 365” > onglet “Routage direct Routing” et cochez “Activer le routage direct Microsoft Teams”.
- Spécifiez un FQDN Teams qui correspond à l’email de domaine de MS365.
- Naviguez vers votre fournisseur DNS et créez un nouvel enregistrement A qui pointe vers l’IP publique de votre installation 3CX.
Retrouvez votre domaine en accédant au centre de portail admin de Microsoft 365 > Paramètres > Domaines. (ex. domaine MS365 : contoso.com, le FQDN Teams peut être : teams.contoso.com)
.
Étape 3 : Obtenir un certificat SSL
Pour intégrer 3CX avec 365/Teams, Microsoft nécessite un certificat SSL de l’une des autorités de certification approuvées par Microsoft. Nous recommandons d’utiliser SSL.com
Pour obtenir un certificat, vous devez d’abord générer une clé CSR, sur laquelle le certificat SSL sera créé. Nous avon s créé un outil de ligne de commandes pour faciliter le processus :
- Téléchargez OpenSSL installez (Windows Defender peut vous afficher une fenêtre de notification. Si c’est le cas, cliquez sur “More Info” qui vous permettra ensuite de cliquez sur “Run anyway”
- Une fois installé, lancez notre fichier batch CSR et entrez les détails suivants :
- FQDN 3CX (Teams) (ex. teams.example.com)
- Unité organisationnelle (ex. IT ou Opérations)
- Code pays (ex. UK, US, AU, DE, FR)
- Région (ex. Angleterre)
- Ville (ex. Londres)
- Nom de la société (ex. Example Ltd)
- L’outil va ensuite générer la clé privée sur le dossier depuis lequel vous avez lancé le fichier en format texte et en fichier *.pem. Conservez ce fichier *.pem car il sera uploadé dans le champ ‘Clé privée’ dans la console d’administration 3CX à l’étape 3 de ce guide.
- Naviguez vers le fournisseur de certificat de votre choix pour obtenir le certificat, incluant tous les certificats intermédiaires et la clé privée depuis l’autorité du certificat racine. Il doit couvrir le FQDN Teams que vous avez spécifié.
Note : Certains fournisseurs ne fournissent pas un fichier unique avec le certificat incluant les certificats intermédiaires. Dans ce cas, nous avons listé les étapes à suivre dans notre FAQ Teams.
Exemples avec l’utilisation de certificats SSL.com
- Choisissez le niveau de certificat approprié, le SSL de base suffira > Ajouter au panier
- Une fois que la fenêtre ‘Show order Transaction’ apparaît, cliquez sur “Click here to finish processing this certificate order” en haut de l’écran.
- Prenez le fichier texte que l’outil CSR a généré et copiez-le dans dans le champ CSR.
- Assurez-vous que le com commun (CN) auto-généré correspond et cliquez sur “Next”.
- Sous l’étape ‘Domain Validation’ stage, sélectionnez les menus déroulants et choisissez votre option de validation.
- Naviguez vers l’email de vérification et cliquez sur le lien inclus.
- Entrez le code de validation à 20 caractères et assurez-vous que la barre verte de validation apparaît.
- Retournez sur le dashboard de the SSL.com et choisissez l’onglet ‘Order’ sur la barre de navigation supérieure.
- Retrouvez votre certificat SSL et cliquez sur la loupe pour l’agrandir pour plus de détails.
- Cliquez pour “Télécharger” le fichier Nginx. Vous recevrez peut-être une notification demandant si vous souhaitez continuer, cliquez sur “Keep”. Retrouvez le fichier et renommez-le de .chained vers .pem
Étape 4 : Uploader le certificat SSL sur 3CX
Après avoir créé et téléchargé le certificat SSL :
- Si vous ne l’avez pas encore fait, faites un clic droit sur le fichier du certificat et renommez-le avec un nom de fichier en format *.pem.
- Sous “Étape 2” dans la console d’administration 3CX, uploadez votre certificat et clé privée générée en utilisant l’outil de génération CSR à l’étape 2 de ce guide.
Étape 5 : Ouvrir le port 5062 sur votre pare-feu
Dans le cas où votre FQDN Microsoft Teams n’est pas le même que votre FQDN 3CX, vous devez vous assurer que le port 5062 est ouvert. Par exemple, si vous avez un FQDN 3CX mycompany.3cx.us et un FQDN Teams mycompany.onmicrosoft.com, alors vous devez ouvrir le port 5062.
Instances hébergées par 3CX ou nouvellement déployées via pbxexpress
- Vous n’avez rien à faire car nous avons déjà ouvert le port 5062.
Instances existantes sur le cloud ou en local
- Vous devrez ouvrir le port 5062 via l’interface de pare-feu Amazon, Azure ou Google, ou via l’interface de votre pare-feu.
.
Étape 6 : Configurer le plan de numérotation et exécuter le script
- Sélectionnez votre code international et régional dans les cas où cela s’applique. Le script généré sera ajusté pour correspondre aux numéros appelés dans les scénarios d’appels internes, nationaux et internationaux.
- Cliquez sur “Générer le plan de numérotation” et sauvegardez le fichier PowerShell sur votre système.
- Démarrez Windows Powershell en tant qu’administrateur et assurez-vous que la politique d’exécution est définie en tant que Bypass.
- Allez dans le dossier dans lequel le script “teams_dial_plan.ps1” est sauvegardé et exécutez-le.
- Vous pouvez vérifier que la configuration est en place et qu’il n’y a pas d’erreurs en ouvrant le portail d’administration de Microsoft Teams.
Étape 7 : Exécuter les scripts pour les utilisateurs
- Les utilisateurs sélectionnées sur “User Sync” qui répondent aux prérequis (licence, format du numéro de téléphone) seront inclus dans le script généré. Les utilisateurs configurés avec 3CX peuvent prendre jusqu’à 24 heures pour être entièrement fonctionnels.
- Cliquez sur “Générer les scripts des utilisateurs” et sauvegardez le fichier PowerShell sur votre système.
- Examinez le script pour retrouver des utilisateurs invalides qui pourraient être dé-commentés. Ajustez en fonction et répétez les étapes ci-dessus.
- Démarrez Windows Powershell en tant qu’administrateur et assurez-vous que la politique d’exécution est définie en tant que Bypass en entrant cette commande :
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
- Allez dans le dossier dans lequel le script “map_users.ps1” est sauvegardé et exécutez-le.
- Cette étape doit être exécutée chaque fois que de nouveaux utilisateurs sont créés et à qui on a assigné une licence qui active la fonctionnalité du système de téléphonie Teams.
Voir aussi
Cette collection ne comporte aucun produit