From Bright Pattern Documentation
Jump to: navigation, search
(Updated via BpClonePage extension. Source page: draft:Contact-center-administrator-guide/ApplicationNotes/MicrosoftTeamsIntegrationConfiguration/DirectRouting)
 
Line 1: Line 1:
 
= Configuration for Microsoft Teams Direct Routing =
 
= Configuration for Microsoft Teams Direct Routing =
 
Direct voice routing allows your Bright Pattern Contact Center (BPCC) to connect to your Microsoft Teams environment via a single-tenant PBX trunk. Configuring direct voice routing allows the following:
 
Direct voice routing allows your Bright Pattern Contact Center (BPCC) to connect to your Microsoft Teams environment via a single-tenant PBX trunk. Configuring direct voice routing allows the following:
* Users of either system (Teams/BPCC) may call each other directly without incurring a PSTN carrier charge.<br><br>
+
* Users of either system (Teams/BPCC) may call each other directly without incurring a PSTN carrier charge.
 
* Microsoft Teams users may make outgoing calls to a PSTN via BPCC and receive incoming calls from a PSTN via BPCC.
 
* Microsoft Teams users may make outgoing calls to a PSTN via BPCC and receive incoming calls from a PSTN via BPCC.
  
  
As your contact center’s Microsoft Teams admin, you will do the following in order to allow direct routing:
+
As a Microsoft Teams administrator for your contact center, you must do the following to allow direct routing:
# Add an alias domain to your Microsoft Office 365 instance (the TLS domain provided by your provider). Note this will require provider adding a TXT record in the domain during the process.
+
# Register and activate alias domain(s) in your Microsoft Office 365 instance
 
# Configure the session border controller (SBC) and routing in Microsoft Teams
 
# Configure the session border controller (SBC) and routing in Microsoft Teams
# Configure/enable a one or more Teams user(s) for calling
+
# Configure Teams users for calling
# Decide which prefixes would send calls from BPCC to Teams and which would send calls from Teams to BPCC and configure routing in Teams and on BPCC trunk (you would have to ask the provider to add the prefixes on BPCC trunk). This might also require the provider to configure number translation on the trunk, converting full PSTN phone numbers to extensions and back.
 
# Configuring reachability of all Teams users from BPCC via an Attendant
 
  
 
== Procedure ==
 
== Procedure ==
  
=== 1. Add an Alias Domain to Your Office 365 Instance ===
+
=== 1. Register and Activate Alias Domain(s) in Your Microsoft 365 Instance ===
This step is required so that Microsoft Teams will trust the domain when you add the session border controller (SBC) in the following step.
+
Registering and activating the alias domains is required so that Microsoft Teams trusts the domain(s) when you enroll the session border controllers (SBCs) in the following step.  
 +
{{Note|Ask your service provider for the domain name or names to register and activate for your contact center. Additional domain names allow you to set up multiple SBCs for redundancy.}}
  
# In the Microsoft 365 admin center, navigate to ''Settings > Domains > Add domain (proxy TLS domain)'' and add the alias domain. When you do this, a text string will be generated that will be used by your service provider to validate your domain. Note that you must provide this string to your service provider.
+
==== Domain Registration ====
## It is recommended to decline email setup on the domain - it requires additional DNS settings, but the domain will never be used to send/receive emails
+
For each domain from your service provider, you must complete the following registration process:
## It is acceptable for the domain that was successfully set up to show "No services selected" in the Office 365 domain list
 
# Next, navigate to ''Users > Active Users > Add a user''. Here you will add a user (e.g. “proxy”) for the previously created domain, as after you have registered a domain name, you must activate it by creating at least one E1, E3, or E5 licensed user on that domain. Note that the license can be revoked after the domain activation (i.e., it can take up to 24 hours).
 
  
 +
# In the [https://admin.microsoft.com Microsoft 365 admin center], navigate to '''Settings > Domains''' and click '''Add domain'''  <br /><br>
 +
# In the '''Domain name''' field, enter the full domain name. It will likely have a number of subdomains, for example: <code>sipname.subdomain.servername.com</code>. Click ''Use this domain''.  <br /><br>
 +
# You will be challenged to verify that you own the domain. This must be done in cooperation with your service provider. Select the option '''Add a TXT record to the domain's DNS records''' and click ''Continue''.  <br /><br>
 +
# The registration wizard will present a '''TXT value''' (typically formatted like <code>MS=ms123456798</code>) that your service provider must add to the domain's DNS records. Once you have copied the required TXT value, you may navigate away from this page. It may take some time for your service provider to update the domain's DNS records.  <br /><br>
 +
# Once your service provider has confirmed that the TXT record has been added to the DNS records of the domain, return to '''Settings > Domains''''','' select the domain from the list, and click ''Verify'' to continue domain registration.  <br /><br>
 +
