Troubleshooting Teams Operator Connect numbers and calls

See also

Sources

1. 1
   In the archived Azure Communications Gateway documentation, an enterprise requesting service in the Teams admin center creates a consent through the Operator Connect APIs, which the operator moves through statuses such as Agreement signed, Consent declined or Contract terminated.

   Use Azure Communications Gateway's Number Management Portal (preview) to manage an enterprise · Manage your agreement with an enterprise customer · Checked 2026-10-02
2. 2
   In the archived Azure Communications Gateway documentation, an operator uploading numbers supplies per-number intended usage (calling users, applications or conference calls), allowed call capabilities, and whether the enterprise may update the civic address; if updates are not allowed, the operator must specify the address.

   Use Azure Communications Gateway's Number Management Portal (preview) to manage an enterprise · Prerequisites, per-number information table · Checked 2026-10-02
3. 3
   Phone number ActivationState values that can be filtered on are Activated, AssignmentPending, AssignmentFailed, UpdatePending and UpdateFailed.

   Get-CsPhoneNumberAssignment (MicrosoftTeams) · Parameters > -ActivationState · Checked 2026-10-02
4. 4
   Trying to add Operator Connect numbers with the Add phone numbers wizard in the Teams admin center sends the admin to the operator's site instead of acquiring numbers in the admin center.

   Get Operator Connect telephone numbers for your organization - Microsoft Teams · Considerations for getting Operator Connect numbers in your tenant · Checked 2026-10-02
5. 5
   Assigning, modifying or removing a user's number requires the Teams Administrator, Teams Communications Administrator or Teams Telephony Administrator role.

   Manage phone numbers for users · Prerequisites, role list · Checked 2026-10-02
6. 6
   A phone number can carry an assignment block (AssignmentBlockedState BlockedForever or BlockedUntil) that stops it being assigned; an admin can clear it with Remove-CsPhoneNumberAssignmentBlock.

   Get-CsPhoneNumberAssignment (MicrosoftTeams) · Examples 14 and 15; Outputs > AssignmentBlockedState · Checked 2026-10-02
7. 7
   Get-CsPhoneNumberAssignment reports a number's capabilities, and the supported values for filtering are ConferenceAssignment, VoiceApplicationAssignment, UserAssignment and TeamsPhoneMobile.

   Get-CsPhoneNumberAssignment (MicrosoftTeams) · Parameters > -CapabilitiesContain; Outputs > Capability · Checked 2026-10-02
8. 8
   Operator Connect Conferencing numbers cannot be set as the default numbers of an Audio Conferencing bridge.

   Configure Operator Connect Conferencing · Acquire numbers for your Audio Conferencing bridge, Note · Checked 2026-10-02
9. 9
   With an Operator Connect Conferencing licence, outbound calls from Teams meetings can only go through the operator, and they fail to reach PSTN numbers unless an Audio Conferencing Routing policy with a voice route whose BridgeSourcePhoneNumber is an Operator Connect Conferencing bridge number is configured and assigned.

   Configure Operator Connect Conferencing · Sending outbound calls from Microsoft Teams meetings through an operator, Note and Steps 1-4 · Checked 2026-10-02
10. 10
    To move numbers from Microsoft Calling Plans to Operator Connect, the customer asks the operator to port them; once the port order completes the operator uploads the numbers to the tenant for assignment.

    Configure Operator Connect - Microsoft Teams · Move numbers from Calling Plans to Operator Connect, steps 1-3 · Checked 2026-10-02
11. 11
    Before moving a Direct Routing user to Operator Connect, Microsoft says to run Get-CsPhoneNumberAssignment -AssignedPstnTargetId <user> and confirm that NumberType is DirectRouting.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 1 · Checked 2026-10-02
12. 12
    Direct Routing numbers assigned online are moved to Operator Connect by the operator on an agreed date and time; the customer starts this by contacting the operator.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 1 (To migrate existing Direct Routing numbers assigned online) · Checked 2026-10-02
13. 13
    If Get-CsOnlineUser shows OnPremLineURI populated with an E.164 number, the Direct Routing number was assigned on-premises and synchronised to Microsoft 365.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 1 · Checked 2026-10-02
14. 14
    When migrating an on-premises-assigned Direct Routing number to Operator Connect (Set-CsUser -LineURI $null in Skype for Business Server), the number is out of service during the migration, so the cutover must be coordinated with the operator.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 1, Important box · Checked 2026-10-02
