Microsoft Teams Implementation Guide

...

• For more prerequisite details, see Microsoft's document for Plan Direct Routing.

...

Direct Routing requires a custom domain for each Office 365 tenant. For more information, click here.

...

The domain names for SBCs must be in the list of domain names registered in the "Domains" section under Settings of the Microsoft 365 admin center menu. The domain of a tenant must be activated and have a Healthy status. Go to the admin dashboard to add domains that are not already created and verified.

...

• To learn more about SBC certificates, refer to this Microsoft documentation.

...

1. Connect the SBC with Phone System and validate connection

Using the Microsoft Teams admin center

To add the Peeredge SBC to Direct Routing:

...

• Create the user in your on-premise Active Directory and sync the user to the cloud

• Create the user directly in the Tenant using the Microsoft 365 admin center, Microsoft 365 Azure Active Directory Portal, or via PowerShell.

Must be configured for Teams Only mode

...

Must be homed online, enabled for enterprise voice, and assigned a phone number

Using the Microsoft Teams admin center:

1. Go to Users -> Manage users.

2. Select a user.

3. Under Account General information, select Edit.

4. Under Assign phone number, click the Phone number type drop-down menu and select Direct Routing.

5. Enter an assigned phone number and a phone number extension if applicable.

6. Click Apply.

...

3. Configure call routing

Call routing is made up of the following elements:

Call routing policy

Also called a Voice Routing policy. A container for PSTN usages, which can be assigned to a user or to multiple users. Sample Call routing policy names include:

• US Only

• US Global

• Germany Only

• Germany Global

• Internal

PSTN usages

A container for voice routes and PSTN usages, which can be shared in different voice routing policies. Sample PSTN usage names include:

• US-Emergency

• US-LD

• US-INTL

• Company-Internal

Voice routes

A number pattern and set of online PSTN gateways for calls where the calling number matches the pattern. In the examples below, the Internal voice routes represent routes to company-managed third-party PBXs used by employees that have not yet migrated to MS Teams. Sample Voice route names and their associated dialed number patterninclude:

• US Emergency ^933$

• US LD e164 ^+1[2-9]\d{2}[2-9]\d{6}$

• US INTL e164 ^+[2-9]\d+$

• Reston Internal ^+170355512\d{2}$

• Chicago Internal ^+13125556[43]\d{2}$

Online PSTN gateway

This is a pointer to the Peeredge SBC that also stores the configuration which is applied when a call is placed through the SBC, such as forward P-Asserted-Identity (PAI) or Preferred Codecs. The pointer can be added to voice routes.

Two examples (from Microsoft) of voice routing policies in a call flow.

...

In the following example, we create four PSTN usage records. We suggest admins use easy-to-understand names representing the types of calls a user is allowed to dial. Using the Microsoft Teams admin center:

1. Go to Voice -> Direct Routing.

2. Select Manage PSTN usage records in the top right corner of the page.

3. Click + Add and enter the name of the PSTN usage record.

4. Repeat step 3 to add more records.

5. Click Apply to finish.

...

In the following example, we create four voice routes. The dial number patterns are in the form of a regular expression (regex). You can validate your regex patterns.
Using the Microsoft Teams admin center:

1. Go to Voice -> Direct Routing.

2. Click the Voice routes button.

3. Click the Add button.

4. Add the name Non-Emergency Test in the voice route in the Add a name for your voice route field.

5. Make sure the Priority is 1.

6. Make sure the Dialed number pattern is ^933$.

7. Click the Add SBCs button and select your Peeredge SBCs and then click Apply.

8. Click the ADD PSTN usage button and select the US-Emergency PSTN Usage and then click Apply.

9. Click Save.

10. Repeat steps 3 – 9 for any other voice routes using an appropriate priority and PSTN Usage. When overlapping dialed number patterns exist, give the more specific pattern higher priority.

...

Create the voice routing policy

Using the Microsoft Teams admin center:

1. Go to Voice -> Voice routing policies.

2. Click the + Add button.

3. Add the policy name in the Add a name for your voice routing policy field.

4. Add an appropriate description.

5. Add one or more PSTN usages.

6. Click Save.

7. Repeat steps 2 – 6 for each voice routing policy.

...

Assign the voice routing policy to a user

Using the Microsoft Teams admin center:

1. Go to Voice -> Voice routing policies.

2. Highlight the voice policy you want to assign.

3. Click the Assign button.

4. In the Manage user search box, search for the user and click add when found.

5. Click Apply.

...

The example below shows how to add a typical US dial plan.

Using the Microsoft Teams admin center:

1. Go to Voice -> Dial plans.

2. Click the +Add button to add a Tenant dial plan.

3. Add the dial plan name (US DP) in the Add a name for your dial plan field.

4. Add an appropriate description (Tenant User Dial plan for US-based users).