# The registration wizard will prompt you to add DNS records to enable email routing. This is not needed for direct routing. Uncheck the option '''Exchange and Exchange Online Protection''' and click ''Continue'' to complete domain registration.
  
=== 2. Configure the Session Border Controller (SBC) and Routing in Microsoft Teams ===
+
 
# In the Microsoft Teams admin center, navigate to ''Voice > Voice Routing Policies > Edit Global'' OR ''create new''. This is what you will assign to users; however, note that Global is already assigned. They consist of PSTN usage records that, in turn, are linked to voice routes below. Add PSTN usage “To BPCC” (i.e., it’s just a text label).<br><br>
+
==== Domain Activation ====
# Next, navigate to ''Voice > Direct Routing > SBCs > Add'' and add the proxy TLS domain that was added as an alias. Set the port to the TLS port provided by your service provider (e.g. 5062) and disable the ''send Options''. If the proxy cannot be added, you might need to wait for some time (15, 30 min, sometimes an hour) - most likely the user with TLS domain you created above have not propagated inside Microsoft Teams yet <br><br>
+
You service provider will supply you with multiple domains, each representing a redundant SBC. You have to associate all of them (activate their domains) on your Office 365 tenant.
# Next, navigate to ''Voice > Direct Routing > Voice Routes > Add'' and add the route that the number should match to be sent to BPCC. Add a prefix you choose that would send calls to BPCC ,e.g. “1000” (an invalid US area code), and then link it to “To BPCC” usage.<br><br>
+
 
# Note that depending on your country, Microsoft will insist on all phone numbers to either start with a leading '''+''' sign or start with your country code. You can affect the process of short number translation to long ones in the following section: ''Voice > Dial plans > <dial plan> > Localization rules''.
+
A domain can be activated by using it in the email address of a licensed user.
 +
 
 +
# Navigate to '''Users > Active User''' and click '''Add a user'''  <br /><br>
 +
# Under '''Set up the basics''', add any display name and username. In the '''Domain''' field, select the registered domain that you want to activate. Click ''Next''.  <br /><br>
 +
# Under '''Product licenses''', ensure that the user has at least an Office 365 E1, E3, or E5 license as well as a Microsoft Teams Phone license. Complete the remaining steps in the registration process with the default options.  <br /><br>
 +
# Repeat the above steps for any other domains that need to be activated.  <br /><br>
 +
# Once the domain or domains are activated (which can take up to 24 hours), all product licenses can be removed from the associated users. A domain will remain active as long as it is assigned to the email address of at least one user.
 +
 
 +
 
 +
=== 2. Configure the Session Border Controller (SBC) and Voice Routing in Microsoft Teams ===
 +
Voice routes and voice routing policies determine which calls originating in Microsoft Teams should be routed directly to BPCC, while the Session Border Controllers (SBCs) define how Microsoft should connect to BPCC servers. You need to first create an SBC for each of the domains registered and activated in the previous steps, then configure voice routes and policies.
 +
 
 +
 
 +
==== Create an SBC for Each Domain ====
 +
SBCs define the domain that Microsoft Teams will use to find the IP address of the SIP processor serving your contact center.
 +
 +
# In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], navigate to '''Voice > Direct Routing''' <br /><br>
 +
# Open the '''SBC''' tab to display the table of available SBCs  <br /><br>
 +
# Click '''Add''' and configure the following fields for the new SBC:  <br /><br>
 +
#* '''Add an FQDN for the SBC''': The full name of the previously registered and activated domain<br /><br>
 +
#*'''Enabled''': on<br /><br>
 +
#*'''SIP signaling port''': The port specified by your provider<br /><br>
 +
#*'''Send SIP options''': off<br /><br>
 +
#*Leave the default values for the remaining options <br /><br>
 +
# Save and repeat for each of the domains registered and activated in the previous steps.
 +
 
 +
 
 +
==== Create Voice Routes ====
 +
Voice route configuration determines whether a call dialed in Teams should be routed to BPCC. This example uses a dialing pattern that will direct all calls dialed with an initial "+877" to BPCC.  
 +
 
 +
# In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], navigate to '''Voice > Direct Routing'''  <br /><br>
 +
# Open the '''Voice routes''' tab  <br /><br>
 +
# Click '''Add''', and configure the following properties:  <br /><br>
 +
#*'''Name''': Any descriptive name, such as "Route To BPCC"<br /><br>
 +
#*'''Priority''': 1<br /><br>
 +
#*'''Dialed number pattern''': A regular expression that works similarly to a [[Service-provider-guide/PhoneSystem/Trunks#Dial prefixes that select this trunk|dial prefix for trunk selection]]. For example, to select numbers dialed with the prefix "+877", use the following expression <code>^\+877[0-9]+$</code>.<br /><br>
 +
