|
|
|
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.
[general] contetx
The [general] context manage the global options of the voicemail boxes
An easy example could be:
[general]
; Should the email contain the voicemail as an attachment
attach=yes
; Default formats for writing Voicemail
format=wav
; Maximum length of a voicemail message in seconds
maxmessage=180
; Minimum length of a voicemail message in seconds
minmessage=3
; Say the caller id information before the message.
saycid=yes
; Max number of failed login attempts
maxlogins=3
We are going to show in a table the most importants commands that can be used in this context:
Command |
Explanation and options |
attach |
Should the email contain the voicemail as an attachment It can be "yes" or "no" By default "no" |
delete |
The message will be deleted if it is sent by email |
mailcmd |
Path of the mail server |
maxsilence |
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. |
envelope |
with "yes" shows the date and hour when the message was received |
externnotify |
Execute an external program when somebody leave a message |
externpass |
Execute an external program when somebody change the voicemail password |
silencetreshold |
if maxsilence="yes" or a value is the silence treshold |
servermail |
From field of the e-mail. Ex. mail@mydomain.com |
maxmessage |
Maximum length of a voicemail message in seconds |
maxmsg |
Maximum length of a voicemail message in number |
minmessage |
Deletes messages with less duration in seconds that this value |
format |
Default formats for writing Voicemail. Possibilities: "wav49", "gsm", "wav" |
maxgreet |
Maximum length of the welcome message in seconds |
maxlogins |
Max number of failed login attempts |
cdinternalcontexts |
If the context are internals or externals |
promiscredir |
support 302 redirections. By default "no" |
review |
By default "no". With "yes" the user can review the message before saved it |
operator |
To call another extension when the voicemail start |
saycid |
Say the caller id information before the message |
fromstring |
from of the mail alerting message |
emailsubject |
subject of the mail alerting message |
emailbody |
body of the mail alerting message |
nextaftercmd |
to hear the next message automatically when the previous one is deleted |
[zonemessages] context
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
[zonemessages]
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:
Option |
Description |
'fichero' |
File to play |
${VAR} |
Variable |
A, a |
Weekday (saturday,monday...) |
B,b,h |
Month (Jnaury,May, ...) |
d,e |
Month with numbers (first, second, twenty...) |
Y |
Year |
I or i |
Hour, (12 hours format) |
H ,k |
Hour, (24 hour format) |
M |
Minutes |
P,p |
AM or PM |
Q |
"today","yesterday" |
R |
time 24 hours , minutes included |
other contexts[]
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:
[default]
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
Examples:
[default]
1234 => 3456,Example1,mail@domain.com
4200 => 9855,Peter Smith,peter@domain.com,admin@domain.com,attach=no|serveremail=info@dominio.com|tz=madrid
4069 => 6522,john,j@dominio.net,,attach=yes|saycid=yes|dialout=fromvm|callback=fromvm|review=yes|operator=yes|envelope=yes
4073 => 1099,xabier lincoln,xabier@domain.com,,delete=1
|
|
|