5. Add an External dialing prefix (8). Legacy PBX was often configured with 8 or 9 as an external dialing prefix to route the call to an external line.

6. Set Optimized device dialing to ON if you configured an External dialing prefix.

7. Click the Add button under Normalization rules to open the Add new rule pane.

8. Enter a rule name (Non-Emergency Test Call) in the Name field.

9. Add an appropriate description.

10. Select an appropriate Rule creation mode (Advanced).

11. Enter a dial pattern to match (^(911)$) in the If condition.

12. Enter the translation/number manipulation ($1) in the Then do this field.

13. Optionally, enter a number in the test this rule field to validate the rule. A validated test results in, "The translated number is an E.164 phone number."

14. Click Save.

15. Repeat steps 7 – 14 to add Normalization rules.

16. Click Save.

...

1. Go to the Tree View in the left panel and click Relationships if the menu is collapsed. If the Tree View is expanded, click on All.

2. Select the Customer Relationship you created in Step 1.

3. Select Click the Trunk Groups menu tab (next to the Relationship Info menu).

4. Click the + Add Group button in the top right corner.

5. Enter an appropriate name for the Trunk Group in the Name field. For example, To Teams.

6. Select Origination on the drop-down menu in the Direction field,

7. Select Customer on the drop-down menu in the Relationship field.

8. Set the Max PDD to 10 seconds (or another appropriate value).

9. Set the B-Timer to 4 seconds (or another appropriate value).

10. Enable these options: Send E.164, Send PAI, Trunk Monitoring, Preserve Caller ID, Ignore Privacy Header, and Early Media.

11. Click Create.

...

The Microsoft SIP Proxy FQDNs and IP addresses used SIP signaling (and related firewall information) with Microsoft Teams Direct Routing are defined in this section of the Microsoft documentation.

1. Go to the Tree View in the left panel and click Relationships if the menu is collapsed. If the Tree View is expanded, click All.

2. Select the Customer Relationship you created in Step 1.

3. Select the Trunk Groups menu tab (next to the Relationship Info menu).

4. Click the + Add Group button in the top right window.

5. Enter an appropriate name for the Trunk Group in the Name field. For example, From Teams.

6. Select Termination on the drop-down menu in the Direction field.

7. Select Customer on the drop-down menu in the Relationship field.

8. Set the Max PDD to 10 seconds or another appropriate value.

9. Set the STIR/SHAKEN Treatment to No Treatment.

10. Verify the ANI Normalization and Normalize sipcodes attributes are enabled.

11. Click Create.

...

1. Select the Vendor Relationship you created in Step 2.

2. Select the Trunk Groups menu tab (next to the Relationship Info menu).

3. Select the + Add Group button in the upper right window.

4. Enter an appropriate name for the Trunk Group in the Name field. For example, From PSTN.

5. Select Origination from the drop-down selector in the Direction field.

6. Select Vendor from the drop-down selector in the Relationship field.

7. Set the Max PDD to 10 seconds or another appropriate value.

8. Set the STIR/SHAKEN Treatment to No Treatment.

9. Verify Caller ID override type is set to Off.

10. Verify the ANI Normalization attribute is enabled.

11. Click Create.

...

1. If the Relationships menu is collapsed, click on Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All immediately under Relationships

2. Select the Vendor Relationship you created in Step 2.

3. Select the Trunk Groups menu tab (next to the Relationship Info menu).

4. Select the + Add Group button in the upper right window.

5. Enter an appropriate name for the Trunk Group in the Name field. For example, To PSTN.

6. Select Termination from the drop-down selector in the Direction field.

7. Select Vendor from the drop-down selector in the Relationship field.

8. Set the Max PDD to 10 seconds or another appropriate value.

9. Set the B-Timer to 4 seconds or another appropriate value.

10. Enable the Send E.164, Send PAI, Preserve Caller ID, Ignore Privacy Header, and Early Media options.

11. Click the Create button.

...

1. Click Trunks in the upper center of the window.

2. Verify the Trunk type is set to IP.

3. In the IP Address field, enter the vendor's SBC IP address.

4. In the Port field, enter the vendor's SBC IP Port.

5. In the Protocol field, select the appropriate protocol from the drop-down menu.

6. From the Location field, drop-down select the first available location (e.g. dal1).

7. From the Zones field drop-down, select the appropriate zone (e.g. default).

8. From the Switch IP field drop-down, select the Switch IP.

9. Click the Add Trunk button.

10. Repeat steps 2-9 to add a trunk for each of the vendor's SBCs.

11. Repeat steps 2-10 for every other SBC deployed location (e.g. ash1) shown in the Location drop-down menu.

...

1. If the Relationships menu is collapsed, click Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click All immediately under Relationships

2. Select the Customer Relationship you created in Step 1.

3. Select the Rating menu tab.

