Create a call queue
Call queues provide a method of routing callers to people in your organization who can help with a particular issue or question. Calls are distributed one at a time to the people in the queue (who are known as agents).
Call queues provide:
A greeting message.
Music while people are waiting on hold in a queue.
Call routing - in First In, First Out (FIFO) order - to agents.
Handling options for queue overflow and timeout.
To set up a call queue, in the Teams admin center, expand Voice, click Call queues, and then click Add.
This video shows a basic example of how to create a call queue in Teams.
Resource account and language
Type a name for the call queue.
Click Add accounts, search for the resource account that you want to use with this call queue, click Add, and then click Add. (Agents will see the resource account name when they receive an incoming call.)
Choose a supported language. This language will be used for system-generated voice prompts and voicemail transcription (if you enable them).
Greetings and music on hold in queue
Specify if you want to play a greeting to callers when they arrive in the queue. You must upload an MP3, WAV, or WMA file containing the greeting that you want to play.
Teams provides default music to callers while they are on hold in a queue. If you want to play a specific audio file, choose Play an audio file and upload an MP3, WAV, or WMA file.
The uploaded recording can be no larger than 5 MB. The default music supplied in Teams call queues is free of any royalties payable by your organization.
Review the prerequisites for adding agents to a call queue.
You can add up to 200 agents via a Teams channel.
If you want to use a Teams channel to manage the queue, select the Choose a team option and click Add a channel. Search for the team that you want to use, select it, and click Add. Select the channel that you want to use and click Apply.
The following clients are supported when using a Teams channel for call queues:
- Microsoft Teams Windows client
- Microsoft Teams Mac client
Users and groups
You can add up to 20 agents individually and up to 200 agents via groups.
If you want to add individual users or groups to the queue, select the Choose users and groups option.
To add a user to the queue, click Add users, search for the user, click Add, and then click Add.
To add a group to the queue, click Add groups, search for the group, click Add, and then click Add. You can use distribution lists, security groups, and Microsoft 365 groups or Microsoft Teams teams.
New users added to a group can take up to eight hours for their first call to arrive.
Conference mode significantly reduces the amount of time it takes for a caller to be connected to an agent, after the agent accepts the call. For conference mode to work, agents in the call queue must use one of the following clients:
- The latest version of the Microsoft Teams desktop client, Android app, or iOS app
- Microsoft Teams phone version 1449/220.127.116.110051601 or later
Agents' Teams accounts need to be set to Teams-only mode. Agents who don't meet the requirements aren't included in the call routing list. We recommend enabling conference mode for your call queues if your agents are all using compatible clients.
Conference mode is not supported if phone calls are routed to the queue from a Direct Routing gateway that is enabled for Location Based Routing.
Routing method determines the order in which agents receive calls from the queue. Choose from these options:
Attendant routing rings all agents in the queue at the same time. The first call agent to pick up the call gets the call.
Serial routing rings all call agents one by one in the order specified in the Call agents list. If an agent dismisses or does not pick up a call, the call will ring the next agent and will try all agents until it is picked up or times out.
Round robin balances the routing of incoming calls so that each call agent gets the same number of calls from the queue. This may be desirable in an inbound sales environment to assure equal opportunity among all the call agents.
Longest idle routes each call to the agent who has been idle the longest time. An agent is considered idle if their presence state is Available or if their presence state has been Away for less than 10 minutes. Agents whose presence state has been Away for more than 10 minutes are not considered idle and will not be eligible to receive calls until they change their presence to Available.
Presence-based routing uses the availability status of call agents to determine whether an agent should be included in the call routing list for the selected routing method. Call agents whose availability status is set to Available are included in the call routing list and can receive calls. Agents whose availability status is set to any other status are excluded from the call routing list and won't receive calls until their availability status changes back to Available.
You can enable presence-based call routing with any of the routing methods.
If an agent opts out of getting calls, they won't be included in the call routing list regardless of what their availability status is set to.
Agents who use the Skype for Business client aren't included in the call routing list when presence-based routing is enabled. If you have agents who use Skype for Business, don't enable presence-based call routing.
Agent alert time specifies how long an agent's phone will ring before the queue redirects the call to the next agent.
The following settings are recommended:
- Conference mode to Auto
- Routing method to Round robin or Longest idle
- Presence-based routing to On
- Agent alert time: to 20 seconds
If presence-based routing is not enabled and there are multiple calls in the queue, the system will present these calls simultaneously to the agents regardless of their presence status. This will result in multiple call notifications to agents, particularly if some agents don’t answer the initial call presented to them.
Call overflow handling
Maximum calls in the queue specifies the maximum number of calls that can wait in the queue at any given time. The default is 50, but it can range from 0 to 200. When this limit is reached, the call is handled as specified by the When the maximum number of calls is reached setting.
You can choose to disconnect the call or redirect it to any of the call routing destinations. For example, you might have the caller leave a voicemail for the agents in the queue. For external transfers, please refer to Prerequisites and the external phone number transfers - technical details for number formatting.
If the maximum number of calls is set to 0 then the greeting message will not play.
Call timeout handling
Call Timeout: maximum wait time specifies the maximum time a call can be on hold in the queue before it is redirected or disconnected. You can specify a value from 0 seconds to 45 minutes.
You can choose to disconnect the call or redirect it to one of the call routing destinations. For example, you might have the caller leave a voicemail for the agents in the queue. For external transfers, please refer to Prerequisites and the external phone number transfers - technical details for number formatting.
When you have selected your call timeout options, click Save.
Caller ID for outbound calls
Since agents in a call queue may dial out to return a customer call, consider setting the caller ID for members of a call queue to the service number of an appropriate auto attendant. See Manage caller ID policies in Microsoft Teams for more information.
The following clients are supported for call agents in a call queue:
Skype for Business desktop client 2016 (32-bit and 64-bit versions)
Lync desktop client 2013 (32-bit and 64-bit versions)
All IP phone models supported for Microsoft Teams. See Getting phones for Skype for Business Online.
Mac Skype for Business Client (version 16.8.196 and later)
Android Skype for Business Client (version 18.104.22.168 and later)
iPhone Skype for Business Client (version 6.16.0 and later)
iPad Skype for Business Client (version 6.16.0 and later)
Microsoft Teams Windows client (32-bit and 64-bit versions)
Microsoft Teams Mac client
Microsoft Teams on Virtualized Desktop Infrastructure (Windows Virtual Desktop, Citrix, and VMware)
Microsoft Teams iPhone app
Microsoft Teams Android app
Call queues that are assigned a direct routing number don't support Skype for Business clients, Lync clients, or Skype for Business IP Phones as agents.
Call queue cmdlets
You can also use Windows PowerShell to create and set up call queues. Here are the cmdlets that you use to manage a call queue.