#*'''SBCs enrolled''': click ''Add SBCs'' and select the SBCs configured in the previous step.<br /><br>
 +
#*'''PSTN usage records''': Click ''Add PSTN usage records'' and give it any descriptive name, such as "BPCC usage record". <br /><br>
 +
#**This record is used to create a link between this voice route and the voice routing policy created in the next step.
 +
#**The name you give to the usage record will identify the route in some Microsoft Teams usage reports.  <br /><br>
 +
# Click '''Save'''.
 +
 
 +
 
 +
==== Voice Routing Policies ====
 +
Voice routing policies connect a user with a given voice route. You may create a new voice routing policy to apply to subset of users, or update the global policy to apply the route to all users by default.
 +
 
 +
In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], navigate to '''Voice > Voice routing policies'''.
 +
 
 +
*To create a new policy, click '''Add''' and configure the following: <br /><br>
 +
*#'''Name''': Any descriptive name, such as "BPCC routing policy".<br /><br>
 +
*#'''PSTN usage records''': Click ''Add PSTN usage records'' and select the previously created usage record, e.g. "BPCC usage record". <br /><br>
 +
*To update the default policy:<br /><br>
 +
*#Tick the selector button to the left of the ''Global (Org-wide default)'' policy, then click the '''Edit''' button at the top of the table<br /><br>
 +
*#Click ''Add PSTN usage records'' and select the previously created usage record, e.g. "BPCC usage record".
 +
 
 +
 
 +
==== Localization Rules ====
 +
Depending on your country, Microsoft may insist that all phone numbers either start with a leading '''+''' sign or start with your country code. You can define how short numbers are translated to long ones in the section '''Voice > Dial plans > {dial plan name} > Localization rules'''.
  
  
 
=== 3. Configure Teams Users for Calling ===
 
=== 3. Configure Teams Users for Calling ===
In order for all Microsoft Teams users to take advantage of Bright Pattern Contact Center (BPCC) direct-routing capabilities, users must have at a minimum an E1/E3 + Office 365 Phone System license or an E5 license; however, the license has to be from the enterprise-family level.
+
The following instructions show how users can be configured through the web interface of the Microsoft Teams admin center. For configuring large numbers of users, you may wish to consider using the Teams PowerShell Module command-line interface, the Windows PowerShell, or the Azure Cloud Shell.
  
For a user to be reachable from BPCC software, they must have a business/enterprise phone number defined.  
+
In order for all Microsoft Teams users to take advantage of Bright Pattern Contact Center (BPCC) direct-routing capabilities, users must have at a minimum an E1/E3 + Office 365 Phone System license or an E5 license; Note that the license must be from the enterprise-family level.
  
