voicemail.conf configuration file
The voicemail.conf file configures the automatic answering machine and manage the voicemail boxes of the users
The file voicemail.conf is also made up of sections or contexts between brackets [ ]
There are two special contexts called [ general ] and [ zonemessages ] that are always in this file.
The [general] context manage the global options of the voicemail boxes
An easy example could be:
; Should the email contain the voicemail as an attachment
; Default formats for writing Voicemail
; Maximum length of a voicemail message in seconds
; Minimum length of a voicemail message in seconds
; Say the caller id information before the message.
; Max number of failed login attempts
We are going to show in a table the most importants commands that can be used in this context:
|Explanation and options
||Should the email contain the voicemail as an attachment It can be "yes" or "no" By default "no"
|| The message will be deleted if it is sent by email
||Path of the mail server
||Silence seconds that must be detected to cut the call to the voicemail. By default is 0 that means an infinite time so silences are not important.
||with "yes" shows the date and hour when the message was received
||Execute an external program when somebody leave a message
||Execute an external program when somebody change the voicemail password
||if maxsilence="yes" or a value is the silence treshold
|| From field of the e-mail. Ex. email@example.com
|| Maximum length of a voicemail message in seconds
||Maximum length of a voicemail message in number
||Deletes messages with less duration in seconds that this value
||Default formats for writing Voicemail. Possibilities: "wav49", "gsm", "wav"
|| Maximum length of the welcome message in seconds
|| Max number of failed login attempts
|| If the context are internals or externals
||support 302 redirections. By default "no"
||By default "no". With "yes" the user can review the message before saved it
||To call another extension when the voicemail start
||Say the caller id information before the message
||from of the mail alerting message
||subject of the mail alerting message
|| body of the mail alerting message
||to hear the next message automatically when the previous one is deleted
This context defines hour zones. The hour for different users is not the same and to inform him of the hour in which a message is received it is necessary to fix different zones:
An easy example
madrid=Europe/Paris|'vm-received' Q 'digits/at' R
paris=Europe/Paris|'vm-received' Q 'digits/at' R
sthlm=Europe/Stockholm|'vm-recieved' Q 'digits/at' R
europa=Europe/Berlin|'vm-received' Q 'digits/at' kM
italia=Europe/Rome|'vm-received' Q 'digit/at' HMP
eastern=America/New_York|'vm-received' Q 'digits/at' IMp
central=America/Chicago|'vm-received' Q 'digits/at' IMp
central24=America/Chicago|'vm-received' q 'digits/at' H 'digits/hundred' M 'hours'
The format is:
zone=Country/City|Options--> The country and city must be valid and must be defined in /usr/share/zoneinfo of Linux installation
The different options are:
||File to play
||Month (Jnaury,May, ...)
||Month with numbers (first, second, twenty...)
|I or i
||Hour, (12 hours format)
||Hour, (24 hour format)
||AM or PM
||time 24 hours , minutes included
In the rest of contexts the user mailboxes are defined. We can have all the users in a single context for example [ default ] or have more contexts.
The basic format is the following one:
extension => password, username, email, alerting email, options
Extension is the number called.
- "password" is the personal password of each user
- "username" is the way the user is named
- "email" is the email where the messages will be sent
- "alerting email" is an alternative email where the notifications for administration or control can be sent
- Options overwrites the [general] context options or puts the user time zone. There are 9 specific ones: attach, serveremail, tz, saycid, review, operator, callback, dialout and exitcontext. They are the sames of [general] context Only tz is new .It is used to overwrite the zone and must be present in the[zonemessages] context
1234 => 3456,Example1,firstname.lastname@example.org
4200 => 9855,Peter Smith,email@example.com,firstname.lastname@example.org,email@example.com|tz=madrid
4069 => 6522,john,firstname.lastname@example.org,,attach=yes|saycid=yes|dialout=fromvm|callback=fromvm|review=yes|operator=yes|envelope=yes
4073 => 1099,xabier lincoln,email@example.com,,delete=1