B.29. Directory()

Provides a directory of users or user voicemail box numbers (for more on system directories and Dial-by-Name, see Section 4.5, “Directory (Dial-by-Name)”).
Directory(voicemail-context[,dialplan-context[,options]])
Lets callers search a directory by the user's name. The list of names and extensions is configured in voicemail.conf. The voicemail-context parameter is required.
The dialplan-context defines the context to be used when dialing the user's extension. If this is not provided, voicemail-context is assumed. The only option currently accepted is f, which allows dialing by first name.
If the user dials "0" (zero) and the extension o exists in the current context, the call goes to this extension. Likewise, pressing "*" sends the call to the extension a, if it exists. This behavior is similar to that found in Voicemail().
Returns 0 unless the caller hangs up.
exten => *,1,Directory(default,incoming)
exten => #,1,Directory(default,incoming,f)

Note

Internal help for this application in Asterisk 1.4:
  -= Info about application 'Directory' =- 

[Synopsis]
Provide directory of voicemail extensions

[Description]
  Directory(vm-context[|dial-context[|options]]): This application will present
the calling channel with a directory of extensions from which they can search
by name. The list of names and corresponding extensions is retrieved from the
voicemail configuration file, voicemail.conf.
  This application will immediately exit if one of the following DTMF digits are
received and the extension to jump to exists:
    0 - Jump to the 'o' extension, if it exists.
    * - Jump to the 'a' extension, if it exists.

  Parameters:
    vm-context   - This is the context within voicemail.conf to use for the
                   Directory.
    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.

  Options:
    e - In addition to the name, also read the extension number to the
        caller before presenting dialing options.
    f - Allow the caller to enter the first name of a user in the directory
        instead of using the last name.
diff output to internal help in Asterisk 1.2:
25,26d24
<     e - In addition to the name, also read the extension number to the
<         caller before presenting dialing options.
See also
voicemail.conf