THIS WIKI HAS BEEN UPDATED FOR VERSION 13 OF YOUR PBX GUI
These settings are for advanced use cases. In most cases, the defaults will work. These should not be touched unless you know what you are doing.
- In the top menu click Settings
- In the Dropdown click Voicemail Admin
- Click the Settings tab.
The ADSI feature descriptor number to download to
The ADSI security lock code
The ADSI voicemail application version number
Attach the voicemail to email
IMAP server master password
IMAP server master username
Number of deleted messages saved per mailbox (can be a number or yes/no, yes meaning MAXMSG, no meaning 0).
Context to call back from; if not listed, calling the sender back will not be permitted.
The character set for voicemail messages
Comma separated list of internal contexts to use caller ID.
Context to dial out from [option 4 from the advanced menu] if not listed, dialing out will not be permitted.
Change the email body. Variables:
Load date format config for Voicemail mail.
Email subject. Default = "PBX Voicemail Notification"
Whether to play back envelope information before message playback. Default = yes. This does NOT affect option 3,3 from the advanced options menu.
Context to check for handling * or 0 calls to operator. "Operator Context"
Expunge (mark messages for deletion) on hangup/exit.
External Voicemail notify application. Default = "/var/lib/asterisk/agi-bin/vmnotify-newvm.php"
External password changing command (overrides externpassnotify).
Command specified runs after a user changes his password.
Force new user to record greetings (the same as forcename, except for recording greetings). Default = No.
Force a new user to record their name. A new user is determined by the password being the same as the mailbox number. Default = yes.
Formats for writing voicemail. Note that when using IMAP storage for Voicemail, only the first format specified will be used.
The format setting selects audio file format(s) to use when storing voice mail messages. The value is a string defining the audio format(s) of the message file. The default format string is wav49|gsm|wav , meaning that Asterisk will save the voicemail message in all three supported formats. When emailing the attachment, however, it will send only the first of the formats defined here. When playing back (as with all file playback) Asterisk will attempt to use the optimum format based on the codec used for the current channel, in order to provide the best sound quality and to reduce transcoding processing time.
- wav49: In this format, the file size will be small, the quality good, and it's a good choice for sending voicemail messages in email. The file will have a .WAV extension, which all Windows users should have no problems with, and users on other platforms should also be able to easily play these sound files.
- gsm: Voicemail saved in this format will have about the same file size and same audio quality as wav49. It may be less well supported by client operating systems if sent to users in email, however.
- wav: This is an uncompressed sound format with a .wav extension, so the file size is very large. Sound quality will be great, but you probably don't want to email it, and you must have adequate disk space.
- g723sf: The sample voicemail.conf file has this option commented out. If you try to activate it, you will find that it doesn't work.
If you're running Asterisk on Mac OS X, which has a case-preserving but case-insensitive file system, you can use .wav but you won't be able to use .WAV(wav49). Asterisk tries to pick the best file in the Playback command based on the encoding of your channel, and then looks for the file by file type in a specific order. In either case, asterisk will look for filename.wav, and if there is a filename.WAV, the file lookup will succeed. Asterisk will then try to play the file as "wav", and choke on the format. This is especially noticeable in voicemail. If you have both wav49 and wav in the format= option, one will replace the other. You must remove wav49 from the format= option in voicemail.conf.
From: string for email. Default = "PBX Voicemail"
If imapgreetings=yes, then specify which folder to store your greetings in. If you do not specify a folder, then INBOX will be used.
For IMAP storage
IMAP server flags. Specify any IMAP flags needed here ("notls" for example).
If using IMAP storage, specify whether voicemail greetings should be stored via IMAP. If no, then greetings are stored as if IMAP storage were not enabled.
For IMAP storage - TCP open timeout in seconds
Set the parent folder (default is to have no parent folder set).
IMAP server address (IP Address or Hostname)
For IMAP storage - TCP write timeout in seconds
Customize the key that fast-forwards message playback
Customize the key that pauses/un-pauses message playback
Customize the key that restarts message playback
Customize the key that rewinds message playback
Customize the key that stops message playback
Max message greeting length
Maximum failed login attempts
Maximum message time length (in seconds). Default = 300
Maximum number of messages per folder. If not specified, a default value (100) is used. Maximum value for this option is 9999.
Minimum character (digit) count for passwords. This password length will be enforced.
Maximum message time length (in seconds). Default = 300
How many seconds of silence before we end the recording
Min message time length – maxsilence should be less than minsecs, or you may get empty messages.
Move heard messages to the "Old" folder automatically. Default = No
Skip to the next message after save/delete. Default = No
The value of odbcstorage is the database connection configured in res_odbc.conf.
The default table for ODBC Voicemail storage is voicemessages.
Operator break. Allow sender to hit 0 before/after/during leaving a voicemail to reach an operator. Default = yes
Body of message sent to pager
From: string sent to pager
Subject sent to pager
Skip the "[PBX]:" string from the message title. Default = No
If the "pollmailboxes" option is enabled, this option sets the polling frequency in seconds. Default = 30
Whether to poll mailboxes for MWI (message waiting indicator). If mailboxes are changed anywhere outside of app_voicemail, then this option must be enabled for MWI to work. This enables polling mailboxes for changes. Normally, it will expect that changes are only made when someone called in to one of the Voicemail applications. Examples of situations that would require this option are web interfaces to Voicemail or an email client in the case of using IMAP storage. Default = yes
Allow sender to review/rerecord their message before saving it. Default = No
Read back caller's telephone number prior to playing the incoming message, and just after announcing the date and time the message was left. If not described, or set to no, it will be in the envelope. Default = No
Say duration information before message playback Default = Yes
The minimum message length (in minutes) required in order to trigger the system to say the message duration. Specify in minutes the minimum duration to say. Default = 2
Search all contexts instead of the current context (if one is not specified). Default = No
Send voicemail message. If not listed, sending messages from inside voicemail will not be permitted. Default = yes
Who the e-mail notification should appear to come from
Silence threshold (what we consider silence: the lower, the more sensitive)
How many milliseconds to skip forward/back when rewinding/fast-forwarding in message playback
Enable Simple Message Desk Interface (SMDI) integration
Valid port as specified in smdi.conf for using smdi for external notification.
Temporary greeting reminder. Default = yes
Permit finding entries for forward/compose from the directory. Default = yes
User context is where entries from users.conf are registered. Default value = "default"
Customize which sound file is used instead of the default prompt that says: "The passwords you entered and re-entered did not match. Please try again."
Customize which sound file is used instead of the default prompt that says: "Please enter your new password followed by the pound key."
Customize which sound file is used instead of the default prompt that says: "Your password has been changed."
Customize which sound file is used instead of the default prompt that says: "password"
Customize which sound file is used instead of the default prompt that says: "Please re-enter your password followed by the pound key"
Emails bearing the voicemail may arrive in a volume too quiet to be heard. This parameter allows you to specify how much gain to add to the message when sending a Voicemail. NOTE: sox must be installed for this option to work.