15. 15
    Removing a Direct Routing number with Remove-CsPhoneNumberAssignment can take up to 10 minutes, and in rare cases up to 24 hours; Get-CsOnlineUser | fl LineUri confirms removal.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 1, paragraph after Remove-CsPhoneNumberAssignment · Checked 2026-10-02
16. 16
    After the Direct Routing number is unassigned, the user's online voice routing policy should be removed with Grant-CsOnlineVoiceRoutingPolicy -Identity <user> -PolicyName $Null before the Operator Connect number is assigned.

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 2 · Checked 2026-10-02
17. 17
    Every Operator Connect user is automatically enabled for emergency calling, and emergency calls are routed automatically to the Operator Connect carrier for that number.

    Considerations for Operator Connect · Emergency call enablement for Operator Connect, first paragraph · Checked 2026-10-02
18. 18
    Whether a tenant admin can set, modify or delete an Operator Connect user's registered emergency address depends on the capabilities the carrier assigned to the number when it uploaded it into the customer's inventory.

    Considerations for Operator Connect · Emergency call enablement for Operator Connect, second paragraph · Checked 2026-10-02
19. 19
    To activate a phone number in Belgium, France, Germany, Ireland, the Netherlands or Spain, the address in the emergency location must match the number's area code.

    Manage emergency locations · Add an emergency location, Note · Checked 2026-10-02
20. 20
    If the operator assigns emergency addresses and does not allow changes, the admin must contact the operator to change a number's emergency address.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Assign numbers to emergency addresses, third bullet · Checked 2026-10-02
21. 21
    If an Operator Connect emergency caller who is being screened cannot update their location, the call is transferred to the PSAP serving the caller's registered address.

    Considerations for Operator Connect · Emergency call routing for Operator Connect, last bullet · Checked 2026-10-02
22. 22
    A number's emergency location can be removed (Set-CsPhoneNumberAssignment -LocationId 'null') for Direct Routing numbers and for Operator Connect numbers that are not managed by the Service Desk.

    Set-CsPhoneNumberAssignment (MicrosoftTeams) · Parameters > -LocationId; Example 4 · Checked 2026-10-02
23. 23
    To assign an emergency location, the location, the users and the phone numbers must all be in the same country.

    Manage emergency locations · Assign an emergency location, first paragraph · Checked 2026-10-02
24. 24
    For Operator Connect numbers the operator implements one of three emergency-address scenarios: it assigns addresses and lets the admin change them, it leaves assignment to the admin, or it assigns addresses and does not let the admin change them.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Assign numbers to emergency addresses · Checked 2026-10-02
25. 25
    For US Operator Connect users, an emergency address the Teams client acquires dynamically inside the US overrides the registered address and the call goes to the PSAP for that address; otherwise the registered address is used to screen and route, with Common Area Phones and Teams Rooms going directly to the PSAP.

    Considerations for Operator Connect · Dynamic emergency calling for Operator Connect, US bullets · Checked 2026-10-02
26. 26
    An emergency location's address can only be updated if it has not been validated; to correct a validated address the location must be deleted and recreated, and a location can only be deleted once no users or numbers are assigned to it.

    Manage emergency locations · Change an emergency location; Remove an emergency location · Checked 2026-10-02
27. 27
    An operator is enabled in the Teams admin center under Voice > Operator Connect by choosing the operator, selecting countries/regions, giving contact details, accepting the data transfer notice and selecting Add as my operator.

    Configure Operator Connect - Microsoft Teams · Enable an operator, steps 1-5 · Checked 2026-10-02
28. 28
    Because of latency between Microsoft 365 and Teams, users can take up to 24 hours to be enabled after number assignment; if the number still isn't assigned correctly after 24 hours, Microsoft points admins to the Phone Number Service Center.

    Manage phone numbers for users · Use PowerShell to assign a phone number to a user, first Note · Checked 2026-10-02
29. 29
    The -Filter parameter of Get-CsPhoneNumberAssignment accepts IsOperatorConnect, PstnPartnerName, NumberType, Capability, ActivationState and PstnAssignmentStatus, among other attributes.

    Get-CsPhoneNumberAssignment (MicrosoftTeams) · Description, supported Filter attributes list · Checked 2026-10-02
30. 30
    Get-CsPhoneNumberAssignment returns at most 500 numbers by default and up to 1000 with -Top; larger inventories need -Skip and -Top paging, or Export-CsAcquiredPhoneNumber for a full list.

    Get-CsPhoneNumberAssignment (MicrosoftTeams) · Description, final two paragraphs · Checked 2026-10-02
