Manage resource accounts in Microsoft Teams

A resource account is also known as a disabled user object in Azure Active Directory, and can be used to represent resources in general. In Exchange it might be used to represent conference rooms, for example, and allow them to have a phone number. A resource account can be homed in Microsoft 365 or on premises using Skype for Business Server 2019.

In Microsoft Teams or Skype for Business Online, each call queue or auto attendant is required to have an associated resource account. Whether a resource account needs an assigned phone number will depend on the intended use of the associated call queue or auto attendant. Refer to the articles on call queues and auto attendants linked at the bottom of this article before assigning a phone number to a resource account.

Note

This article applies to both Microsoft Teams and Skype for Business Online. For resource accounts homed on Skype for Business Server 2019, see Configure resource accounts.

Overview

If your Phone System service will need a service number, the various dependencies can be met in the following sequence:

  1. Obtain a service number.
  2. Create the resource account. An auto attendant or call queue is required to have an associated resource account.
  3. Obtain a Phone System or Phone System Virtual User license.
  4. Buy a Domestic or International Calling Plan.
  5. Assign the Phone System or a Phone System Virtual User license to the resource account.
  6. Assign a calling plan license to the resource account.
  7. Assign a Communications Credits license to the resource account.
  8. Set up Communication Credits and set up auto-recharge for your organization.
  9. Assign a service phone number to the resource account you just assigned licenses to.
  10. Create a Phone System service (a call queue or auto attendant).
  11. Link the resource account with a service.

If the auto attendant or call queue is nested under a top level auto attendant, the associated resource account only needs a phone number if you want multiple points of entry into the structure of auto attendants and call queues.

To redirect calls to people in your organization who are homed Online, they must have a Phone System license and be enabled for Enterprise Voice or have Office 365 Calling Plans. See Assign Microsoft Teams licenses. To enable them for Enterprise Voice, you can use Windows PowerShell. For example run: Set-CsUser -identity "Amos Marble" -EnterpriseVoiceEnabled $true

If the Phone system service you're creating will be nested and will not need a phone number, the process is:

  1. Create the resource account
  2. Create a Phone System service
  3. Associate the resource account with a Phone System service

Create a resource account with a phone number

Creating a resource account that uses a phone number would require performing the following tasks in the following order:

  1. Port or get a toll or toll-free service number. The number can't be assigned to any other voice services or resource accounts.

    Before you assign a phone number to a resource account, you will need to get or port your existing toll or toll-free service numbers. After you get the toll or toll-free service phone numbers, they will show up in Microsoft Teams admin center > Voice > Phone numbers, and the Number type listed will be listed as Service - Toll-Free. To get your service numbers, see Getting service phone numbers or if you want to transfer an existing service number, see Transfer phone numbers to Office 365.

    If you are assigning a phone number to a resource account you can now use the cost-free Phone System Virtual User license. This provides Phone System capabilities to phone numbers at the organizational level, and allows you to create auto attendant and call queue capabilities.

  2. Create a new resource account. See Create a resource account in Microsoft Teams admin center or Create a resource account in Powershell

  3. Obtain a Phone System or Phone System Virtual User license. From the Microsoft 365 admin center, go to Billing > Purchase services > Add-on subscriptions and scroll to the end - you will see "Phone System - Virtual User" license. Select Buy now.

  4. Buy a Domestic or International Calling Plan.

  5. Assign the Phone System license to the resource account. See Assign Microsoft Teams licenses and Assign licenses to one user.

  6. Assign a calling plan license to the resource account. See Assign Microsoft Teams licenses for more information.

  7. Assign the service number to the resource account. See Assign/Unassign phone numbers and services.

  8. Set up Communication Credits and set up auto-recharge for your organization. Assign a Communications Credits license to the resource account.

  9. Assign a service phone number to the resource account you just assigned licenses to.

  10. Set up one of the following:

  1. Link the resource account to the auto attendant or call queue. See Assign/Unassign phone numbers and services

Create a resource account without a phone number

Creating a resource account that does not need a phone number would require performing the following tasks in the following order:

  1. Create a new resource account. See Create a resource account in Microsoft Teams admin center or Create a resource account in Powershell
  2. Set up one of the following:
  3. Assign the resource account to the service. See Assign/Unassign phone numbers and services

Create a resource account in Microsoft Teams admin center

After you've bought a Phone System license, using Microsoft Teams admin center navigate to Org-wide settings > Resource accounts.

Screen shot of the Resource accounts page

Icon of the number 1, referencing a callout in the previous screenshot

