System information
The Contexts Section
All the remaining sections in the voicemail.conf file will be the voicemail contexts, which
allow you to segregate groups of mailboxes.
In many cases, you will only need one voicemail context, commonly named
[default]. This is worth noting, as it will make things simpler in the dialplan: all the
voicemail-related applications assume the context default if no context is specified. In
other words, if you don’t require separation of your voicemail users, use default as
your one and only voicemail context.
The format for the mailboxes is as follows:
mailbox => password[,FirstName LastName[,email addr[,pager addr[,options[|options]]]]]
The pipe character (|) used to be more popular in Asterisk. For the first
few years, it was used as the standard delimiter. More recently, it has
almost completely been replaced by the comma; however, there are still
a few places where the pipe is used. One of them is in voicemail.conf:
for example, as a separator for any mailbox-specific options, and also
as the separator character in the format= declarative. You’ll see this in
our upcoming example, as well as in the voicemail.conf.sample file.
The parts of the mailbox definition are:
mailbox
This is the mailbox number. It usually corresponds with the extension number of
the associated set.
password
This is the numeric password that the mailbox owner will use to access her voice-
mail. If the user changes her password, the system will update this field in the
voicemail.conf file.
FirstName LastName
This is the name of the mailbox owner. The company directory uses the text in this
field to allow callers to spell usernames.
email address
This is the email address of the mailbox owner. Asterisk can send voicemail noti-
fications (including the voicemail message itself, as an attachment) to the specified
email box.
pager address
This is the email address of the mailbox owner’s pager or cell phone. Asterisk can
send a short voicemail notification message to the specified email address.
options
This field is a list of options for setting the mailbox owner’s time zone and over-
riding the global voicemail settings. There are nine valid options: attach,
Comedian Mail | 167