Setup - Call Priorities for Call Queues

  • Applies to: Microsoft Teams

This article is for IT pros and Teams administrators who want to use Call Priority to prioritize calls within a call queue.

Planning and licensing review

Planning

Licensing

Known issues

None.

What's new for Call Priorities in the past six months

Nothing new in the last six months.

How is priority assigned and honored

Priority is assigned to a call in the following situations:

  • Teams Phone Agents and Auto attendants can set the priority of a call when transferring to a Call queue.
  • Resource accounts assigned to a Call queue can have a priority set.

When a call arrives at a call queue that already has a priority set, the call queue honors the setting. When a call arrives on a call queue that doesn't have a priority set, the call queue uses the priority assigned to the resource account the call arrived on.

The default priority for all calls is 3.

Configure call priorities

Call priorities can currently only be configured using PowerShell.

Scenario 1: Priority to callers based on dialed number

In this scenario, Contoso Support has a single Technical Support call queue that's open 24/7. Contoso's website and documentation provides their customers with the general number for all support requests. However, customers who sign up for "enhanced support" are given a dedicated number to call. The enhanced support customers are given priority over other customers based on the level of enhanced support purchased (or not purchased).

Constoso Support defines the following call priorities for their resource accounts:

  • Priority 4 - Any customer calling the general support phone number.
  • Priority 3 - Customers call the Bronze level support phone number.
  • Priority 2 - Customers calling the Silver level support phone number.
  • Priority 1 - Customers calling the Gold level support phone number.

Customers in the call queue are presented to agents in the order of their priority. The Gold level customers are all presented first, followed by Silver, Bronze, and finally General support customers.

Screenshot showing the call flow for Scenario 1.

The following command uses the New-CsOnlineApplicationInstanceAssociation cmdlet with the -CallPriority parameter to set the call priority for a call queue based on the dialed number (Gold, Silver, Bronze, General):

Expand to see the PowerShell example 
# Assign resource accounts to call queue
$callQueueID = (Get-CsCallQueue -NameFilter "Support").Identity
$goldID = (Get-CsOnlineUser -Identity contoso-support-gold@contoso.com).Identity
$silverID = (Get-CsOnlineUser -Identity contoso-support-silver@contoso.com).Identity
$bronzeID = (Get-CsOnlineUser -Identity contoso-support-bronze@contoso.com).Identity
$generalID = (Get-CsOnlineUser -Identity contoso-support-general@contoso.com).Identity

New-CsOnlineApplicationInstanceAssociation -Identities @($goldID) -ConfigurationID $callQueueID -ConfigurationType CallQueue -CallPriority 1
New-CsOnlineApplicationInstanceAssociation -Identities @($silverID) -ConfigurationID $callQueueID -ConfigurationType CallQueue -CallPriority 2
New-CsOnlineApplicationInstanceAssociation -Identities @($bronzeID) -ConfigurationID $callQueueID -ConfigurationType CallQueue -CallPriority 3
New-CsOnlineApplicationInstanceAssociation -Identities @($generalID) -ConfigurationID $callQueueID -ConfigurationType CallQueue -CallPriority 4

Scenario 2: Priority to callers based on Auto attendant menu choices

In this scenario, Contoso Travel has a single Travel Support call queue for all travel inquiries. This call queue is associated with an auto attendant that provides callers with the following options:

Thank you for calling Contoso Travel. If you are currently traveling and need immediate assistance, press 1. If you are calling to inquire about an existing booking, press 2. To make a new booking, press 3. For all other inquiries, press 4.

Callers who press 1 get top priority and connect to agents first, followed by callers who press 2, 3, and 4 in decreasing order of priority.

Screenshot showing the call flow for Scenario 2.

The following command uses the New-CsAutoAttendantCallableEntity cmdlet with the -CallPriority parameter to set the call priority for a call queue based on the Auto attendant menu choices (immediate assistance, existing booking, new booking, other inquiries):

Expand to see the PowerShell example 
# Create the Auto Attendant
$callQueueID = (Get-CsCallQueue -NameFilter "Travel").Identity
$callableEntity1 = New-CsAutoAttendantCallableEntity -Identity $callQueueID -Type ConfigurationEndpoint -CallPriority 1
$callableEntity2 = New-CsAutoAttendantCallableEntity -Identity $callQueueID -Type ConfigurationEndpoint -CallPriority 2
$callableEntity3 = New-CsAutoAttendantCallableEntity -Identity $callQueueID -Type ConfigurationEndpoint -CallPriority 3
$callableEntity4 = New-CsAutoAttendantCallableEntity -Identity $callQueueID -Type ConfigurationEndpoint -CallPriority 4

$greetingPrompt = New-CsAutoAttendantPrompt -TextToSpeechPrompt "Thank you for calling Contoso Travel"
$menuPrompt = New-CsAutoAttendantPrompt -TextToSpeechPrompt "If you are currently traveling and require immediate assistance, press 1. If you are calling to inquire about an existing booking, press 2. To make a new booking, press 3. For all other inquiries press 4."

$menuOption1 = New-CsAutoAttendantMenuOption -Action TransferCallToTarget -DtmfResponse Tone1 -CallTarget $callableEntity1
$menuOption2 = New-CsAutoAttendantMenuOption -Action TransferCallToTarget -DtmfResponse Tone2 -CallTarget $callableEntity2
$menuOption3 = New-CsAutoAttendantMenuOption -Action TransferCallToTarget -DtmfResponse Tone3 -CallTarget $callableEntity3
$menuOption4 = New-CsAutoAttendantMenuOption -Action TransferCallToTarget -DtmfResponse Tone4 -CallTarget $callableEntity4

$defaultMenu = New-CsAutoAttendantMenu -Name "Default menu" -Prompts @($menuPrompt) -MenuOptions @($menuOption1, $menuOption2, $menuOption3, $menuOption4)
$defaultCallFlow = New-CsAutoAttendantCallFlow -Name "Default call flow" -Greetings @($greetingPrompt) -Menu $defaultMenu
New-CsAutoAttendant -Name "Contoso Travel" -LanguageId en-US -TimeZoneId "Eastern Standard Time" -DefaultCallFlow $defaultCallFlow

Scenario 3: Priority to agents transferring calls to another call queue

In this scenario, Contoso Finance Customer Service agents triage calls and they often transfer these calls to Tier 2 Support groups. Tier 2 Support groups can also take calls directly from customers. Constoso wants calls transfers from Customer Service to have higher priority than calls that are directly dialed into Tier 2 Support, as these callers already waited and spoken with a representative.

Screenshot showing the call flow for Scenario 3.

Considerations

Keep in mind the following considerations when configuring call priorities:

  • Agents always receive calls with the highest priority first, regardless of how long lower priority calls have been waiting.
  • Call priorities aren't supported for Authorized users.
  • Keep the highest and lowest call priorities available for future use.
  • Agents don't receive notifications about which calls are what priority. The priority is only used to determine the order in which calls are presented to agents.
  • Last updated on