asterisk/voicemail.conf

Fri, 15 Oct 2010 19:06:09 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Fri, 15 Oct 2010 19:06:09 +0200
changeset 263
f4a0b439d0fb
permissions
-rw-r--r--

Correct shared library and plugin link logic, as well as informal text.
Update file server URL, update build resource estimations, correct RPATH
logic, allow for qmake(1) static to shared library changes via CONFIG
argument, correct documentation broken title and index links, correct
shared library install path, install only one set of (correct) plugins,
install the designer shared library (as required by QtCreator), announce
features related to shared linking using qmake(1), and correclty
substitute hard coded paths in prl and la library files.

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

mercurial