Microsoft Teams Integration Guide

Microsoft Teams Integration Guide

Introduction 

The goal of this guide is to walk you through the configuration of Teams direct routing to integrate Teams with Omnivigil’s telephony service. Once the configuration is completed, you should be able to dial to the PSTN from teams and receive calls from the regular telephone network in teams.  

This guide will cover configuring your account or your client’s account if you are a Microsoft reseller. This guide is intended for technical users. As such, you must be comfortable with concepts such as DNS and PowerShell.  

Licenses Requirement 

The voice and phone system for teams requires either 

  • Microsoft 365 E5 plan  
  • Microsoft 365 Business Basic or Microsoft 365 Business Standard or Microsoft 365 Business Premium + the add on Business Voice Without Calling Plan license 
    • Please note that the Business Voice Without Calling Plan license is only available through Microsoft partners, it may not be bought independently. 

Office configuration – Domain configuration 

In order to be able to configure Teams, we will need to add your Omnivigil subdomain to Microsoft office domains. This will need to be performed for each customer domain that will be managed by the account.

  • Navigate to Omnivigil’s administrative portal
  • Log-in 
  • Once logged in, navigate to Telephony -> Devices and select Microsoft Teams SBC

  • Click New on the top right New
  • Make sure to input your domain used at Microsoft (most of the time, this domain will be your email. Ex: user@company.com, your domain in that case would be company.com)

  • Click save, and the SBC domain will be generated

  • In the left menu, navigate to Settings -> Domains and select Add domain 
  • You should be greeted with the Add domain wizard
  • Enter the SBC domain (eg: xxxxxxxx.teams.omnivigil.net) and click Use this domain

  • On the next step, select ” Add a TXT record to the domain’s DNS records”

  • On the Verify your domain page, note down the given TXT value (you will need this for the next step)

 

  • Navigate back to the Portal, and click on the top right Activate Microsoft Teams domain. You will then need to input the TXT value provided by Microsoft in the last step and click create. This will add the TXT record to Omnivigil’s DNS records so that Microsoft can validate the domain.
  • Go back to the Microsoft domain wizard and click “Verify” 
  • Note that this might take up to 2 hours for the DNS to propagate. In most cases however it is quite quick. 
  • Complete the Add domain wizard 

Office configuration – Users and licenses 

  • Navigate to Microsoft 365 admin center 
  • In the left menu go to Users -> Active users 
  • Ensure that your users have the correct licenses
  • Create a temporary user under the new domain to complete the domain activation 
    • In the left menu go to Users -> Active users 
    • Click New and enter any name 
    • Domain should be the newly created domain 

 

Teams configuration – Admin panel 

  • In the left menu, go to Voice -> Voice routing policies 
    • Click on Global (Org-wide default) 
    • Click Add / Remove PSTN usage records 
    • Add a new PSTN usage record 
      • Name does not matter but note it for future use in a PowerShell command 
    • Apply and save changes 

  • In the left menu, go to Voice -> Dial plans 
    • Click on Global (Org-wide default) 
    • Add a new Normalization rule 
      • Name: Outbound (name does not really matter)
      • Advanced
        • If Condition: ^(.*)$ 
        • Then do this: $1 

Creating a new Teams extensions 

Now that direct routing is established and that the users are configured in Teams, simply create new Teams extension in Omnivigil’s portal.

  • Navigate to the portal 
  • In the left menu go to Telephony -> Extensions -> Extensions 
    • Click New 
    • Select Extension

  • Enter the desired Extension Number and User, then select Microsoft Teams: customername.teams.omnivigil.net

  • Save 

Adding a Teams Extension to existing user

You can add an extension to an existing user simply by editing the extension itself.

  • Navigate to the portal 
  • In the left menu go to Telephony -> Extensions -> Extensions 
    • Select the Extension/User you wish to add to Microsoft Teams and click edit.
    • Simply select Microsoft Teams and save

Teams Manual Configuration (Optional)

If you wish to perform the operation manually, please follow our guide. (note that Powershell knowledge is required)

Manual Teams Integration

Teams configuration – Automated PowerShell Script

In order to facilitate the integration, we have created a powershell script to automate the configuration process.

To retrieve that script, navigate to Telephony -> Extensions -> Extensions

Next, on the top right under Menu, select Microsoft Teams Provisioning

Select the domain for which you want to generate the Teams configuration script (Note that the downloaded script will only function in the tenant for the selected domain)

 
*** Before downloading the script ***

You must validate that the extensions are properly set in regards to you users email account.
 
Once everything is confirmed, you may proceed and download the script.
 

*** Before running the script ***

There are 2 things we must do before running the script.
 
1. We must enable the script itself to be executed.
 
 – Right click on the powershell script (TeamsConfiguration.ps1) and click on Properties
 – In the General tab, make sure to click “Unblock” at the bottom in the Security option
 
 
2. We must set Execution Policy via Powershell
 
 – Open powershell with administrator rights
 – Enter the following line to enable remote sign in via powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
 
 
You are now ready to execute the script.
 

Adding/Removing/Changing User Extensions

To Add/Remove or change any user configuration in regards to their extensions, you will simply have to make the modification in the Extensions tab in the Portal.

Once the changes are done, simply download the script again and run it.

*** Note ***

Any configuration that is not reflected on the Microsoft Teams Provisioning page will be overwritten by the script.

Make sure that if any manual configuration has been made in Microsoft, it is also reflected in the Microsoft Teams Provisioning page.

Final words 

Calling a configured extension should now route the calls to the user’s Team client, whether it’s a cellphone or desktop client. 

Each user that was configured using the SetCs-User command should now have access to the dial pad to dial the regular telephone network. They will however need to log out of all their device and then log back in. 

 

PLACE AN ORDER

To place an order for Microsoft Teams licenses, simply contact us.

Want to learn more? Ask us for a demonstration!

I would like a demo