To create a new resource account click + New account. In the pop-up, fill out the display name and user name for the resource account (the domain name should populate automatically) then click Save.

Screen shot of the New resource account options

Next, apply a license to the resource account in the O365 Admin center, as described in Assign licenses to users in Office 365 for business

Edit resource account name

Icon of the number 2, referencing a callout in the previous screenshot You can edit the resource account display name using the Edit option. Click Save when you are done. Screen shot of the Edit resource account option

Assign/Unassign phone numbers and services

Icon of the number 3, referencing a callout in the previous screenshot Once you've created the resource account and assigned the license, you can click on Assign/Unassign to assign a service number to the resource account, or assign the resource account to an auto attendant or call queue that already exists. Assigning a direct routing number can be done using Cmdlets only. If your call queue or auto attendant still needs to be created, you can link the resource account while you create it. Click Save when you are done.

To assign a direct routing or hybrid number to a resource account you will need to use PowerShell, see the following section.

Important

If your tenant doesn't have a Phone System license, an internal check will cause a failure when you try to assign the phone number to the resource account. You won't be able to assign the number or associate the resource account with a service.

Screen shot of the Assign/unassign options

Create a resource account in Powershell

Depending on whether your resource account is located online or on premises, you would need to connect to the appropriate Powershell prompt with Admin privileges.

The application ID's that you need to use while creating the application instances are:

  • Auto Attendant: ce933385-9390-45d1-9512-c8d228074e07
  • Call Queue: 11cd3e2e-fccb-42ad-ad00-878b93575e07

Note

If you want the call queue or auto attendant to be searchable by on-premise users, you should create your resource accounts on-premise, since online resource accounts are not synced down to Active Directory.

  1. To create a resource account online for use with an auto attendant, use the following command.
New-CsOnlineApplicationInstance -UserPrincipalName testra1@contoso.com -ApplicationId “ce933385-9390-45d1-9512-c8d228074e07” -DisplayName "Resource account 1"
  1. You will not be able to use the resource account until you apply a license to it. For how to apply a license to an account in the O365 admin center, see Assign licenses to users in Office 365 for business as well as Assign Skype for Business licenses.

  2. (Optional) Once the correct license is applied to the resource account you can set a phone number to the resource account as shown below. Not all resource accounts will require a phone number. If you did not apply a license to the resource account, the phone number assignment will fail.

Set-CsOnlineVoiceApplicationInstance -Identity testra1@contoso.com -TelephoneNumber +14255550100
Get-CsOnlineTelephoneNumber -TelephoneNumber +14255550100

See Set-CsOnlineVoiceApplicationInstance for more details on this command.

Note

It's easiest to set the online phone number using the Microsoft Teams admin center, as described previously.

To assign a direct routing or hybrid number to a resource account, use the following cmdlet:

Set-CsOnlineApplicationInstance -Identity appinstance01@contoso.com -OnpremPhoneNumber +14250000000

Manage Resource account settings in Microsoft Teams admin center

To manage Resource account settings in Microsoft Teams admin center, navigate to Org-wide settings > Resource accounts, select the resource account you need to change settings for, and then click on the Edit button. in the Edit resource account screen, you will be able to change these settings:

  • Display name for the account
  • Call queue or auto attendant that uses the account
  • Phone number assigned to the account

When finished, click on Save.

Delete a resource account

Make sure you dissociate the telephone number from the resource account before deleting it, to avoid getting your service number stuck in pending mode. You can do that using the following commandlet:

Set-csonlinevoiceapplicationinstance -identity <Resource Account oid> -TelephoneNumber $null

Once you do that, you can delete the resource account from the O365 admin portal, under Users tab.

Troubleshooting

In case you do not see the phone number assigned to the resource account on the Teams Admin Center and you are unable to assign the number from there, please check the following:

Get-MsolUser -UserPrincipalName "username@contoso.com"| fl objectID,department

If the department attribute displays Skype for Business Application Endpoint please run the cmdlet below :

Set-MsolUser -ObjectId  -Department "Microsoft Communication Application Instance"

Note

Refresh the Teams Admin center webpage after running the cmldet, and you should be able to assign the number correctly.

For implementations that are hybrid with Skype for Business Server:

Plan Cloud auto attendants

Configure Cloud auto attendants

For implementations in Teams or Skype for Business Online:

What are Cloud auto attendants?

Set up a Cloud auto attendant

Small business example - Set up an auto attendant

Create a Cloud call queue

New-CsHybridApplicationEndpoint

New-CsOnlineApplicationInstance