31. 31
    In hybrid deployments, before an Operator Connect number can be assigned, any number in the msRTCSIP-Line attribute of the on-premises AD object must be removed and the change synchronised to Microsoft 365.

    Manage phone numbers for users · Prerequisites, second Note · Checked 2026-10-02
32. 32
    The My operators tab lets an admin view operator status, manage operator services by country/region, suspend an operator or remove an operator.

    Configure Operator Connect - Microsoft Teams · Manage your operators · Checked 2026-10-02
33. 33
    When an ordered Operator Connect number is missing from Voice > Phone numbers, the documented dependencies suggest checking in order that the operator was enabled in the Teams admin center for the right country, that the operator has the correct tenant ID, and that the operator has finished the order and uploaded the numbers.inferred

    Configure Operator Connect - Microsoft Teams · Enable an operator; Acquire numbers for new Teams users steps 3-4 · Checked 2026-10-02
34. 34
    Operator Connect numbers appear in the tenant only after the operator completes the order and uploads them; they are then visible with their provider under Voice > Phone numbers in the Teams admin center.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Acquire numbers for new Teams users, step 4 · Checked 2026-10-02
35. 35
    The NumberType (alias PhoneNumberType) parameter of Set-CsPhoneNumberAssignment and Get-CsPhoneNumberAssignment accepts DirectRouting, CallingPlan and OperatorConnect.

    Set-CsPhoneNumberAssignment (MicrosoftTeams) · Parameters > -NumberType · Checked 2026-10-02
36. 36
    To move numbers from Operator Connect to Teams Phone Mobile, the admin removes them from users, has the existing Operator Connect provider remove them from the tenant, and then has the Teams Phone Mobile operator port and upload them.

    Manage phone numbers for Teams Phone Mobile · Move numbers from Operator Connect to Teams Phone Mobile, steps 1-6 · Checked 2026-10-02
37. 37
    If a user or resource account has a phone number set in on-premises Active Directory and synchronised to Microsoft 365, Set-CsPhoneNumberAssignment cannot assign a number until that value is cleared on-premises and the change syncs.

    Set-CsPhoneNumberAssignment (MicrosoftTeams) · Notes, third paragraph · Checked 2026-10-02
38. 38
    Before an Operator Connect number is assigned the user needs a Phone System (Teams Phone) licence, assigned from the Microsoft 365 admin center or with PowerShell.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Acquire numbers for new Teams users, step 1 · Checked 2026-10-02
39. 39
    Users who will be assigned phone numbers acquired through Operator Connect must be in TeamsOnly coexistence mode; in an Islands-mode organisation the per-user Teams upgrade setting must be TeamsOnly.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Acquire numbers for new Teams users, step 2 · Checked 2026-10-02
40. 40
    PSTN usage report data usually lags activity by 24 to 48 hours.

    Microsoft Teams PSTN usage report · Interpret the report > Calling Plans, callout 2 · Checked 2026-10-02
41. 41
    The SIP call flow ladder and the Final SIP code, Final Microsoft subcode and Final SIP phrase fields are documented only on the Direct Routing tab, so the admin center report probably gives no SIP-level failure detail for Operator Connect calls and that diagnosis sits with the operator.inferred

    Microsoft Teams PSTN usage report · Interpret the report > Calling Plans callout 4 versus Direct Routing callouts 4-5 · Checked 2026-10-02
42. 42
    In the Teams admin center PSTN usage report, Operator Connect calls appear on the Calling Plans tab, which groups Calling Plans and Operator Connect, and the Operator column shows the customer's PSTN carrier.

    Microsoft Teams PSTN usage report · Introduction paragraph 2; Interpret the report > Calling Plans, callout 4 (Operator) · Checked 2026-10-02
43. 43
    Every resource account used by an auto attendant or call queue needs a Microsoft Teams Phone Resource Account licence, whether or not it has a phone number.

    Manage - Resource accounts for voice applications · Obtain Microsoft Teams Phone Resource Account licenses; Assign a license · Checked 2026-10-02
44. 44
    If a resource account needs a phone number, the Select location value on its Licenses and Apps tab in the Microsoft 365 admin center should match the intended country code.

    Manage - Resource accounts for voice applications · Assign a license, Note · Checked 2026-10-02
45. 45
    Operator Connect numbers are among the number types Microsoft lists as acceptable for resource accounts, alongside Calling Plans service numbers and Direct Routing numbers.

    Manage - Resource accounts for voice applications · Obtain phone numbers, acceptable phone numbers list · Checked 2026-10-02
