Create a Cloud call queue

Cloud call queues can provide:

  • A greeting message.
  • Music while people are waiting on hold.
  • Redirecting calls to call agents in mail-enabled distribution lists and security groups.
  • Setting different parameters such as queue maximum size, timeout, and call handling options.

You would associate a phone number to a call queue using a resource account. A call queue can be dialed directly or accessed by a selection on an auto attendant.

The caller hears music while they are on hold, and the call connects to the call agents in First In, First Out (FIFO) order.

All calls in the queue are sent to agents by one of the following methods:

  • With attendant routing, the first call in the queue rings all agents at the same time.

  • With serial routing, the first call in the queue rings all call agents one by one.

  • With round robin, routing of incoming calls is balanced so that each call agent gets the same number of calls from the queue.

    Note

    Call agents who are Offline, have set their presence to Do not Disturb, or have opted out of the call queue will not recieve calls.

  • Only one incoming call notification (for the call at the head of the queue) at a time goes to the call agents.

  • After a call agent accepts the call, the next incoming call in the queue will start ringing call agents.

Note

This article applies to both Microsoft Teams and Skype for Business Online.

Step 1 — Get started

To get started using call queues, it's important to remember a few things:

  • A call queue is required to have an associated resource account. See Manage resource accounts in Teams for details on resource accounts.
  • When you assign a phone number to a resource account, you can now use the cost-free Phone System Virtual User license. Phone System allows phone numbers at the organizational level for use with low-cost auto attendant and call queue services.

Note

Direct Routing service numbers for call queues are supported for Microsoft Teams users and agents only.

Note

To redirect calls to people in your organization who are Online, they must have a Phone System license and be enabled for Enterprise Voice or have Office 365 Calling Plans. See Assign Skype for Business licenses or 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

  • To learn more about Office 365 Calling Plans, see Phone System and Calling Plans and Calling Plans for Office 365.

  • You can only assign Cloud call queues toll and toll-free service phone numbers that you got in the Microsoft Teams admin center or transferred from another service provider. Communications Credits are required for toll-free service numbers.

    Note

    User (subscriber) phone numbers can't be assigned to call queues - only service toll or toll-free phone numbers can be used.

  • The following clients are supported for call agents associated to a Cloud 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 6.16.0.9 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 iPhone app

    • Microsoft Teams Android app

      Note

      Call queues that are assigned a direct routing number will not support Skype for Business clients, Lync clients, or Skype for Business IP Phones as agents.

Step 2 — Getting or transferring toll or toll-free service phone numbers

Before you can create and set up your call queues, you need to get or transfer 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 > Legacy Portal > Voice > Phone numbers, and the Number type 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.

Note

If you are outside the United States, you can't use the Microsoft Teams admin center to get service numbers. Go to Manage phone numbers for your organization instead to see how to do it from the outside of the United States.

When setting up multiple auto attendants you may only assign a phone number to the main auto attendant's resource account, which can direct callers to your call queues or nested auto attendants. In those situations, you create all auto attendants and call queues in your system without assigning dialpad options, and then edit the settings later. This is necessary because you aren't allowed to create an option linking to a call queue or auto attendant that does not yet exist.

Step 3 — Create a new call queue

We are frequently updating how you can manage features, so the steps here might be a little different from what you see.

Important

Every call queue is required to have an associated resource account. You must create the resource account first, then you can associate it to the call queue.

Using the Microsoft Teams admin center

In the Microsoft Teams admin center, Voice > Call queues, then click + Add new:

Set the call queue display name and resource account

Screenshot of a new call queue, with numbered callouts


Icon of the number 1, referencing a callout in the previous screenshot Name Enter a descriptive display name for the call queue. This name is required and can contain up to 64 characters, including spaces.

This name is displayed in the notification for the incoming call.


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

Add Accounts Select a resource account. The resource account may or may not be associated with a service toll or toll-free phone number for the call queue, but each call queue requires an associated resource account.

If there aren't any listed, you need to get service numbers and assign them to a Resource account before you can create this call queue, as described earlier. To get your service numbers, see Getting service phone numbers. You create a resource account as described in Manage resource accounts in Teams if you want your call queue to have an associated phone number.

Note

If you want or need to assign a Domain you would do so by assigning it to the resource account for the call queue.

Set the greeting and music played while on hold

screenshot of greeting and music options, with numbered callouts


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

Greeting is optional. This is the greeting that is played for people who call in to the call queue number.

You can upload an audio file (.wav, .mp3, or .wma formats).

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

Music on hold You can either use the default Music on Hold provided with the call queue, or you can upload an audio file in .wav, mp3, or .wma formats to use as your custom Music on Hold.


Select the call answering options

Screenshot of call answering options, with numbered callouts

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

You can select up to 200 call agents who belong to any of the following mailing lists or groups:

  • Office 365 group
  • Security group
  • Distribution list

Call agents selected must be one of the following:

