Document the maximum length of voicemail email message body. Bug #1299
[asterisk/asterisk.git] / configs / voicemail.conf.sample
1 ;
2 ; Voicemail Configuration
3 ;
4 [general]
5 ; Default formats for writing Voicemail
6 ;format=g723sf|wav49|wav
7 format=wav49|gsm|wav
8 ; Who the e-mail notification should appear to come from
9 serveremail=asterisk
10 ;serveremail=asterisk@linux-support.net
11 ; Should the email contain the voicemail as an attachment
12 attach=yes
13 ; Maximum length of a voicemail message in seconds
14 ;maxmessage=180
15 ; Minimum length of a voicemail message in seconds
16 ;minmessage=3
17 ; Maximum length of greetings in seconds
18 ;maxgreet=60
19 ; How many miliseconds to skip forward/back when rew/ff in message playback
20 skipms=3000
21 ; How many seconds of silence before we end the recording
22 maxsilence=10
23 ; Silence threshold (what we consider silence, the lower, the more sensitive)
24 silencethreshold=128
25 ; Max number of failed login attempts
26 maxlogins=3
27
28 ; Skip the "[PBX]:" string from the message title
29 ;pbxskip=yes
30 ; Change the From: string
31 ;fromstring=The Asterisk PBX
32 ;
33 ; Change the email body, variables: 
34 ;     VM_NAME, VM_DUR, VM_MSGNUM, VM_MAILBOX, VM_CALLERID, VM_DATE
35 ;
36 ; Note: The emailbody config row can be up to 512 characters due to a limitation in 
37 ;       asterisk config files.
38 ;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
39
40 ;
41 ; You can override the default program to send e-mail if you wish, too
42 ;
43 ;mailcmd=/usr/sbin/sendmail -t
44
45 ; Users may be located in different timezones, or may have different 
46 ; message announcements for their introductory message when they enter 
47 ; the voicemail system. Set the message and the timezone each user 
48 ; hears here. Set the user into one of these zones with the tz= attribute 
49 ; in the options field of the mailbox. Of course, language substitution 
50 ; still applies here so you may have several directory trees that have 
51 ; alternate language choices. 
52
53 ; Look in /usr/share/zoneinfo/ for names of timezones. 
54 ; Look at the manual page for strftime for a quick tutorial on how the 
55 ; variable substitution is done on the values below. 
56
57 ; Supported values: 
58 ; 'filename'    filename of a soundfile (single ticks around the filename required)
59 ; ${VAR}        variable substitution 
60 ; A or a        Day of week (Saturday, Sunday, ...) 
61 ; B or b or h   Month name (January, February, ...) 
62 ; d or e        numeric day of month (first, second, ..., thirty-first) 
63 ; Y             Year 
64 ; I or l        Hour, 12 hour clock 
65 ; H             Hour, 24 hour clock (single digit hours preceded by "oh") 
66 ; k             Hour, 24 hour clock (single digit hours NOT preceded by "oh") 
67 ; M             Minute 
68 ; P or p        AM or PM 
69 ; Q             "today", "yesterday" or ABdY (*note: not standard strftime value) 
70 ; q             "" (for today), "yesterday", weekday, or ABdY (*note: not standard strftime value) 
71 ; R             24 hour time, including minute 
72
73
74 [zonemessages] 
75 eastern=America/New_York|'vm-received' Q 'digits/at' IMp 
76 central=America/Chicago|'vm-received' Q 'digits/at' IMp 
77 central24=America/Chicago|'vm-received' q 'digits/at' H 'digits/hundred' M 'hours'
78
79 ;
80 ; Each mailbox is listed in the form <mailbox>=<password>,<name>,<email>,<pager_email>,<options>
81 ; if the e-mail is specified, a message will be sent when a message is
82 ; received, to the given mailbox. If pager is specified, a message will be sent there as well.
83 ;
84 [default]
85 1234 => 4242,Example Mailbox,root@localhost
86 ;4200 => 9855,Mark Spencer,markster@linux-support.net,mypager@digium.com,attach=no|serveremail=myaddy@digium.com|tz=central
87 ;4300 => 3456,Ben Rigas,ben@american-computer.net
88 ;4310 => 5432,Sales,sales@marko.net
89 ;4069 => 6522,Matt Brooks,matt@marko.net
90 ;4110 => 3443,Rob Flynn,rflynn@blueridge.net
91
92 ;
93 ; Mailboxes may be organized into multiple contexts for
94 ; voicemail virtualhosting
95 ;
96
97 [other]
98 1234 => 5678,Company2 User,root@localhost