System information

Table 18-2 shows some of the other options available to us.
Table 18-2. Additional IMAP voicemail options
Option Description
imapfolder Provides the name of the folder in which to store voicemail messages on your IMAP server. By default
they are stored in the INBOX.
a
imapgreetings Defines whether voicemail greetings are stored on the IMAP server or stored locally on the server.
Valid values are yes or no.
imapparentfolder Defines the parent folder on the IMAP server. Usually this configured as INBOX on the server, but if
it is called something else, you can specify it here.
greetingfolder Specifies the folder in which to save the voicemail greetings, if you’ve enabled the imapgreet
ings option by setting it to yes. By default greetings are saved in the INBOX.
authuser Specifies the master user to use for connecting to your IMAP server, if the server is configured with
a single user that has access to all mailboxes.
authpassword Complement to the authuser directive. See authuser for more information.
opentimeout Specifies the TCP open timeout (in seconds).
closetimeout Specifies the TCP close timeout (in seconds).
readtimeout Specifies the TCP read timeout (in seconds).
writetimeout Specifies the TCP write timeout (in seconds).
a
It is important to store your voicemail messages in a folder other than the INBOX if the number of messages contained in the INBOX could
be rather large. Asterisk will try to gather information about all the emails contained in the INBOX, and could either time out before retrieving
all the information or just take a very long time to store or retrieve voicemail messages, which is not desirable.
With our [general] section configured, let’s define a mailbox for connecting to the
IMAP server.
In Chapter 8 we defined some users in the [shifteight] voicemail context. Here is the
original configuration as defined in that chapter:
[shifteight]
100 => 0107,Leif Madsen,[e-mail]
101 => 0523,Jim VanMeggelen,[e-mail],,attach=no|maxmsg=100
102 => 11042,Tilghman Lesher,,,attach=no|tz=central
We’re going to modify mailbox 100 in such a way that it connects to the Gmail IMAP
server to store and retrieve voicemail messages:
[shifteight]
100 => 0107,Leif Madsen,,,|imapuser=[e-mail]|imappassword=secret
The voicemail.conf file uses both commas and pipes as separators, de-
pending on which field is being used. The first few fields have specific
settings in them, and the last field can contain extra information about
the mailbox, which is separated by the pipe character (|).
VoiceMail IMAP Integration | 417