Voicemail

Voicemail can be configured by configuring three files:

• Configure voicemail.conf• Call the mailbox configured in voicemail.conf from

extensions.conf• Define the mailbox for the user in sip/iax/zapata.conf

voicemail.conf

Voicemail.conf contains one general section, one zonemessages section and one or more user-defined sections. Its layout is:

[general]Setting=value

[zonemessages]Newzonename=country/city|options

[context_section]User-defined contexts here

voicemail.conf

The general section holds global configurations

The zonemessages section defines the time-zone and time-reporting formats

The user-defined context contains the mailbox’s definition

[general] Section

Externnotify Supplies the full path and filename of an external program to be executed when a voicemail is left or delivered, or when a mailbox is checked

Externpass The path of the external program to be executed after voicemail’s password is changed

Silencethreshold When using the maxsilence setting, eliminate background noise by adjusting the silence detection’s threshold

Servermail Source e-mail addressMaxmsg Limits the number of messages in the voicemail

folderMinmessage Eliminate a message shorter than the time in seconds

specified. The default is zero, which indicates no minimum time

Format The voice messages’ format i.e. wav49, GSM and wavMaxgreetLimits a user’s recordable voicemail greetingSkipms Interval, in milliseconds, to use to skip forward or

reverse while playing voicemail messages

[general] Section

The general section’s configuration settings are:

Attach Copy voicemail as an audio file and send via e-mail as an attachment

Delete After sending an e-mail, delete voicemail after notification. Works with Attach, and can be used

while defining the mailbox as: 823 => 1234,office,office@abc.com,attach=yes|

delete=1Mailcmd Program used by Asterisk to send an e-mail, for

example: mailcmd=/usr/sbin/sendmail -v -t –f pbx@abc.com

Maxsilence Indicates how many seconds of silence to allow before ending the recording

[general] Section

Pbxskip Changes the subject line in a voicemail notification message. Takes values yes or no. If yes, the

Subject: line will be: “Subject: New message M in mailbox B". When set to no, the Subject: line will read, "Subject: [PBX]: New message M in mailbox B"

Fromstring Overrides a portion of the From: line in a voicemail notification message. The default is “From:

Asterisk PBX”Emailsubject Defines an e-mail subject, for example:

emailsubject=New voicemail in mailbox ${VM_MAILBOX} from ${VM_CALLERID}

Emailbody An example: emailbody=\n\tHi ${VM_NAME},\n\n\tYou have a

${VM_DUR} long new voicemail message (number ${VM_MSGNUM}) in mailbox ${VM_MAILBOX}\nfrom ${VM_CIDNAME} (${VM_CIDNUM}), on ${VM_DATE}\nso

you might want to check it when you get a chance.\n\n

[general] Section

Context An optional context when a user presses the # key or 0 to exit voicemail

Nextaftercmd If set to yes, the system will automatically play the next message after deleting a voicemail message

[zonemessages] Section

Define time-zones for different users in the [zonemessages] section, and assign voicemail boxes to use the setting for one of these zones later. The syntax is:

Zonename= timezone|time_formatZonename is the name used to identify the zoneTimezone is the name of the system time zone as found in

/usr/share/zoneinfoTime_format specifies how the voicemail system should announce the

timesThe Time_format argument is composed of the following elements: Filename The filename of the sound file$(VAR) Variable substitutionA or a The day of the week (Saturday, Sunday, etc.)B or b or h The name of the month (January, February, etc.)

[zonemessages] Section

D or e The numeric day of the month (First, second, etc.)

Y YearI or I Hour, 12-hour clockH Hour, 24-hour clock (single digit hours

preceded by an oh)K Hour, 24-hour clock (single digit hours not

preceded by an oh)M MinutesP or p AM or PMQ Today, yesterdayR 24-hour time, including minutes

[zonemessages] Section

Examples:

12-hours Pacific Standard TimeSan-diego=America/Tijuana|’vm-received’Q’digits/at’IMP

24-hours Pacific Standard TimeSan-diego=America/Tijuana|’vm-received’Q’digits/at’R

[context] Section

The format is: Extension_number => voicemail_password,user_name,

user_email_address, user_pager_email_address, user_options

Options override the settings in the default section. Attach, servermail, tz, saycid, review, operater, callbak, dialout and exitcontext are defined here:

Tz defines the time-zone setting as defined in the zonemessages section. For example:

123 => 2048, abc_user, abc@osrc.org.pk,,tz=sandiego|attach=yes

Extensions.conf Applications

VoiceMail()

The format is:VoiceMail(boxnumber [@context] ] [&boxnumber2 [@context]],

[flags])

Record the audio file in the given box number which may be specified in voicemail.conf. The flags can be any of the following:

s Skip an instruction such as “Please leave a message ……..”u Cause an unavailable message to be playedb Cause the busy message to be playedg(#) Adjust the gain of the recording. The # key is gain in

decibelsNote: Do not specify u & b together

Extensions.conf Applications

VMSTATUS is the channel variable which will be set after completion. The possible values are:

SUCCESS|USEREXIT|FAILED

The path of stored voice messages is:/var/spool/asterisk/voicemail/context/boxnumber/INBOX/

VoiceMailMain()Enter the main voicemail system to check voicemail. The format

is:VoicemailMain([[s]mailbox]@context)

If s is specified, then the password check will be skipped. If a context is specified, then a login in that context will be considered

Sip/iax/zapata.conf Configuration

Define the mailbox’s parameter for the user. For example:

Mailbox=1234orMailbox=1234@context