Directory()

`Directory()`
	Appendix B. Applications in the dialplan

Directory()

Appendix B. Applications in the dialplan

`Directory()`

Provides a directory of users or user voicemail box numbers (for more on system directories and Dial-by-Name, see the section called “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)


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 s earch by name. The list of names and corresponding extensions is retrieved fro m the voicemail configuration file, voicemail.conf. This application will immediately exit if one of the following DTMF di gits 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 direct ory 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.

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 s
earch
by name. The list of names and corresponding extensions is retrieved fro
m the
voicemail configuration file, voicemail.conf.
  This application will immediately exit if one of the following DTMF di
gits 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 direct
ory
        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


`Dictate()`	\|	`DISA()`

Directory()

WARNING: ALPHA-VERSION!

`Directory()`