To enable an agent for Enterprise Voice, you can use Windows PowerShell. For example, run: Set-CsUser -identity "Amos Marble" -EnterpriseVoiceEnabled $true

  • Users with a Phone System license or a Calling Plan that are added to either an Office 365 Group; a mail-enabled Distribution List; or a Security Group. It might take up to three hours for a newly added agent in a distribution list, or a security group, to start receiving calls from a call queue. A newly created distribution list or security group might take up to 48 hours to become available to be used with call queues. Newly created Office 365 Groups are available almost immediately.

  • If your agents are using Microsoft Teams App to take call queue calls, they need to be in TeamsOnly mode.

Screenshot of Add call agents pane

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

Routing method You can choose either Attendant, Serial, or Round Robin for your call queue distribution method. All new and existing call queues will have attendant routing selected by default. When attendant routing is used, the first call in the queue rings all call agents at the same time. The first call agent to pick up the call gets the call.

  • Attendant routing causes the first call in the queue to ring all call agents at the same time. The first call agent to pick up the call gets the call.
  • Serial routing incoming calls ring call agents one by one, starting from the beginning of the call agent list. Agents cannot be ordered within the call agent list. If an agent dismisses or does not pick up a call, the call will ring the next agent on the list and will try all agents one by one until it is picked up or times out waiting in the queue.

    Note

    Serial routing will skip agents who are Offline, have set their presence to Do not Disturb, or have opted out of getting calls from this queue.

  • Round robin balances 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.

Select an agent opt-out option

Screenshot of agent opt-out options, with numbered callouts


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

Agent can opt out of getting calls You can choose to allow call queue agents to opt-out of taking calls from a particular queue by enabling this option.

Enabling this option allows all agents in this queue to start or stop receiving calls from this call queue at will. You can revoke the agent opt-out privilege at any time by clearing the check box, causing agents to become automatically opted in for this queue again (the default setting for all agents).

To access the opt-out option, agents can do the following:

  1. Open Options in their desktop Skype for Business client.

  2. On the Call Forwarding tab, click the Edit settings online link.

  3. On the user settings page, click Call Queues, and then clear the check boxes for any queues for which they want to opt-out.

    Note

    Agents using apps or endpoints other than Skype for Business Desktop can access the opt-out option from the user settings portal https://aka.ms/cqsettings.

Icon of the number 2, referencing a callout in the previous screenshot Agent Alert setting

This defines the duration of an agent being notified of a call before the Serial or Round Robin routing methods move to the next agent.

The default setting is 30 seconds, but it can be set for up to 3 minutes.


Set the call overflow and timeout handling options

Screenshot of overflow handling options, with numbered callouts


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

Maximum calls in the queue Use this to set the maximum calls that can wait in the queue at the same time. The default is 50, but it can range from 0 to 200. When this limit is reached, the call is handled in the way you set on the When the maximum number of calls is reached setting below.


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

When the maximum number of calls is reached When the call queue reaches its maximum size (set using the Maximum calls in the queue setting), you can choose what happens to new incoming calls.

  • Disconnect The call is disconnected.

  • Redirect to When you choose this, select one of the following:

    • Person in your company An Online user with a Phone System license and be enabled for Enterprise Voice or have a Calling Plan. You can set it up so the caller can be sent to voicemail. To do this, select a Person in your company and set this person to have their calls forwarded directly to voicemail.

    To learn about licenses required for voicemail, see Set up Cloud Voicemail.

    • Voice application Select the name of a resource account associated to either a call queue or auto attendant that has already been created.

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

Call Timeout: maximum wait time You can also decide how much time a call can be on hold in the queue before it times out and needs to be redirected or disconnected. Where it is redirected is based on how you set the When a call times out setting. You can set a time from 0 to 45 minutes.

The timeout value can be set in seconds, at 15-second intervals. This allows you to manipulate the call flow with finer granularity. For example, you could specify that any calls that are not answered by an agent within 30 seconds go to a Directory Search auto attendant.

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

When call times out When the call reaches the limit you set on the How long a call can wait in the queue setting, you can choose what happens to this call:

  • Disconnect The call is disconnected.

  • Redirect this call to When you choose this, you have these options:

    • Person in your company An Online user with a Phone System license and be enabled for Enterprise Voice or have Calling Plans. You can set it up so the person calling in can be sent to voicemail. To do this, select a Person in your company and set this person to have their calls forwarded directly to voicemail.

    To learn about licensing required for voicemail, see Set up Cloud Voicemail.

    • Voice application Select the name of a resource account associated with either a call queue or auto attendant that has already been created.

Change a user's Caller ID for outbound calls

You can protect a user's identity by changing their caller ID for outbound calls to a call queue, auto attendant, or any service number instead using the New-CsCallingLineIdentity cmdlet.

To do this, run:

New-CsCallingLineIdentity -Identity "UKSalesQueue" -CallingIdSubstitute "Service" -ServiceNumber 14258828080 -EnableUserOverride $False -Verbose

Then apply the policy to the user using the Grant-CallingLineIdentity cmdlet. To do this, run:

Grant-CsCallingLineIdentity -PolicyName UKSalesQueue -Identity "AmosMarble@contoso.com"

You can get more information on how to set caller ID settings in your organization in the article How can caller ID be used in your organization.

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.

More about Windows PowerShell

Here's what you get with Phone System in Office 365

Getting service phone numbers

Country and region availability for Audio Conferencing and Calling Plans

New-CsOnlineApplicationInstance