Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.









Anchor
_gsbejtt3u5w5
_gsbejtt3u5w5

Microsoft Teams Implementation Guide





Anchor
_Toc111810194
_Toc111810194

...

The Service Provider Peeredge Orchestrator is an appliance that can be deployed on the customer premise, hosted in the 46 Labs Cloud, deployed on the customer premise, or deployed as a virtual machine on customer-provided bare metal or a VMware ESXi host. The Orchestrator contains the Peeredge SBC application.

...

Anchor
_Toc111810195
_Toc111810195

Revision History

Version

Description of Changes

Date Revised

1.0

Initial version

8/24/2022







Anchor
_c2liv2mquvj0
_c2liv2mquvj0
Anchor
_n2j6qplrbca2
_n2j6qplrbca2
Anchor
_Toc111810196
_Toc111810196

...

Anchor
_Toc111810199
_Toc111810199

...

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

Anchor
_Toc111810200
_Toc111810200

...

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 not already created and verified.

  • For more information about Microsoft SBC domain names, click here.

...

Domain Name

Usable for SBC FQDN?

FQDN Example Names

46ldev.com

Yes

Valid

  • dal-sbc1.46ldev.com

voice46.com

Yes

Valid

  • sbc1.voice46.com, loc1.voice46.com, asia.voice46.com

Non-valid

  • sbc1.asia.voice46.org

asia.voice46.com

Yes

Valid

  • sbc1.asia.voice46.org

*.onmicrosoft.com

No

*.onmicrosoft.com is not supported

  • Table note The IPs and domain names in this document are examples.

...

Anchor
_Toc111810204
_Toc111810204

...

1. Connect the SBC with phone system and validate connection

Using the Microsoft Teams admin center

To add the Peeredge SBC to Direct Routing:

...


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.

...

Anchor
_Toc111810207
_Toc111810207

3. Configure call routing

Call routing has 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.

...

Create the PTSN usages

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.

...

A Rate deck is a table that shows a call destination and cost to complete. Rate decks can be assigned to any type of trunk group. There are five types of rate decks.

A Prefix Jurisdiction (NPANXX) Rate Deck


A DID Rate Deck


A Toll-Free Rate Deck


A Dialed Rate Deck


An EEA Rate Deck



For US-Based Customers

An Origination Customer Trunk Group is typically assigned a US & Canada DID rate deck and a US & Canada Toll-Free rate deck.

...

This section describes the minimum requirements needed to configure a Peeredge SBC interconnection with the Microsoft Teams Direct Routing Interface. The high-level steps for configuring the Peeredge SBC include:

Step 1. Create a Customer Relationship
Step 2. Create a Vendor (PSTN Provider) Relationship
Step 3. Create an Origination Customer Trunk Group
Step 4. Create a Termination Customer Trunk Group
Step 5. Create an Origination Vendor Trunk Group
Step 6. Create a Termination Vendor Trunk Group
Step 7. Create and assign Origination Customer Rate Decks
Step 8. Create and assign Termination Customer Rate Decks
Step 9. Create and assign Origination Vendor Rate Decks
Step 10. Create and assign Termination Vendor Rate Decks
Step 11. Create and assign an Origination Customer Routeplan
Step 12. Create and assign a Termination Customer Routeplan

Anchor
_Step_1._
_Step_1._
Anchor
_Toc111810216
_Toc111810216

...

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.

...

Step 7. Create and assign Origination Customer Rate Decks

Name (example)

Location

Direction

Relationship

Deck Type

Teams-US-OC-DID

US & Canada

Origination

Customer

DID

Teams-US-OC-TF

US & Canada

Origination

Customer

Toll-Free

  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. Click the + Add Rate Deck button in the top right corner.

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

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

  7. Click the Add Rating button.

...

Step 8. Create and assign Termination Customer Rate Decks

Name (example)

Location

Direction

Relationship

Deck Type

Teams-US-TC-PJ-LRN

US & Canada

Termination

Customer

PJ (NPANXX)

Teams-US-TC-TF

US & Canada

Termination

Customer

Toll-Free

Teams-US-TC-D

US & Canada

Termination

Customer

Dialed

  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 the above 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 you add a Rate Deck, 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.

...

Step 9. Create and assign Origination Vendor Rate Decks

Name (example)

Location

Direction

Relationship

Deck Type

Teams-US-OV-DID

US & Canada

Origination

Vendor

DID

Teams-US-OV-TF

US & Canada

Origination

Vendor

Toll-Free

  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 the above table.

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

  8. 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-11 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.

...

Step 10. Create and assign Termination Vendor Rate Decks

Name (example)

Location

Direction

Relationship

Deck Type

PTSN-US-TV-PJ-LRN

US & Canada

Termination

Vendor

PJ (NPANXX)

PTSN-INTL-TV-D

US & Canada

Termination

Vendor

Dialed

  1. If the Relationships menu is collapsed, click Relationships on 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. Click the + Add Rate Deck button in the 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 button. After you add a Rate Deck, the window changes to allow you to upload a CSV file. You can also download a sample CSV file by selecting Download Sample.

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

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

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

  12. Click Save & Upload.

  13. Repeat steps 4-12 for the other US & Canada Termination Vendor Dialed Rate Deck.

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

...

  • The Dialpad should be visible in the Calls --> Phone window in the Teams Client.

    Image Removed


    Image Added

  • 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.

...