What are Cloud auto attendants?

Phone System in Office 365 provides auto attendants, which can be used to let external and internal callers move through a menu system to locate and place or transfer calls to company users or departments in your organization.

An auto attendant is a series of voice prompts or audio files that callers hear instead of a human operator when they call an organization. When people call a number associated with an auto attendant, their choices can redirect the call to a user or locate someone in your organization and then connect to that user. They can express their choices and interact with the menu system by using a phone keypad (DTMF) or speech recognition.

To set up an auto attendant for the Phone System in Office 365, go to Set up a Cloud auto attendant.

A Cloud auto attendant has the following features:

  • It can provide corporate or informational greetings.
  • It can provide custom corporate menus. You can customize these menus to have more than one level.
  • It provides directory search that enables people who call in to search the organization's directory for a name.
  • It enables someone who calls in to reach or leave a message for a person in your organization.
  • It supports multiple languages for prompts, text-to-speech, and speech recognition.
  • It supports specifying holidays and business hours.
  • It supports transferring call to an operator, other users, call queues, and auto attendants.


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

Getting started

To get started using auto attendants, it's important to remember that:

  • An auto attendant is required to have an associated resource account. See Manage resource accounts in Teams for details on resource accounts.
  • 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.


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


To redirect calls to an operator or a menu option that is an Online user with a Phone System license, you will need to enable them for Enterprise Voice or assign Calling Plans to them. See Assign Microsoft Teams licenses. You can also use Windows PowerShell. For example run: Set-CsUser -identity "Amos Marble" -EnterpriseVoiceEnabled $true

  • To get and use toll-free service numbers for your auto attendants, you need to set up Communications Credits. To do this, see What are Communications Credits? and Set up Communications Credits for your organization.


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

  • A complete auto attendant system will usually involve multiple auto attendants and may only require a single assigned phone number for the top-level or entry auto attendant. Other auto attendants or call queues in the complete system will only need a phone number if you want to provide multiple points of entry into the system.

  • It is possible to apply more than one phone number to an auto attendant by associating more than one resource account to an auto attendant.

Feature overview

Dial by Name

Dial by Name is a feature of an auto attendant that is also known as directory search. It enables the people who call your auto attendant to use voice (speech recognition) or their phone keypad (DTMF) responses to enter a full or partial name to search company's directory, locate the person, and then have the call transferred to them. Users you wish to have located and reached using Dial by Name aren't required to have a phone number or have Calling Plans assigned to them, but they must have a Phone System license if they are online users, or EV enabled for onpremises users. Dial by Name will even be able to find and transfer calls to Microsoft Teams users who are hosted in different countries or regions for multi-national organizations.

Maximum directory size

There is no limit on the Active Directory size for which Dial by Name is supported when using the phone keypad to search for entering partial or full names (FirstName + LastName, and also LastName + FirstName). However, the maximum name list size that a single auto attendant can support using name recognition with speech is 80,000 users.

Input type Search format Maximum number of users in an organization
DTMF (keypad entry) Partial
FirstName + LastName
LastName + FirstName
No limit
Speech (voice input) FirstName
FirstName + LastName
LastName + FirstName
80,000 users


If you are using Dial by Name with speech recognition, but your organization's Active Directory is larger than 80,000 users and you haven't limited the scope of Dial by Name using Dial Scope feature, Dial by Name will still work for your callers using a phone keypad, and voice inputs will be available for all other scenarios. You can use the Dial Scope feature to narrow down the names that are reachable by changing the scope of Dial by Name for a particular auto attendant.

Dial by Name - Keypad (DTMF) entry

People calling in can use Dial by Name to reach users by specifying either the full or partial name of the person they are trying to reach. There are various formats that can be used when the name is entered.

When searching your organization's directory, people can use the '0' (zero) key to indicate a space between the first name and last or last name and first. When they are entering the name, they will be asked to terminate their keypad entry with the # key. For example, "After you enter the name of the person you are trying to reach, press #." If there are multiple names that are found, the person calling will be given a list of names to select from.

People can search for names in your organization using the following search formats on their phone keypad:

Name format Search type Example Search result
FirstName + LastName Full Amos0Marble# Amos Marble
LastName + FirstName Full Marble0Amos# Amos Marble
FirstName Full Amos# Press 1 for Amos Marble
Press 2 for Amos Marcus
LastName Full Marble# Press 1 for Amos Marble
Press 2 for Mary Marble
FirstName or LastName Partial Mar# Press 1 for Mary Marble
Press 2 for Mary Jones
Press 3 for Amos Marcus
FirsName + LastName Partial Mar0Amos# Press 1 for Amos Marble
Press 2 for Amos Marcus
LastName + FirstName Partial Mar0Am# Press 1 for Amos Marble
Press 2 for Amos Marcus