4. Select Click the + Add Rate Deck button in the upper top right windowcorner.

5. Enter an appropriate name for the Rate Deck in the Name field. See table.

6. Select the appropriate Location, Direction, Relationship, and Deck Type. See table.

7. Click the Add Rating button.

...

• The second method is to click the three dots at the far left of the Rate Deck Name in the Rating window and then click Assign To Trunk Group. Select a rate deck from on the drop-down menu and then click Assign.

...

1. If the Relationships menu is collapsed, click Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All under Relationships.

2. Select the Customer Relationship you created in Step 1.

3. Click the Rating menu tab.

4. Click the + Add Rate Deck button in the upper right window.

5. Enter an appropriate name for the Rate Deck in the Name field. See table.

6. Select the appropriate Location, Direction, Relationship, and Deck Type. See table for the Prefix Jurisdiction (NPANXX) Deck Type select LRN for the Rate by field.

7. Uncheck the Requires Confirmation field.

8. Click the Add Rating button.

9. Once the you add a Rate Deck is added, the window changes to allow you to upload a CSV file. You can also download a sample CSV file by selecting Download Sample.

10. Click Upload document or drag the CSV file onto the window.

11. Match the column headers in the CSV file to the appropriate fields.

12. Optionally change the Effective Date or add an Expiration Date for the Rate Deck.

13. Click Save & Upload.

14. Repeat Steps 4 – 13 for the other US & Canada Termination Customer Toll-Free Rate Decks.

15. Use one of the two ways to assign Rate Decks to the Termination Customer Trunk Group.

When finished, the The Rating table in the Customer Relationship looks , when finished, should look something like this.

...

The Trunk Group table in the Customer Relationship looks , when finished, should look something like this.

...

...

1. If the Relationships menu is collapsed, click Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All immediately under Relationships

2. Select the Vendor Relationship you created in Step 2.

3. Click the Rating menu tab.

4. Select the + Add Rate Deck button in the upper right window.

5. Enter an appropriate name for the Rate Deck in the Name field. See table.

6. Select the appropriate Location, Direction, Relationship, and Deck Type. See table.

7. Click the Add Rating button. Once the you add a Rate Deck is added, the window changes to allow you to upload a CSV file. You can also download a sample CSV file by selecting Download Sample.

8. Either click Click Upload document or drag the CSV file onto the window.

9. Match the column headers in the CSV file to the appropriate fields.

10. Optionally change the Effective Date or add an Expiration Date for the Rate Deck.

11. Click Save & Upload.

12. Repeat Steps 4 – 12 for the US & Canada Origination Vendor Toll-Free Rate Deck.

13. Use one of the two ways to assign Rate Decks to the Origination Vendor Trunk Group.
    
    

Anchor
_Step_10._Creating _Step_10._Creating

Anchor
_Toc111810225 _Toc111810225

Step 10. Create and assign Termination Vendor Rate Decks

...

1. If the Relationships menu is collapsed, click Relationships on Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All immediately under Relationships

2. Select the Vendor Relationship you created in Step 2.

3. Select Click the Rating menu tab.

4. Select Click the + Add Rate Deck button in the upper top right window.

5. Enter an appropriate name for the Rate Deck in the Name field. See table.

6. Select the appropriate Location, Direction, Relationship, and Deck Type. See table. For the Prefix Jurisdiction (NPANXX) Deck Type, select LRN for the Rate by field.

7. Uncheck the Requires Confirmation field.

8. Click the Add Rating buttonOnce the .

9. After you add a Rate Deck is added , the window will change changes to allow you to upload a CSV file. You can also download a sample csv CSV file by selecting Download Sample.

10. Either click Click Upload document or drag the csv CSV file onto the window.

11. Match the column headers in the csv CSV file to the appropriate fields.

12. Optionally change the Effective Date or add an Expiration Date for the Rate Deck

13. Click Save & Upload.

14. Repeat Steps 4 – 13 for the other US & Canada Termination Vendor Dialed Rate Deck.

15. Use one of the two ways to assign the Rate Decks to the Termination Vendor Trunk Group.

When finished the The Rating table in the Vendor Relationship will be , when finished, should look something like this .

When finished the

The Trunk Group table in the Vendor Relationship, when finished, will be something like this.

...

Step 11. Create and assign an Origination Customer Routeplan

1. If the Relationships menu is collapsed, click on Relationships from in the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All immediately under Relationships

2. Select the Customer Relationship you created in Step 1.

3. Select Click the Routing menu atb.

4. The Select Click the + Add Routeplan button in the Origination section.

5. Add an appropriate name in the Routeplan Name field (e.g To Teams RP).

6. Click the Create Button.

7. Select the Numbering Page.

8. To add one Telephone number at a time, click the + Add Number button.

9. Enter the e.164 number (less the + symbol) in the Number field.

