| |
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
|
|
