Fri, 22 Oct 2010 13:22:33 +0200
Import package vendor original specs for necessary manipulations.
michael@202 | 1 | ; |
michael@202 | 2 | ; Voicemail Configuration |
michael@202 | 3 | ; |
michael@202 | 4 | |
michael@202 | 5 | ; |
michael@202 | 6 | ; NOTE: Asterisk has to edit this file to change a user's password. This does |
michael@202 | 7 | ; not currently work with the "#include <file>" directive for Asterisk |
michael@202 | 8 | ; configuration files, nor when using realtime static configuration. |
michael@202 | 9 | ; Do not use them with this configuration file. |
michael@202 | 10 | ; |
michael@202 | 11 | |
michael@202 | 12 | ;[general] |
michael@202 | 13 | ; Formats for writing Voicemail. Note that when using IMAP storage for |
michael@202 | 14 | ; voicemail, only the first format specified will be used. |
michael@202 | 15 | ;format=g723sf|wav49|wav |
michael@202 | 16 | ;format=wav49|gsm|wav |
michael@202 | 17 | ; |
michael@202 | 18 | ; WARNING: |
michael@202 | 19 | ; If you change the list of formats that you record voicemail in |
michael@202 | 20 | ; when you have mailboxes that contain messages, you _MUST_ absolutely |
michael@202 | 21 | ; manually go through those mailboxes and convert/delete/add the |
michael@202 | 22 | ; the message files so that they appear to have been stored using |
michael@202 | 23 | ; your new format list. If you don't do this, very unpleasant |
michael@202 | 24 | ; things may happen to your users while they are retrieving and |
michael@202 | 25 | ; manipulating their voicemail. |
michael@202 | 26 | ; |
michael@202 | 27 | ; In other words: don't change the format list on a production system |
michael@202 | 28 | ; unless you are _VERY_ sure that you know what you are doing and are |
michael@202 | 29 | ; prepared for the consequences. |
michael@202 | 30 | ; |
michael@202 | 31 | ; Who the e-mail notification should appear to come from |
michael@202 | 32 | ;serveremail=asterisk |
michael@202 | 33 | ;serveremail=asterisk@linux-support.net |
michael@202 | 34 | ; Should the email contain the voicemail as an attachment |
michael@202 | 35 | ;attach=yes |
michael@202 | 36 | ; Maximum number of messages per folder. If not specified, a default value |
michael@202 | 37 | ; (100) is used. Maximum value for this option is 9999. |
michael@202 | 38 | ;maxmsg=100 |
michael@202 | 39 | ; Maximum length of a voicemail message in seconds |
michael@202 | 40 | ;maxmessage=180 |
michael@202 | 41 | ; Minimum length of a voicemail message in seconds for the message to be kept |
michael@202 | 42 | ; The default is no minimum. |
michael@202 | 43 | ;minmessage=3 |
michael@202 | 44 | ; Maximum length of greetings in seconds |
michael@202 | 45 | ;maxgreet=60 |
michael@202 | 46 | ; How many milliseconds to skip forward/back when rew/ff in message playback |
michael@202 | 47 | ;skipms=3000 |
michael@202 | 48 | ; How many seconds of silence before we end the recording |
michael@202 | 49 | ;maxsilence=10 |
michael@202 | 50 | ; Silence threshold (what we consider silence: the lower, the more sensitive) |
michael@202 | 51 | ;silencethreshold=128 |
michael@202 | 52 | ; Max number of failed login attempts |
michael@202 | 53 | ;maxlogins=3 |
michael@202 | 54 | ; |
michael@202 | 55 | ; User context is where entries from users.conf are registered. The |
michael@202 | 56 | ; default value is 'default' |
michael@202 | 57 | ; |
michael@202 | 58 | ;userscontext=default |
michael@202 | 59 | ; |
michael@202 | 60 | ; If you need to have an external program, i.e. /usr/bin/myapp |
michael@202 | 61 | ; called when a voicemail is left, delivered, or your voicemailbox |
michael@202 | 62 | ; is checked, uncomment this. It can also be set to 'smdi' to use |
michael@202 | 63 | ; smdi for external notification. If it is 'smdi', smdiport should |
michael@202 | 64 | ; be set to a valid port as specified in smdi.conf. |
michael@202 | 65 | |
michael@202 | 66 | ;externnotify=/usr/bin/myapp |
michael@202 | 67 | ;smdiport=/dev/ttyS0 |
michael@202 | 68 | |
michael@202 | 69 | ; If you need to have an external program, i.e. /usr/bin/myapp |
michael@202 | 70 | ; called when a voicemail password is changed, uncomment this: |
michael@202 | 71 | ;externpass=/usr/bin/myapp |
michael@202 | 72 | ; For the directory, you can override the intro file if you want |
michael@202 | 73 | ;directoryintro=dir-intro |
michael@202 | 74 | ; The character set for voicemail messages can be specified here |
michael@202 | 75 | ;charset=ISO-8859-1 |
michael@202 | 76 | ; The ADSI feature descriptor number to download to |
michael@202 | 77 | ;adsifdn=0000000F |
michael@202 | 78 | ; The ADSI security lock code |
michael@202 | 79 | ;adsisec=9BDBF7AC |
michael@202 | 80 | ; The ADSI voicemail application version number. |
michael@202 | 81 | ;adsiver=1 |
michael@202 | 82 | ; Skip the "[PBX]:" string from the message title |
michael@202 | 83 | ;pbxskip=yes |
michael@202 | 84 | ; Change the From: string |
michael@202 | 85 | ;fromstring=The Asterisk PBX |
michael@202 | 86 | ; Permit finding entries for forward/compose from the directory |
michael@202 | 87 | ;usedirectory=yes |
michael@202 | 88 | ; Voicemail can be stored in a database using the ODBC driver. |
michael@202 | 89 | ; The value of odbcstorage is the database connection configured |
michael@202 | 90 | ; in res_odbc.conf. |
michael@202 | 91 | ;odbcstorage=asterisk |
michael@202 | 92 | ; The default table for ODBC voicemail storage is voicemessages. |
michael@202 | 93 | ;odbctable=voicemessages |
michael@202 | 94 | ; |
michael@202 | 95 | ; Change the from, body and/or subject, variables: |
michael@202 | 96 | ; VM_NAME, VM_DUR, VM_MSGNUM, VM_MAILBOX, VM_CALLERID, VM_CIDNUM, |
michael@202 | 97 | ; VM_CIDNAME, VM_DATE |
michael@202 | 98 | ; |
michael@202 | 99 | ; Note: The emailbody config row can only be up to 512 characters due to a |
michael@202 | 100 | ; limitation in the Asterisk configuration subsystem. |
michael@202 | 101 | ;emailsubject=[PBX]: New message ${VM_MSGNUM} in mailbox ${VM_MAILBOX} |
michael@202 | 102 | ; The following definition is very close to the default, but the default shows |
michael@202 | 103 | ; just the CIDNAME, if it is not null, otherwise just the CIDNUM, or "an unknown |
michael@202 | 104 | ; caller", if they are both null. |
michael@202 | 105 | ;emailbody=Dear ${VM_NAME}:\n\n\tjust wanted to let you know you were just left a ${VM_DUR} long message (number ${VM_MSGNUM})\nin mailbox ${VM_MAILBOX} from ${VM_CALLERID}, on ${VM_DATE}, so you might\nwant to check it when you get a chance. Thanks!\n\n\t\t\t\t--Asterisk\n |
michael@202 | 106 | ; |
michael@202 | 107 | ; You can also change the Pager From: string, the pager body and/or subject. |
michael@202 | 108 | ; The above defined variables also can be used here |
michael@202 | 109 | ;pagerfromstring=The Asterisk PBX |
michael@202 | 110 | ;pagersubject=New VM |
michael@202 | 111 | ;pagerbody=New ${VM_DUR} long msg in box ${VM_MAILBOX}\nfrom ${VM_CALLERID}, on ${VM_DATE} |
michael@202 | 112 | ; |
michael@202 | 113 | ; Set the date format on outgoing mails. Valid arguments can be found on the |
michael@202 | 114 | ; strftime(3) man page |
michael@202 | 115 | ; |
michael@202 | 116 | ; Default |
michael@202 | 117 | ;emaildateformat=%A, %B %d, %Y at %r |
michael@202 | 118 | ; 24h date format |
michael@202 | 119 | ;emaildateformat=%A, %d %B %Y at %H:%M:%S |
michael@202 | 120 | ; |
michael@202 | 121 | ; You can override the default program to send e-mail if you wish, too |
michael@202 | 122 | ; |
michael@202 | 123 | ;mailcmd=/usr/sbin/sendmail -t |
michael@202 | 124 | ; |
michael@202 | 125 | ; Users may be located in different timezones, or may have different |
michael@202 | 126 | ; message announcements for their introductory message when they enter |
michael@202 | 127 | ; the voicemail system. Set the message and the timezone each user |
michael@202 | 128 | ; hears here. Set the user into one of these zones with the tz= attribute |
michael@202 | 129 | ; in the options field of the mailbox. Of course, language substitution |
michael@202 | 130 | ; still applies here so you may have several directory trees that have |
michael@202 | 131 | ; alternate language choices. |
michael@202 | 132 | ; |
michael@202 | 133 | ; Look in /usr/share/zoneinfo/ for names of timezones. |
michael@202 | 134 | ; Look at the manual page for strftime for a quick tutorial on how the |
michael@202 | 135 | ; variable substitution is done on the values below. |
michael@202 | 136 | ; |
michael@202 | 137 | ; Supported values: |
michael@202 | 138 | ; 'filename' filename of a soundfile (single ticks around the filename |
michael@202 | 139 | ; required) |
michael@202 | 140 | ; ${VAR} variable substitution |
michael@202 | 141 | ; A or a Day of week (Saturday, Sunday, ...) |
michael@202 | 142 | ; B or b or h Month name (January, February, ...) |
michael@202 | 143 | ; d or e numeric day of month (first, second, ..., thirty-first) |
michael@202 | 144 | ; Y Year |
michael@202 | 145 | ; I or l Hour, 12 hour clock |
michael@202 | 146 | ; H Hour, 24 hour clock (single digit hours preceded by "oh") |
michael@202 | 147 | ; k Hour, 24 hour clock (single digit hours NOT preceded by "oh") |
michael@202 | 148 | ; M Minute, with 00 pronounced as "o'clock" |
michael@202 | 149 | ; N Minute, with 00 pronounced as "hundred" (US military time) |
michael@202 | 150 | ; P or p AM or PM |
michael@202 | 151 | ; Q "today", "yesterday" or ABdY |
michael@202 | 152 | ; (*note: not standard strftime value) |
michael@202 | 153 | ; q "" (for today), "yesterday", weekday, or ABdY |
michael@202 | 154 | ; (*note: not standard strftime value) |
michael@202 | 155 | ; R 24 hour time, including minute |
michael@202 | 156 | ; |
michael@202 | 157 | ; |
michael@202 | 158 | ; |
michael@202 | 159 | ; Each mailbox is listed in the form <mailbox>=<password>,<name>,<email>,<pager_email>,<options> |
michael@202 | 160 | ; if the e-mail is specified, a message will be sent when a message is |
michael@202 | 161 | ; received, to the given mailbox. If pager is specified, a message will be |
michael@202 | 162 | ; sent there as well. If the password is prefixed by '-', then it is |
michael@202 | 163 | ; considered to be unchangeable. |
michael@202 | 164 | ; |
michael@202 | 165 | ; Advanced options example is extension 4069 |
michael@202 | 166 | ; NOTE: All options can be expressed globally in the general section, and |
michael@202 | 167 | ; overridden in the per-mailbox settings, unless listed otherwise. |
michael@202 | 168 | ; |
michael@202 | 169 | ; tz=central ; Timezone from zonemessages below. Irrelevant if envelope=no. |
michael@202 | 170 | ; attach=yes ; Attach the voicemail to the notification email *NOT* the pager email |
michael@202 | 171 | ; attachfmt=wav49 ; Which format to attach to the email. Normally this is the |
michael@202 | 172 | ; first format specified in the format parameter above, but this |
michael@202 | 173 | ; option lets you customize the format sent to particular mailboxes. |
michael@202 | 174 | ; Useful if Windows users want wav49, but Linux users want gsm. |
michael@202 | 175 | ; [per-mailbox only] |
michael@202 | 176 | ; saycid=yes ; Say the caller id information before the message. If not described, |
michael@202 | 177 | ; or set to no, it will be in the envelope |
michael@202 | 178 | ; cidinternalcontexts=intern ; Internal Context for Name Playback instead of |
michael@202 | 179 | ; extension digits when saying caller id. |
michael@202 | 180 | ; sayduration=no ; Turn on/off the duration information before the message. [ON by default] |
michael@202 | 181 | ; saydurationm=2 ; Specify the minimum duration to say. Default is 2 minutes |
michael@202 | 182 | ; dialout=fromvm ; Context to dial out from [option 4 from mailbox's advanced menu]. |
michael@202 | 183 | ; If not specified, option 4 will not be listed and dialing out |
michael@202 | 184 | ; from within VoiceMailMain() will not be permitted. |
michael@202 | 185 | ;sendvoicemail=yes ; Allow the user to compose and send a voicemail while inside |
michael@202 | 186 | ; VoiceMailMain() [option 5 from mailbox's advanced menu]. |
michael@202 | 187 | ; If set to 'no', option 5 will not be listed. |
michael@202 | 188 | ; searchcontexts=yes ; Current default behavior is to search only the default context |
michael@202 | 189 | ; if one is not specified. The older behavior was to search all contexts. |
michael@202 | 190 | ; This option restores the old behavior [DEFAULT=no] |
michael@202 | 191 | ; callback=fromvm ; Context to call back from |
michael@202 | 192 | ; if not listed, calling the sender back will not be permitted |
michael@202 | 193 | ; review=yes ; Allow sender to review/rerecord their message before saving it [OFF by default |
michael@202 | 194 | ; operator=yes ; Allow sender to hit 0 before/after/during leaving a voicemail to |
michael@202 | 195 | ; reach an operator [OFF by default] |
michael@202 | 196 | ; envelope=no ; Turn on/off envelope playback before message playback. [ON by default] |
michael@202 | 197 | ; This does NOT affect option 3,3 from the advanced options menu |
michael@202 | 198 | ; delete=yes ; After notification, the voicemail is deleted from the server. [per-mailbox only] |
michael@202 | 199 | ; This is intended for use with users who wish to receive their |
michael@202 | 200 | ; voicemail ONLY by email. Note: "deletevoicemail" is provided as an |
michael@202 | 201 | ; equivalent option for Realtime configuration. |
michael@202 | 202 | ; volgain=0.0 ; Emails bearing the voicemail may arrive in a volume too |
michael@202 | 203 | ; quiet to be heard. This parameter allows you to specify how |
michael@202 | 204 | ; much gain to add to the message when sending a voicemail. |
michael@202 | 205 | ; NOTE: sox must be installed for this option to work. |
michael@202 | 206 | ; nextaftercmd=yes ; Skips to the next message after hitting 7 or 9 to delete/save current message. |
michael@202 | 207 | ; [global option only at this time] |
michael@202 | 208 | ; forcename=yes ; Forces a new user to record their name. A new user is |
michael@202 | 209 | ; determined by the password being the same as |
michael@202 | 210 | ; the mailbox number. The default is "no". |
michael@202 | 211 | ; forcegreetings=no ; This is the same as forcename, except for recording |
michael@202 | 212 | ; greetings. The default is "no". |
michael@202 | 213 | ; hidefromdir=yes ; Hide this mailbox from the directory produced by app_directory |
michael@202 | 214 | ; The default is "no". |
michael@202 | 215 | ;tempgreetwarn=yes ; Remind the user that their temporary greeting is set |
michael@202 | 216 | |
michael@202 | 217 | ;[zonemessages] |
michael@202 | 218 | ;eastern=America/New_York|'vm-received' Q 'digits/at' IMp |
michael@202 | 219 | ;central=America/Chicago|'vm-received' Q 'digits/at' IMp |
michael@202 | 220 | ;central24=America/Chicago|'vm-received' q 'digits/at' H N 'hours' |
michael@202 | 221 | ;military=Zulu|'vm-received' q 'digits/at' H N 'hours' 'phonetic/z_p' |
michael@202 | 222 | ;european=Europe/Copenhagen|'vm-received' a d b 'digits/at' HM |
michael@202 | 223 | |
michael@202 | 224 | |
michael@202 | 225 | |
michael@202 | 226 | ;[default] |
michael@202 | 227 | ; Define maximum number of messages per folder for a particular context. |
michael@202 | 228 | ;maxmsg=50 |
michael@202 | 229 | |
michael@202 | 230 | ;1234 => 4242,Example Mailbox,root@localhost |
michael@202 | 231 | ;4200 => 9855,Mark Spencer,markster@linux-support.net,mypager@digium.com,attach=no|serveremail=myaddy@digium.com|tz=central|maxmsg=10 |
michael@202 | 232 | ;4300 => 3456,Ben Rigas,ben@american-computer.net |
michael@202 | 233 | ;4310 => -5432,Sales,sales@marko.net |
michael@202 | 234 | ;4069 => 6522,Matt Brooks,matt@marko.net,,|tz=central|attach=yes|saycid=yes|dialout=fromvm|callback=fromvm|review=yes|operator=yes|envelope=yes|sayduration=yes|saydurationm=1 |
michael@202 | 235 | ;4073 => 1099,Bianca Paige,bianca@biancapaige.com,,delete=1 |
michael@202 | 236 | ;4110 => 3443,Rob Flynn,rflynn@blueridge.net |
michael@202 | 237 | ;4235 => 1234,Jim Holmes,jim@astricon.ips,,Tz=european |
michael@202 | 238 | |
michael@202 | 239 | |
michael@202 | 240 | ; |
michael@202 | 241 | ; Mailboxes may be organized into multiple contexts for |
michael@202 | 242 | ; voicemail virtualhosting |
michael@202 | 243 | ; |
michael@202 | 244 | |
michael@202 | 245 | ;[other] |
michael@202 | 246 | ;The intro can be customized on a per-context basis |
michael@202 | 247 | ;directoryintro=dir-company2 |
michael@202 | 248 | ;1234 => 5678,Company2 User,root@localhost |