Page History

...

This application will set the following channel variable variables before completion:

• DIRECTORY_RESULT - Reason Directory application exited.
  • OPERATOR - User requested operator
  • ASSISTANT - User requested assistant
  • TIMEOUT - User allowed DTMF wait duration to pass without sending DTMF
  • HANGUP - The channel hung up before the application finished
  • SELECTED - User selected a user to call from the directory
  • USEREXIT - User exited with '#' during selection
  • FAILED - The application failed
• DIRECTORY_EXTEN - If the skip calling option is set this will be set to the selected extension provided one is selected.

Syntax

Directory([vm-context,[dial-context,[options]]])

...

• vm-context - This is the context within voicemail.conf to use for the Directory. If not specified and searchcontexts=no in voicemail.conf, then default will be assumed.
• dial-context - This is the dialplan context to use when looking for an extension that the user has selected, or when jumping to the o or a extension. If not specified, the current context will be used.
• options
  • e - In addition to the name, also read the extension number to the caller before presenting dialing options.
  • f( n ) - Allow the caller to enter the first name of a user in the directory instead of using the last name. If specified, the optional number argument will be used for the number of characters the user should enter.
    • n
  • l( n ) - Allow the caller to enter the last name of a user in the directory. This is the default. If specified, the optional number argument will be used for the number of characters the user should enter.
    • n
  • b( n ) - Allow the caller to enter either the first or the last name of a user in the directory. If specified, the optional number argument will be used for the number of characters the user should enter.
    • n
  • a - Allow the caller to additionally enter an alias for a user in the directory. This option must be specified in addition to the f, l, or b option.
  • m - Instead of reading each name sequentially and asking for confirmation, create a menu of up to 8 names.
  • n - Read digits even if the channel is not answered.
  • p( n ) - Pause for n milliseconds after the digits are typed. This is helpful for people with cellphones, who are not holding the receiver to their ear while entering DTMF.
    • n
  • c( filename ) - Load the specified config file instead of voicemail.conf
    • filename
  • s - Skip calling the extension, instead set it in the DIRECTORY_EXTEN channel variable.

    Info
    title Note
    Only one of the f, l, or b options may be specified. If more than one is specified, then Directory will act as if b was specified. The number of characters for the user to type defaults to 3.

See Also

Import Version

This documentation was imported from Asterisk Version GIT-20-70856e8200dc7d