Voicemail.conf

Synopsis
The voicemail.conf file configures system wide parameters for the voicemail system, and stores mailbox information including mailbox number to passcode mapping, box owner names, and e-mail addresses for message received notification.

Arrangement
The voicemail.conf file is arranged in two sections.  The first section, general, contains system wide parameters such as the formats messages are to be stored in and the address e-mail from the voicemail system should appear to originate from. The second section, default, contains the configurations for individual voicemail boxes.

Keywords
The general section takes these keywords and options:

format: Format sets the file formats to write voicemails in.  If multiple formats are specified, all formats will be written, and the best available format will be used for playback. Available options are:

gsm  use raw gsm encoding.  Best for VoIP.
Wav  MS wav format, 16 bit linear
wav49  MS wav format, gsm encoded
g723sf    note that Asterisk cannot directly encode , due to licensing issues. It can, however, store and transmit  file received from an external source, i.e.  from a SIP phone with a built in codec.

Examples:

format=gsm|wav49|wav

In this example each received voicemail will be written in gsm, wav49, and wav formats.

format=gsm
This example will store voicemails in gsm format only.

serveremail: Serveremail sets the e-mail address that voicemail-waiting e-mails should appear to originate from. This value will be used in the 'From:' field of the e-mail.  Available options are any alphanumeric string, or any alphanumeric 

Examples:

serveremail=asterisk

In this example the 'From:' field will be set to 'asterisk'.  In most cases the outgoing mail server will append the local hostname.

 serveremail=

This example will set the e-mail to .  This will normally NOT be rewritten by the outgoing mail server.  This is useful if you want the e-mail to appear to come from a hostname other than the hostname of the local machine.

append: Append set whether to append the voicemail sound file as an attachment to the notification e-mail.  Takes an argument of yes or no.

Examples:

append=yes

append=no

The default section takes as a keyword the mailbox number.  The keyword takes as parameters the passcode, owner name, and owner e-mail address to send message waiting notification to. 

*Important Note: The owner name is used by the 'Directory' application to find extensions based on names provided by the caller.

Examples:

1234 => 4321,Ani DiFranco,

Complete File Example  - This is a complete example of a working voicemail.conf file.

[general]
format=gsm|wav
serveremail=
append=yes

[default]
1234 => 4321,Ani DiFranco,