10. Select the appropriate Number Type (e.g. DID).

11. For DID Number, select the Customer Tier (e.g. 1) and the Vendor Tier (e.g. 1).

12. Click the Add Number button.

...

1. To upload a range of telephone numbernumbers, click the Upload Number button.

2. You can download a sample csv CSV file by clicking Download Sample.

3. Select the appropriate Upload option.

4. Either drag the csv CSV file into the drop box or click Upload document to select the csv CSV file.

5. Click the Upload button.

...

Step 12. Create and assign a Termination Customer Routeplan

1. If the Relationships menu is collapsed, click Relationships on Relationships from the Tree View in the left panel to view All existing Relationships. If it is expanded, click on All immediately under Relationships

2. Select Click the Customer Relationship you created in Step 1.

3. Select Click the Routing menu tab.

4. The Select Click the + Add Routeplan button in the Termination section.

5. Add an appropriate name in the Routeplan Name field (e.g. To PSTN RP).

6. Set the Profit Protection to Off.

7. Click the Create Button.

8. Select the Routing Rules Page.

9. Click the + Add Rule button.

10. Add an appropriate name in the Rule Name field (e.g. Route to PSTN).

11. In the Vendor Considers section, check the desired Trunk Group from the list.

12. Click Add Routing Rule.

...

Troubleshooting

The Dialpad is missing in the Teams client

• 
  The Dialpad should be visible in the Calls  Phone window in the Teams Client.
  
  Image Modified

• Check to see if the Teams User is assigned Skype for Business Online (Plan 2) license and the Microsoft Phone System.

• Check to see if the Teams User has been assigned a Telephone number.

• Check to see if the Teams User has been assigned a Voice Routing Policy .
  

• Run the Teams Dial Pad is Missing Tests from the Microsoft 365 admin center.
  
  

TLS Handshake and Certificate Issues

From the Team admin center, select Voice  Direct Routing and verify the SBCs tab is displayed.

• If the TLS connectivity status show Active, then the Microsoft SIP Proxy has successfully established a TLS connection to the Peeredge SBC.

• If the TLS connectivity status show Inactive, then the Microsoft SIP Proxy cannot establish a TLS connection to the Peeredge SBC.

• Verify the FQDN is spelled correctly.

• Verity the FQDN is resolvable by a Public DNS server, and the IP address is correct.

• At this point, the best option is to contact 46 LABS support to help troubleshoot why the TLS handshake is failing.

SIP 401 Unauthorized Response from the Peeredge SBC.

The Peeredge SBC uses the Termination Customer and Origination Vendor Trunk Groups to verify the source of all inbound SIP messages. Specific to a Microsoft Teams deployment, the Termination Customer Trunk Group must have the 52.112.0.0 and the 52.120.0.0 entries configured for Port 1 and the TLS 1.2 Protocol for each SBC.

CDR Diagnostic Report

the The CDR Diagnostic Report will contain contains all call detail records for every call between any Customer Relationship Trunk Group and any Vendor Relationship Trunk Group.

1. Termination filters all All CDRs from Termination Customer Trunk Group (ingress call leg) to a Termination Vendor (egress call leg) (e.g. PSTN Outbound Calls).

2. CDR Export allows Allows you to download exported CDRs.

3. Origination filters all All CDRs from an Origination Vendor Trunk Group (ingress call leg) to an Origination Customer (egress call leg) (e.g. PSTN Inbound Calls).

4. Live Calls display Display all calls in progress. Optionally, an individual call be selected and Killedkilled.

5. The Time Filter This drop down offers several command time frames to filter on.

6. The Date/Time selector allow to define Define a specific start date and time and a specific end date and time.

7. All will display CDRs based Based on the selected direction (Termination/Origination) and selected dime filters.

8. Completed will further Further filter the CDRs to just those with the 2xx Release Code.

9. Failed will further Further filter the CDRs to just those with a 4xx/5xx/6xx Release Code.

10. The Table Columns button will allow to select Select which columns to display and to rearrange the order in which they of display.

11. Filter button will allow you to refine Refine your filter to specific Customer Trunk Groups, Vendor Trunk Groups, Minimum and Maximum call durations, a specific ANI, Dialed Number, SIP Call ID, or Cause Code.

12. The set of CDRs that match the filter criteria will be display. The Search box allows you to further filter on any text string within this set of CDRs.

13. Export initiates Initiate an export task that will and create a CSV file containing all the CDRs that match all your filter criteria. Use the CDR Export to download them once they are generated.

14. Lookup LRN/Spam – XXX

If you select click the three dots to the right of an individual CDR, you are present presented with three additional options.

1. To view View the Call Path

2. To download Download a trace file (which can be viewed in Wireshark or application that can view pcap files.

3. To download Download this specific CDR record.

An example of a Live Call window.