46. 46
    Field reports show that assigning an Operator Connect number uploaded with user usage to a resource account fails with an error that the number is only licensed for users; the advice given is to ask the operator to convert it to a service number.field report

    Unable to assign phone number to resource account - Microsoft Q&A · Accepted answer by Microsoft moderator, 2022-05-05 · Checked 2026-10-02
47. 47
    In the Teams admin center Phone numbers page an unassigned number can be released directly, while an assigned number must first be unassigned from its user before Release is available.

    Configure Operator Connect - Microsoft Teams · Release numbers · Checked 2026-10-02
48. 48
    Before an operator can be removed from the organisation or from a country/region, all phone numbers assigned to users there must be removed and the operator contacted to release the numbers.

    Configure Operator Connect - Microsoft Teams · Manage your operators, Note · Checked 2026-10-02
49. 49
    Operator Connect service numbers (for Audio Conferencing, auto attendants and call queues) have higher concurrent call capacity than user numbers and are obtained by contacting the operator.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Acquire numbers for new Teams users, Note · Checked 2026-10-02
50. 50
    Assigning a phone number with Set-CsPhoneNumberAssignment automatically sets the user's or resource account's EnterpriseVoiceEnabled flag to True.

    Set-CsPhoneNumberAssignment (MicrosoftTeams) · Description · Checked 2026-10-02
51. 51
    After a Direct Routing to Operator Connect move, a leftover online voice routing policy on the user is a reasonable first suspect for outbound call failures, because Microsoft's procedure makes removing it a separate required step.inferred

    Configure Operator Connect - Microsoft Teams · Move numbers from Direct Routing to Operator Connect > Step 2 · Checked 2026-10-02
52. 52
    Microsoft is responsible for Teams services, Teams Phone administration, Teams admin center functionality and the integration between Teams and Operator Connect.

    Plan for Operator Connect · Support boundaries, Microsoft list · Checked 2026-10-02
53. 53
    The Operator Connect provider is responsible for PSTN connectivity, number provisioning and porting, calling services and PSTN-related support and troubleshooting.

    Plan for Operator Connect · Support boundaries, operator list · Checked 2026-10-02
54. 54
    Moving numbers from one Operator Connect operator to another probably follows the same pattern: unassign the numbers, have the losing operator remove them from the tenant, then have the gaining operator port and upload them.inferred

    Manage phone numbers for Teams Phone Mobile · Move numbers from Operator Connect to Teams Phone Mobile (analogy) · Checked 2026-10-02
55. 55
    Operator Connect numbers are ordered on the operator's own website, and the customer must give the operator its Microsoft 365 tenant ID.

    Configure Operator Connect - Microsoft Teams · Set up phone numbers > Acquire numbers for new Teams users, step 3 · Checked 2026-10-02
56. 56
    Teams Phone Mobile numbers are assigned with Set-CsPhoneNumberAssignment using -PhoneNumberType OperatorConnect, the same number type as Operator Connect numbers.

    Manage phone numbers for users · Use PowerShell to assign a phone number to a user (For Teams Phone Mobile numbers) · Checked 2026-10-02
57. 57
    When a phone number is assigned to a user, the number and the user's usage location must be in the same country/region.

    Manage phone numbers for users · Prerequisites, second paragraph · Checked 2026-10-02
58. 58
    Under Operator Connect the phone number services agreement is between the customer and the operator, and requirements such as assigning number usage types and emergency calling services may be fulfilled with the operator.

    Get Operator Connect telephone numbers for your organization - Microsoft Teams · Introductory paragraphs (before Considerations heading) · Checked 2026-10-02
59. 59
    Teams Phone has three number usage types: User (subscriber numbers for users or devices), Voice app (service numbers for resource accounts behind auto attendants and call queues) and Conference (service numbers for conference bridges).

    Acquire phone numbers for your organization - Microsoft Teams · Number usage types (table) · Checked 2026-10-02
60. 60
    The User number usage supports only geographic (toll) numbers, while Voice app and Conference usages support both geographic (toll) and toll-free numbers.

    Acquire phone numbers for your organization - Microsoft Teams · Number usage types (table), column Number type supported · Checked 2026-10-02

Documents

Cite this page

WarmTransfer. (2026, October 2). Troubleshooting Teams Operator Connect numbers and calls. WarmTransfer. https://warmtransfer.net/knowledge/teams-operator-connect-troubleshooting

@misc{warmtransfer-teams-operator-connect-troubleshooting,
  title  = {Troubleshooting Teams Operator Connect numbers and calls},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/teams-operator-connect-troubleshooting},
  note   = {Verified 2026-10-02}
}