Dial pad configuration
In the Teams client, the dial pad enables users to access Public Switched Telephone Network (PSTN) functionality. The dial pad is available for users with a Teams Phone license, provided they're configured properly. The following criteria are all required for the dial pad to show:
- User has an enabled Teams Phone ("MCOEV") license
- User is homed online and not in Skype for Business on premises
- User has Enterprise Voice enabled
- User has Allow Private Calling enabled in Teams Calling Policy
To successfully place a call using the dial pad, the user must have one of the following: Microsoft Calling Plan, Operator Connect, is enabled for Direct Routing, or is able to use Shared Calling. For more information about Shared Calling, see Plan for Shared Calling.
The following sections describe how to use PowerShell to check the criteria. In most cases, you need to look at various properties in the output of the Get-CsOnlineUser cmdlet. Examples assume $user is either the UPN (UserPrincipalName) or SIP address of the user.
User has an enabled Teams Phone ("MCOEV") license
Make sure that the assigned plan for the user shows the CapabilityStatus attribute set to Enabled and the Capability set to MCOEV (Teams Phone license). You might see MCOEV, MCOEV1, and so on. All are acceptable--as long as the Capability starts with MCOEV. For more information on the Teams Phone license, see Microsoft Teams add-on licensing.
To check that the attributes are set correctly, use the following command:
(Get-CsOnlineUser -Identity $user).AssignedPlan
The output will look like the following. You only need to check the CapabilityStatus and the Capability attributes:
AssignedTimestamp Capability CapabilityStatus ServiceInstance ServicePlanId
----------------- ---------- ---------------- --------------- -------------
07-02-2020 12:28:48 MCOEV Enabled MicrosoftCommunicationsOnline/NOAM-4A-S7 4828c8ec-dc2e-4779-b502-...
07-02-2020 12:28:48 Teams Enabled TeamspaceAPI/NA001 57ff2da0-773e-42df-b2af-...
User has Microsoft Calling Plan or is enabled for Direct Routing
If the user has Microsoft Calling Plan, make sure that the CapabilityStatus attribute is set to Enabled, and that the Capability is set to MCOPSTN. You might see MCOPSTN1, MCOPSTN2, and so on. All are acceptable--as long as the Capability starts with MCOPSTN.
To check the attributes, use the following command:
(Get-CsOnlineUser -Identity $user).AssignedPlan
The output will look like the following. You only need to check the CapabilityStatus and the Capability attributes:
AssignedTimestamp Capability CapabilityStatus ServiceInstance ServicePlanId
----------------- ---------- ---------------- --------------- -------------
07-02-2020 12:28:48 MCOEV Enabled MicrosoftCommunicationsOnline/NOAM-4A-S7 4828c8ec-dc2e-4779-b502-...
07-02-2020 12:28:48 MCOPSTN2 Enabled MicrosoftCommunicationsOnline/NOAM-4A-S7 5a10155d-f5c1-411a-a8ec-...
07-02-2020 12:28:48 Teams Enabled TeamspaceAPI/NA001 57ff2da0-773e-42df-b2af-...
If the user is enabled for Direct Routing, the user must be assigned a non-null value for OnlineVoiceRoutingPolicy. To check the attribute, use the following command:
Get-CsOnlineUser -Identity $user|Select OnlineVoiceRoutingPolicy
The output should have a non-null value, for example:
OnlineVoiceRoutingPolicy
------------------------
Test_Policy
Note
If your tenant is configured with a Global OnlineVoiceRoutingPolicy that applies to all users, then a user assigned policy is not required.
User has Enterprise Voice enabled
Before you can enable voice for your users, you must assign a license to them first. To enable voice for your users, you can use the Teams admin center or PowerShell.
- In the Teams admin center, go to a Users > Manage users and select the user you want to edit. Under the Account tab > Assigned phone number, turn Enterprise Voice to On and select Save.
- For PowerShell, use the Set-CsPhoneNumberAssignment cmdlet and set the
-EnterpriseVoiceEnabled
parameter to$true
.
To check if the user has Enterprise Voice enabled, use the following PowerShell command:
Get-CsOnlineUser -Identity $user|Select EnterpriseVoiceEnabled
The output should look like:
EnterpriseVoiceEnabled
----------------------
True
Note
When assigning a phone number, Enterprise Voice enabled is automatically set to True. If a phone number is assigned and the value is False, you must use the Set-CsPhoneNumber cmdlet to set the value to True.
User is homed online and not in Skype for Business on premises
To ensure the user is homed online and not in Skype for Business on premises, the RegistrarPool must not be null and the HostingProvider must contain a value that starts with "sipfed.online." To check the values, use the following command:
Get-CsOnlineUser -Identity $user|Select RegistrarPool, HostingProvider
The output should be similar to:
RegistrarPool HostingProvider
------------- ---------------
sippoolbn10M02.infra.lync.com sipfed.online.lync.com
User has Teams Calling Policy enabled
The user's effective TeamsCallingPolicy must have AllowPrivateCalling set to true. By default, users inherit the global policy, which has AllowPrivateCallingPolicy set to true by default.
To get the TeamsCallingPolicy for a user and to check that AllowPrivateCalling is set to true, use the following command:
if (($p=Get-CsUserPolicyAssignment -Identity $user -PolicyType TeamsCallingPolicy) -eq $null) {Get-CsTeamsCallingPolicy -Identity Global} else {Get-CsTeamsCallingPolicy -Identity $p.PolicyName}
The output should look like:
Identity : Global
Description :
AllowPrivateCalling : True
AllowWebPSTNCalling : True
AllowVoicemail : UserOverride
AllowCallGroups : True
AllowDelegation : True
AllowCallForwardingToUser : True
AllowCallForwardingToPhone : True
PreventTollBypass : False
BusyOnBusyEnabledType : Disabled
MusicOnHoldEnabledType : Enabled
Additional notes
You might need to restart the Teams client after making any of these configuration changes.
If you recently updated any of the above criteria, you might need to wait a few hours for the client to receive the new settings.
If you still don't see the dial pad, check if there's a provisioning error by using the following command:
Get-CsOnlineUser -Identity $user|Select UserValidationErrors
If it's been more than 24 hours and you're still seeing problems, contact Support.