There are several special characters that are used when searching for people using a phone keypad. For example, the person will be asked to use the pound key (#), while the zero (0) key is used for a space between names. Pressing the star key (*) will repeat the list of matching names to the person.

Special phone keypad character What it means
# End character when entering a name.
0 Space between names.
* Repeat the list of matching names.

Dial by Name - Name recognition with speech

People can search for others in their organization using their voice (speech recognition). They can also reach anyone in the company's Active Directory by saying the name of the person they are trying to locate. Using voice inputs can recognize names in various formats, including FirstName, LastName, FirstName + LastName, or LastName + FirstName.

When you enable speech recognition for an auto attendant, phone keypad entry (DTMF) won't be disabled, so both types of input can be used. Phone keypad entry can't be disabled and can be used at any time, even if speech recognition is enabled on the auto attendant.

As with phone keypad entry, if multiple names are found, the person calling will be presented with a list of names to select from.

People calling in can say names in the following formats:

Name with speech Search type Example Search result
FirstName + LastName Full Amos Marble Amos Marble
LastName + FirstName Full Marble Amos Amos Marble
FirstName Full Amos Press or say 1 for Amos Marble
Press or say 2 for Amos Jones
LastName Full Marble Press or say 1 for Amos Marble
Press or say 2 for Ben Marble


It might take up to 36 hours for a new user to have their name listed in the directory for Dial by Name with speech recognition due to Active Directory replication lag.

Language support

The following languages are available for text-to-speech:

Arabic (EG) English (NZ) Korean (KO)
Chinese (HK) English (UK) Norwegian (NO)
Chinese (TW) English (US) Polish (PL)
Chinese (ZH) Finnish (FI) Portuguese (BR)
Danish (DA) French (CA) Portuguese (PT)
Dutch (NL) French (FR) Russian (RU)
English (AU) German (DE) Spanish (ES)
English (CA) Italian (IT) Spanish (MX)
English (IN) Japanese (JP) Swedish (SV)

Speech recognition for auto attendants is available in the following languages:

Chinese (ZH) French (FR)
English (AU) German (DE)
English (CA) Italian (IT)
English (IN) Japanese (JP)
English (UK) Portuguese (BR)
English (US) Spanish (ES)
French (CA) Spanish (MX)

The following voice commands are available in the fourteen (14) languages supported for speech recognition:

Voice command Corresponds to
Yes Yes - corresponds to pressing 1 for Yes.
No No - corresponds to pressing 2 for No.
Repeat Repeats the list of options - corresponds to pressing * to repeat the list of options.
Operator Breakout to operator - corresponds to pressing 0 for "Operator".
Main Menu Brings the caller to the main menu of the auto attendant.
Zero Corresponds to pressing 0 (by default, same as "Operator").
One Corresponds to pressing 1.
Two Corresponds to pressing 2.
Three Corresponds to pressing 3.
Four Corresponds to pressing 4.
Five Corresponds to pressing 5.
Six Corresponds to pressing 6.
Seven Corresponds to pressing 7.
Eight Corresponds to pressing 8.
Nine Corresponds to pressing 9.

Using the operator option

Using the operator for an auto attendant is an optional setting that provides the caller with an option to speak to a human operator.

Key 0 and the voice command "Operator" direct the call to the designated operator by default. This is the case for all languages supported for speech recognition. You can also use Menu Options to set a custom value for the Operator.

The operator can be set to:

  • A Microsoft Teams user or a Skype for Business on premise user that is Enterprise Voice-enabled.

  • Another auto attendant that's set up for your organization.

  • Any existing call queue that's set up in your organization. To see more about call queues, see Create a Cloud call queue.

Business hours and call handling

Business hours are set on each auto attendant. If business hours aren't set, all days and all hours in the day are considered business hours because a 24/7 schedule is set by default. Business hours can be set with breaks in time during the day, and all of the hours that are not set as business hours are considered after-hours. You can set different incoming call-handling options and different greetings (which are optional), and Both can be set for business hours and after-hours.

Each auto attendant has call-handling options that can be set:

  • You can have the call just disconnect after greeting.
  • You can also:
    • Redirect the call to a Microsoft Teams user who has a Phone System license that is Enterprise Voice-enabled or has Calling Plans assigned to them. 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's calls to be automatically forwarded directly to voicemail.

    • Redirect the call to a call queue. To see more about call queues, see Create a Cloud call queue.

    • Redirect the call to another auto attendant that you have set up.

    • Create menu options and play a menu prompt for the person calling. For example: "Press 1 for Sales, Press 2 for Services. To speak to the operator, press 0 at any time."

Cloud auto attendants allow you to create menu prompts ("Press 1 for Sales, Press 2 for Services") and set up menu options to route calls based on what the user selects. Setting up menu options for an auto attendant enables an organization to provide interactive guidance to get the person to their destination faster, without relying on a human operator to handle the incoming calls. Menu prompts can be created by using text-to-speech (system-generated prompts) or by uploading an audio file that has been recorded. Speech recognition uses voice commands for hands-free navigation, but people calling in can also use the phone keypad to navigate menus.

Keys 0 through 9 can be assigned to Menu Options in an auto attendant using the Skype for Business admin center. Different sets of menu options can be created for business hours and after hours, and you can enable or disable Dial by Name in the Menu Options. Keys can be mapped to transfer the calls to:

  • An operator, which is mapped to key 0 by default. However, it can be re-assigned to any other key, or removed from the menu.
  • A call queue.
  • Another auto attendant. Multi-level menus can be set up by pointing a Menu Option in one auto attendant to another auto attendant with its own set of Menu Options, which is called a "nested" auto attendant.
  • A Microsoft Teams user who has a Phone System license that is Enterprise Voice-enabled or has Calling Plans assigned to them. 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's calls to be automatically forwarded directly to voicemail.

The name of every menu option becomes a speech-recognition keyword if speech recognition has been enabled. For example, callers can say "One" to select the menu option mapped to key 1, or they can simply say "Sales" to select the same menu option named "Sales."

To set up an auto attendant and the menu options, go Set up a Cloud auto attendant.

Assigning phone numbers for an auto attendant

You can assign a Microsoft service number, a direct routing number, or a hybrid number to your auto attendant. See Plan Direct Routing for details.

To assign a service number, you will need to get or port your existing toll or toll-free service numbers. Once you get the toll or toll-free service phone numbers, they will show up in the Skype for Business 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 for Skype for Business and Microsoft Teams or, if you want to transfer and existing service number, see Transfer phone numbers to Office 365.


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

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

Getting service phone numbers for Skype for Business and Microsoft Teams

Country and region availability for Audio Conferencing and Calling Plans

Small business example - Set up an auto attendant