Page 516 - Asterisk™: The Future of Telephony

Defining Voicemail Contexts and Mailboxes
Now that the system-wide settings and voicemail zones have been set, you can define
your voicemail contexts and individual mailboxes.
Voicemail contexts are used to separate out different groups of voicemail users. For
example, if you are using Asterisk to host voicemail for more than one company, you
should place each company’s mailboxes in different voicemail contexts, to keep them
separate. You might also use voicemail contexts to create per-department dial-by-name
directories.
To define a new voicemail context, simply put the context name inside of square
brackets, like this:
[default]
Inside a voicemail context, each mailbox definition takes the following syntax:
mailbox=password,name[,email[,pager_email[,options]]]
The mailbox argument is the mailbox number.
The password argument is the numeric code the mailbox owner must enter to access
his voicemail. If the password is preceded by a minus sign (-), the password may not
be changed by the mailbox owner.

If the password is set to d, then this line is assumed to provide an alter-
nate name that can be used for this mailbox in the dial-by-name
directory. In the following example, people can reach extension 123 by
searching for either Robert or Bob, along with a popular misspelling of
his last name:
123 => 4444,Robert Schauerhamer
123 => d,Bob Schauerhamer
123 => d,Robert Showerhammer

The email and pager_email arguments are email addresses where voicemail notifica-
tions will be sent. These may be left blank if you don’t want to send voicemail
notifications via email. The message sent to the pager_email address is usually shorter
and suitable for sending to a cell phone (via an email to SMS gateway) or to an alpha-
numeric pager.
The options argument is a pipe-separated list of voicemail options that may be specified
for the mailbox. (These options may also be set globally by placing them in the
[general] section.) Valid voicemail options include:

tz
Sets the voicemail zone from the [zonemessages] section earlier. This option is
irrelevant if envelope is set to no.

488 | Appendix D: Configuration Files