'''Note''': This applies to users who will get their phone numbers from BPCC. For users who will have a phone number via a Microsoft Calling Plan, see [[#3a._(Optional)_Configuring_Microsoft_365_Calling_Plan_Users|3a. Configuring Microsoft 365 Calling Plan Users]].
+
{{Note|'''For a user to be reachable from BPCC, they must have a business/enterprise phone number configured.''' In order for BPCC to route calls directly to a Teams user, one or more prefixes must be defined in BPCC that indicate an outgoing call to Teams. The following configuration examples suggest the prefix "+1000", since it will not conflict with any US area codes.  
  
in [https://admin.teams.microsoft.com/users/ Teams Admin -> Users], select a user, click on Account tab, in General information section click pencil icon "edit", select Direct Routing as Phone Number Type and enter user's business/enterprise phone number in Assigned phone number field. Click Apply.
 
  
Once the user has both the required licenses and a phone number assigned, they will see a dial pad in the "Calls" section of Teams client.
+
'''Before configuring phone numbers, consult with your service provider''' to determine which prefix or prefixes to use, to ensure that your contact center can be configured to route calls to your Teams users.}}
 +
 
 +
==== Policies ====
 +
Calling and routing policies must be configured to allow Teams users to make calls to BPCC users. 
 +
 
 +
#In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], Navigate to '''Users > Manage users'''.  <br /><br>
 +
#Open profile of the desired user by clicking their '''Display name'''.  <br />
 +
#Open the '''Policies''' tab. <br /><br>
 +
#Edit the ''Calling Policy'':<br /><br>
 +
#* Tick the selector button to the left of ''Calling policy'', then click the '''Edit''' button at the top of the table<br /><br>
 +
#*Select "AllowCalling".<br /><br>
 +
#*Click '''Apply'''. <br /><br>
 +
#Edit the ''Voice routing policy'':<br /><br>
 +
#*Tick the selector button to the left of ''Voice routing policy'', then click the '''Edit''' button at the top of the table.<br /><br>
 +
#*Select the voice routing policy created above, e.g. "BPCC routing policy".<br /><br>
 +
#* Click '''Apply'''.
 +
 
 +
 
 +
==== Configuring Phone Numbers ====
 +
Each Teams user must have a phone number in order to make or receive calls through direct voice routing. This section describes how to configure phone numbers for Teams users through the Microsoft Teams admin center.
 +
 
 +
However, it may not be practical to assign phone numbers with an arbitrary prefix or provide a PBX license for every Teams user. In either of these cases, you can still allow Teams users to receive calls from BPCC users by skipping this section and considering these optional steps:
 +
 
 +
* For users who will have a phone number via a Microsoft Calling Plan, see [[Contact-center-administrator-guide/ApplicationNotes/MicrosoftTeamsIntegrationConfiguration/DirectRouting#3a.%20.28Optional.29%20Configuring%20Microsoft%20365%20Calling%20Plan%20Users|3a. Configuring Microsoft 365 Calling Plan Users]].
 +
 
 +
* For other cases where assigning licenses or numbers is not practical, see [[Contact-center-administrator-guide/ApplicationNotes/MicrosoftTeamsIntegrationConfiguration/DirectRouting#3b.%20.28Optional.29%20Configuring%20Reachability%20of%20All%20Teams%20Users%20from%20BPCC|3b. Configuring Reachability of All Teams Users from BPCC]].
 +
 
 +
 
 +
To assign phone numbers:
 +
#In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], Navigate to '''Users > Manage users'''.  <br /><br>
 +
#Open profile of the desired user by clicking their '''Display name'''. <br /><br>
 +
#Open the users '''Account''' tab. <br /><br>
 +
# If you need to assign the user a primary phone number, locate the section '''Assigned phone number''', and click the '''Edit''' button.<br /><br>
 +
#*'''Phone number type''': Select "Direct Routing".<br /><br>
 +
#*'''Assigned phone number''': All Teams users that should be able to receive calls from BPCC should have a direct routing number that starts with the same prefix. In this example, all direct routing numbers are expected to be formatted as +1000XXXX, where X is a digit.<br /><br>
 +
#* If there is no '''Edit''' button for the user, ensure they are assigned the correct licenses. <br /><br>
 +
 
 +
<!--
 +
PowerShell instructions need to be updated
 +
==== Windows PowerShell ====
 +
To configure phone numbers from BPCC through the Windows PowerShell, take the following steps:
 +
 
 +
# Install the Teams PowerShell Module.<br /><br>
 +
# After installing, start PowerShell with administrator privileges.<br /><br>
 +
# Enter the following commands:<br /><br>
 +
#::Import-Module "C:\\Program Files\\Common Files\\Teams for Business
 +
#::Online\\Modules\\TeamsOnlineConnector\\TeamsOnlineConnector.psd1"
 +
#::Import-Module TeamsOnlineConnector
 +
#::$userCredential = Get-Credential
 +
#::$sfbSession = New-CsOnlineSession -Credential $userCredential
 +
#::Import-PSSession $sfbSession<br /><br>
 +
# Note that the ''Import-PSSession'' command will display the login window. From here, enter your Microsoft Teams admin credentials.<br /><br>
 +
# Set the phone number for the user with the following command (i.e., using the special invalid US area code 000):<br /><br>
 +
#::Set-CsUser -Identity firstname.lastname@officedomain.com -EnterpriseVoiceEnabled $true -HostedVoiceMail
 +
#::$true -OnPremLineURI tel:+10005555555<br /><br>
 +
# Assign to the user the voice routing policy that was defined in this procedure.<br /><br>
 +
# Once the phone number is added to the user’s account in the Microsoft Teams admin center, it must be manually added to the same user’s contact card in the Microsoft 365 admin center, section ''User''.
 +
 
 +
 
 +
==== Azure Cloud Shell ====
 +
To configure phone numbers from BPCC through the Azure Cloud Shell, take the following steps:
 +
 
 +
# Log into your Azure portal: https://portal.azure.com/<br /><br>
 +
# Click on the '''terminal/console''' [[File:Azure-Terminal-Console-Button.PNG|25px]] button in the top bar.<br /><br>
 +
# Enter the following commands, ensuring you substitute your own domain name:<br /><br>
 +
#::import-module MicrosoftTeams
 +
#::$sfboSession = New-CsOnlineSession -Credential $credential -OverrideAdminDomain "domain.onmicrosoft.com"
 +
#::Import-PSSession $sfboSession<br /><br>
 +
# Set the phone number for the user with the following command (i.e., using the special invalid US area code 000):<br /><br>
 +
#::Set-CsUser -Identity firstname.lastname@officedomain.com -EnterpriseVoiceEnabled $true -HostedVoiceMail
 +
#::$true -OnPremLineURI tel:+10005555555 -->
  
 
=== 3a. (Optional) Configuring Microsoft 365 Calling Plan Users ===
 
=== 3a. (Optional) Configuring Microsoft 365 Calling Plan Users ===
Line 47: Line 176:
  
 
To configure a Microsoft Calling Plan user, do the following:
 
To configure a Microsoft Calling Plan user, do the following:
# Create a location (i.e., an emergency location).<br><br>
+
# Create a location (i.e., an emergency location).<br /><br>
# Give the user a Microsoft 365 Domestic Calling Plan license.<br><br>
+
# Give the user a Microsoft 365 Domestic Calling Plan license.<br /><br>
# Order a phone number, and then specify the location created previously.<br><br>
+
# Order a phone number, and then specify the location created previously.<br /><br>
# Note that you will search for locations by their city name (i.e., not by the defined location names).<br><br>
+
# Note that you will search for locations by their city name (i.e., not by the defined location names).<br /><br>
# From the phone number, assign the user to the license, and then set the emergency location.<br><br>
+
# From the phone number, assign the user to the license, and then set the emergency location.<br /><br>
 
# Edit the user policies and then set the voice routing policy with the BPCC routing entries, if needed.
 
# Edit the user policies and then set the voice routing policy with the BPCC routing entries, if needed.
  
  
=== 4. (Optional) Configuring Reachability of All Teams Users from BPCC ===
+
=== 3b. (Optional) Configuring Reachability of All Teams Users from BPCC ===
All Teams users can be dialed from BPCC via an [https://docs.microsoft.com/en-us/microsoftteams/plan-auto-attendant-call-queue attendant]. In order to do this, take the following steps:
+
All Teams users can be dialed from BPCC via an [https://docs.microsoft.com/en-us/microsoftteams/plan-auto-attendant-call-queue attendant], even if you are not able to assign a single prefix to all their phone numbers. In order to do this, take the following steps:
 
 
# Create a ''Resource User'' in the Microsoft Teams admin portal (i.e., ''Org Wide Settings > Resource Accounts'').<br><br>
 
# Give the new user the ''Phone Systems Virtual User'' add-on license in the Microsoft Office 365 Admin portal.<br><br>
 
# Give the new user a phone number via Windows Powershell or Azure Cloud Shell using the following command:<br><br>
 
#::Set-CsOnlineApplicationInstance -Identity resourceuser@domain.onmicrosoft.com -OnpremPhoneNumber
 
#::+10005555555<br><br>
 
# Create an attendant that plays a menu prompt and offers dial by name.<br><br>
 
# Associate the attendant with the resource user (i.e., via ''Resource User'' properties).<br><br>
 
# The calling attendant number via BPCC will reach the attendant. Any user can be reached by dialing their name followed by the pound symbol.<br><br>
 
# A string now can be entered into the Office 365 user contact field (e.g., Office Phone: 1111111,,222222 where 111111 is the attendant number and 222222 is the dial by name string. Note that this tool uses 0 for space.).
 
  
 +
# [https://learn.microsoft.com/en-us/microsoftteams/teams-add-on-licensing/virtual-user#how-to-obtain-microsoft-teams-phone-resource-account-licenses Obtain a Microsoft Teams Phone Resource Account license] for your Microsoft 365 account.<br /><br>
 +
# In the [https://admin.teams.microsoft.com/ Microsoft Teams admin center], navigate to ''Voice > Resource Accounts'', click '''Add''', and create an '''Auto Attendant'''-type resource account.<br /><br>
 +
# In the [https://admin.microsoft.com Microsoft 365 admin center], you need to assign the attendant a phone license and a phone number:<br /><br>
 +
#* Navigate to ''Users > Active Users'' and open the newly created attendant user. <br /><br>
 +
#* From the ''Licenses and apps'' tab, assign the [https://learn.microsoft.com/en-us/microsoftteams/teams-add-on-licensing/virtual-user Teams Phone Resource Account license] to the attendant.<br /><br>
 +
#* From the ''Account'' tab, under the heading ''Phone number,'' click '''Manage contact information''' to add a phone number. Ensure that the phone number has the prefix necessary to be called from BPCC. In this example, the attendant will have a phone number with the format +1000XXXX, where X is a digit.<br /><br>
 +
# Follow the Microsoft documentation to [https://learn.microsoft.com/en-us/microsoftteams/create-a-phone-system-auto-attendant create an auto attendant] that plays a menu prompt and offers dial by name.<br /><br>
 +
# Associate the attendant with the resource user via the ''Resource User'' properties.<br /><br>
 +
# Calling the auto attendant number via BPCC will reach the attendant. Any Teams or Microsoft 365 user with a phone number can then be reached by dialing their name followed by the pound symbol.<br /><br>
 +
# A string now can be entered into the Microsoft 365 user contact field (e.g., Office Phone: 10001111,,222222# where 10001111 is the attendant number and 222222 is the dial by name string. Note that this tool uses 0 for space.).
  
 
== Diagnostics Checklists ==
 
== Diagnostics Checklists ==
  
 
=== Testing Microsoft Teams to Bright Pattern Contact Center Calls ===
 
=== Testing Microsoft Teams to Bright Pattern Contact Center Calls ===
* The Teams user has an E1/E3 license + Office 365 Phone System, or an E5 license.<br><br>
+
* The Teams user has an E1/E3 license + Office 365 Phone System, or an E5 license.<br /><br>
* The Teams user has OnlinePremURI phone number.<br><br>
+
* The Teams user has a calling policy selected that includes outgoing calls. <br /><br>
* The Teams user has a calling policy selected that includes usage that selects the matching prefix that points to the repro proxy domain.<br><br>
+
* The Teams user is assigned a ''Voice routing policy'' with the appropriate dialed number pattern, and that has the correct SBC enrolled.<br /><br>
* The BPCC tenant has a matching extension or a dial-out entry.
+
* The SBC is configured with the correct domain and port.<br /><br>
 +
* Your service provider has configured your contact center to correctly identify the dialing extension you are using in Teams to indicate a call to a BPCC contact.<br /><br>
  
 
=== Testing Bright Pattern Contact Center to Microsoft Teams Calls ===
 
=== Testing Bright Pattern Contact Center to Microsoft Teams Calls ===
* The BPCC contact center has a single-tenant PBX trunk.<br><br>
+
* There is a Teams user assigned the dialed number with the appropriate licenses.<br /><br>
* The dialed number matches the prefix on the trunk.<br><br>
+
* Your service provider has configured the TLS SIP processor.<br /><br>
* The trunk’s number-mangling parameters change from and to numbers to their proper destinations.<br><br>
+
* Your service provider has configured a single-tenant PBX trunk for calling Microsoft Teams.<br /><br>
* The repro proxy has BPCC SIP processor addresses enabled in the ACL<br><br>
+
* The dialed number matches the dial-out prefix of the trunk.<br /><br>
* The repro proxy has firewall ports open toward BPCC.<br><br>
+
* The trunk’s number-changing parameters correctly transform the incoming and outgoing numbers.
* The repro proxy has a matching route that point to Teams.<br><br>
 
* The repro proxy has the proper (not self-signed, not wildcard) certificate(s).<br><br>
 
* There is a Teams user with a tel URL set to the dialed number.
 

Latest revision as of 07:57, 4 March 2025

• 日本語
• 5.19 • 5.8

Configuration for Microsoft Teams Direct Routing

Direct voice routing allows your Bright Pattern Contact Center (BPCC) to connect to your Microsoft Teams environment via a single-tenant PBX trunk. Configuring direct voice routing allows the following:

  • Users of either system (Teams/BPCC) may call each other directly without incurring a PSTN carrier charge.
  • Microsoft Teams users may make outgoing calls to a PSTN via BPCC and receive incoming calls from a PSTN via BPCC.


As a Microsoft Teams administrator for your contact center, you must do the following to allow direct routing:

  1. Register and activate alias domain(s) in your Microsoft Office 365 instance
  2. Configure the session border controller (SBC) and routing in Microsoft Teams
  3. Configure Teams users for calling

Procedure

1. Register and Activate Alias Domain(s) in Your Microsoft 365 Instance

Registering and activating the alias domains is required so that Microsoft Teams trusts the domain(s) when you enroll the session border controllers (SBCs) in the following step.

Info.40x40.png Ask your service provider for the domain name or names to register and activate for your contact center. Additional domain names allow you to set up multiple SBCs for redundancy.


Domain Registration

For each domain from your service provider, you must complete the following registration process:

  1. In the Microsoft 365 admin center, navigate to Settings > Domains and click Add domain

  2. In the Domain name field, enter the full domain name. It will likely have a number of subdomains, for example: sipname.subdomain.servername.com. Click Use this domain.

  3. You will be challenged to verify that you own the domain. This must be done in cooperation with your service provider. Select the option Add a TXT record to the domain's DNS records and click Continue.

  4. The registration wizard will present a TXT value (typically formatted like MS=ms123456798) that your service provider must add to the domain's DNS records. Once you have copied the required TXT value, you may navigate away from this page. It may take some time for your service provider to update the domain's DNS records.

  5. Once your service provider has confirmed that the TXT record has been added to the DNS records of the domain, return to Settings > Domains, select the domain from the list, and click Verify to continue domain registration.

  6. The registration wizard will prompt you to add DNS records to enable email routing. This is not needed for direct routing. Uncheck the option Exchange and Exchange Online Protection and click Continue to complete domain registration.


Domain Activation

You service provider will supply you with multiple domains, each representing a redundant SBC. You have to associate all of them (activate their domains) on your Office 365 tenant.

A domain can be activated by using it in the email address of a licensed user.

  1. Navigate to Users > Active User and click Add a user

  2. Under Set up the basics, add any display name and username. In the Domain field, select the registered domain that you want to activate. Click Next.

  3. Under Product licenses, ensure that the user has at least an Office 365 E1, E3, or E5 license as well as a Microsoft Teams Phone license. Complete the remaining steps in the registration process with the default options.

  4. Repeat the above steps for any other domains that need to be activated.

  5. Once the domain or domains are activated (which can take up to 24 hours), all product licenses can be removed from the associated users. A domain will remain active as long as it is assigned to the email address of at least one user.


2. Configure the Session Border Controller (SBC) and Voice Routing in Microsoft Teams

Voice routes and voice routing policies determine which calls originating in Microsoft Teams should be routed directly to BPCC, while the Session Border Controllers (SBCs) define how Microsoft should connect to BPCC servers. You need to first create an SBC for each of the domains registered and activated in the previous steps, then configure voice routes and policies.


Create an SBC for Each Domain

SBCs define the domain that Microsoft Teams will use to find the IP address of the SIP processor serving your contact center.

  1. In the Microsoft Teams admin center, navigate to Voice > Direct Routing

  2. Open the SBC tab to display the table of available SBCs

  3. Click Add and configure the following fields for the new SBC:

    • Add an FQDN for the SBC: The full name of the previously registered and activated domain

    • Enabled: on

    • SIP signaling port: The port specified by your provider

    • Send SIP options: off

    • Leave the default values for the remaining options

  4. Save and repeat for each of the domains registered and activated in the previous steps.


Create Voice Routes

Voice route configuration determines whether a call dialed in Teams should be routed to BPCC. This example uses a dialing pattern that will direct all calls dialed with an initial "+877" to BPCC.

  1. In the Microsoft Teams admin center, navigate to Voice > Direct Routing

  2. Open the Voice routes tab

  3. Click Add, and configure the following properties:

    • Name: Any descriptive name, such as "Route To BPCC"

    • Priority: 1

    • Dialed number pattern: A regular expression that works similarly to a dial prefix for trunk selection. For example, to select numbers dialed with the prefix "+877", use the following expression ^\+877[0-9]+$.

    • SBCs enrolled: click Add SBCs and select the SBCs configured in the previous step.

    • PSTN usage records: Click Add PSTN usage records and give it any descriptive name, such as "BPCC usage record".

      • This record is used to create a link between this voice route and the voice routing policy created in the next step.
      • The name you give to the usage record will identify the route in some Microsoft Teams usage reports.

  4. Click Save.


Voice Routing Policies

Voice routing policies connect a user with a given voice route. You may create a new voice routing policy to apply to subset of users, or update the global policy to apply the route to all users by default.

In the Microsoft Teams admin center, navigate to Voice > Voice routing policies.

  • To create a new policy, click Add and configure the following:

    1. Name: Any descriptive name, such as "BPCC routing policy".

    2. PSTN usage records: Click Add PSTN usage records and select the previously created usage record, e.g. "BPCC usage record".

  • To update the default policy:

    1. Tick the selector button to the left of the Global (Org-wide default) policy, then click the Edit button at the top of the table

    2. Click Add PSTN usage records and select the previously created usage record, e.g. "BPCC usage record".


Localization Rules

Depending on your country, Microsoft may insist that all phone numbers either start with a leading + sign or start with your country code. You can define how short numbers are translated to long ones in the section Voice > Dial plans > {dial plan name} > Localization rules.


3. Configure Teams Users for Calling

The following instructions show how users can be configured through the web interface of the Microsoft Teams admin center. For configuring large numbers of users, you may wish to consider using the Teams PowerShell Module command-line interface, the Windows PowerShell, or the Azure Cloud Shell.

In order for all Microsoft Teams users to take advantage of Bright Pattern Contact Center (BPCC) direct-routing capabilities, users must have at a minimum an E1/E3 + Office 365 Phone System license or an E5 license; Note that the license must be from the enterprise-family level.


Info.40x40.png For a user to be reachable from BPCC, they must have a business/enterprise phone number configured. In order for BPCC to route calls directly to a Teams user, one or more prefixes must be defined in BPCC that indicate an outgoing call to Teams. The following configuration examples suggest the prefix "+1000", since it will not conflict with any US area codes.


Before configuring phone numbers, consult with your service provider to determine which prefix or prefixes to use, to ensure that your contact center can be configured to route calls to your Teams users.


Policies

Calling and routing policies must be configured to allow Teams users to make calls to BPCC users.

  1. In the Microsoft Teams admin center, Navigate to Users > Manage users.

  2. Open profile of the desired user by clicking their Display name.
  3. Open the Policies tab.

  4. Edit the Calling Policy:

    • Tick the selector button to the left of Calling policy, then click the Edit button at the top of the table

    • Select "AllowCalling".

    • Click Apply.

  5. Edit the Voice routing policy:

    • Tick the selector button to the left of Voice routing policy, then click the Edit button at the top of the table.

    • Select the voice routing policy created above, e.g. "BPCC routing policy".

    • Click Apply.


Configuring Phone Numbers

Each Teams user must have a phone number in order to make or receive calls through direct voice routing. This section describes how to configure phone numbers for Teams users through the Microsoft Teams admin center.

However, it may not be practical to assign phone numbers with an arbitrary prefix or provide a PBX license for every Teams user. In either of these cases, you can still allow Teams users to receive calls from BPCC users by skipping this section and considering these optional steps:


To assign phone numbers:

  1. In the Microsoft Teams admin center, Navigate to Users > Manage users.

  2. Open profile of the desired user by clicking their Display name.

  3. Open the users Account tab.

  4. If you need to assign the user a primary phone number, locate the section Assigned phone number, and click the Edit button.

    • Phone number type: Select "Direct Routing".

    • Assigned phone number: All Teams users that should be able to receive calls from BPCC should have a direct routing number that starts with the same prefix. In this example, all direct routing numbers are expected to be formatted as +1000XXXX, where X is a digit.

    • If there is no Edit button for the user, ensure they are assigned the correct licenses.


3a. (Optional) Configuring Microsoft 365 Calling Plan Users

If a user already has a Microsoft 365 Calling Plan and a Microsoft phone number, adding a voice routing policy is sufficient for making calls to and from BPCC.

Note: These users might require a policy separate from other users, depending on whether you want their calls to the PSTN to go through SBC/BPCC or the Microsoft Calling Plan.

To configure a Microsoft Calling Plan user, do the following:

  1. Create a location (i.e., an emergency location).

  2. Give the user a Microsoft 365 Domestic Calling Plan license.

  3. Order a phone number, and then specify the location created previously.

  4. Note that you will search for locations by their city name (i.e., not by the defined location names).

  5. From the phone number, assign the user to the license, and then set the emergency location.

  6. Edit the user policies and then set the voice routing policy with the BPCC routing entries, if needed.


3b. (Optional) Configuring Reachability of All Teams Users from BPCC

All Teams users can be dialed from BPCC via an attendant, even if you are not able to assign a single prefix to all their phone numbers. In order to do this, take the following steps:

  1. Obtain a Microsoft Teams Phone Resource Account license for your Microsoft 365 account.

  2. In the Microsoft Teams admin center, navigate to Voice > Resource Accounts, click Add, and create an Auto Attendant-type resource account.

  3. In the Microsoft 365 admin center, you need to assign the attendant a phone license and a phone number:

    • Navigate to Users > Active Users and open the newly created attendant user.

    • From the Licenses and apps tab, assign the Teams Phone Resource Account license to the attendant.

    • From the Account tab, under the heading Phone number, click Manage contact information to add a phone number. Ensure that the phone number has the prefix necessary to be called from BPCC. In this example, the attendant will have a phone number with the format +1000XXXX, where X is a digit.

  4. Follow the Microsoft documentation to create an auto attendant that plays a menu prompt and offers dial by name.

  5. Associate the attendant with the resource user via the Resource User properties.

  6. Calling the auto attendant number via BPCC will reach the attendant. Any Teams or Microsoft 365 user with a phone number can then be reached by dialing their name followed by the pound symbol.

  7. A string now can be entered into the Microsoft 365 user contact field (e.g., Office Phone: 10001111,,222222# where 10001111 is the attendant number and 222222 is the dial by name string. Note that this tool uses 0 for space.).

Diagnostics Checklists

Testing Microsoft Teams to Bright Pattern Contact Center Calls

  • The Teams user has an E1/E3 license + Office 365 Phone System, or an E5 license.

  • The Teams user has a calling policy selected that includes outgoing calls.

  • The Teams user is assigned a Voice routing policy with the appropriate dialed number pattern, and that has the correct SBC enrolled.

  • The SBC is configured with the correct domain and port.

  • Your service provider has configured your contact center to correctly identify the dialing extension you are using in Teams to indicate a call to a BPCC contact.

Testing Bright Pattern Contact Center to Microsoft Teams Calls

  • There is a Teams user assigned the dialed number with the appropriate licenses.

  • Your service provider has configured the TLS SIP processor.

  • Your service provider has configured a single-tenant PBX trunk for calling Microsoft Teams.

  • The dialed number matches the dial-out prefix of the trunk.

  • The trunk’s number-changing parameters correctly transform the incoming and outgoing numbers.
    < Previous | Next >