<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/2042/1/7/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Configuring+Voice+Mail+Boxes">Configuring Voice Mail Boxes</a></h2>
<h4>Page <b>edited</b> by <a href="https://wiki.asterisk.org/wiki/display/~rmontgomery@digium.com">Rod Montgomery</a>
</h4>
<div id="versionComment">
<b>Comment:</b>
removed 'docs:' from section names<br />
</div>
<br/>
<h4>Changes (6)</h4>
<div id="page-diffs">
<table class="diff" cellpadding="0" cellspacing="0">
<tr><td class="diff-unchanged" >Now that we've covered the two main voice mail applications, let's look at the voicemail configuration. Voice mail options and mailboxes are configured in the *voicemail.conf* configuration file. This file has three major sections: <br> <br></td></tr>
<tr><td class="diff-changed-lines" >h4. The <span class="diff-changed-words">\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>general\]</span> section <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" >Near the top of *voicemail.conf*, you'll find the <span class="diff-changed-words">*\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>general\]*</span> section. This section of the configuration file controls the general aspects of the voicemail system, such as the maximum number of messages per mailbox, the maximum length of a voicemail message, and so forth. Feel free to look at the sample *voicemail.conf* file for more details about the various settings. <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" >h4. The <span class="diff-changed-words">\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>zonemessages\]</span> section <br></td></tr>
<tr><td class="diff-unchanged" > <br></td></tr>
<tr><td class="diff-changed-lines" >The <span class="diff-changed-words">*\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>zonemessages\]*</span> section is used to define various timezones around the world. Each mailbox can be assigned to a particular time zone, so that times and dates are announced relative to their local time. The time zones specified in this section also control the way in which times and dates are announced, such as reading the time of day in 24-hour format. <br></td></tr>
<tr><td class="diff-unchanged" > <br>h4. Voice Mail Contexts <br> <br></td></tr>
<tr><td class="diff-changed-lines" >After the <span class="diff-changed-words">*\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>general\]*</span> and <span class="diff-changed-words">*\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>zonemessages\]*</span> sections, any other bracketed section is a voice mail context. Within each context, you can define one or more mailbox. To define a mailbox, we set a mailbox number, a PIN, the mailbox owner's name, the primary email address, a secondary email address, and a list of mailbox options (separated by the pipe character), as shown below: <br></td></tr>
<tr><td class="diff-unchanged" >{code:lang=javascript}mailbox=>pin,full name,email address,short email address,mailbox options <br>{code} <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
<tr><td class="diff-unchanged" >vm-demo 6002 Bob Smith eastern 0 <br>5 voicemail users configured.{noformat} <br></td></tr>
<tr><td class="diff-changed-lines" >Now that we have mailboxes defined, let's add a priority to extensions *6001* and *6002* which will allow callers to leave voice mail in their respective mailboxes. We'll also add an extension *6500* to allow Alice and Bob to check their voicemail messages. Please modify your <span class="diff-changed-words">*\[<span class="diff-deleted-chars"style="color:#999;background-color:#fdd;text-decoration:line-through;">docs:</span>users\]*</span> context in *extensions.conf* to look like the following: <br></td></tr>
<tr><td class="diff-unchanged" > <br>{code:lang=javascript}[users] <br></td></tr>
<tr><td class="diff-snipped" >...<br></td></tr>
</table>
</div> <h4>Full Content</h4>
<div class="notificationGreySide">
<p>Now that we've covered the two main voice mail applications, let's look at the voicemail configuration. Voice mail options and mailboxes are configured in the <b>voicemail.conf</b> configuration file. This file has three major sections:</p>
<h4><a name="ConfiguringVoiceMailBoxes-The%5Cgeneral%5Csection"></a>The [general] section</h4>
<p>Near the top of <b>voicemail.conf</b>, you'll find the <b>[general]</b> section. This section of the configuration file controls the general aspects of the voicemail system, such as the maximum number of messages per mailbox, the maximum length of a voicemail message, and so forth. Feel free to look at the sample <b>voicemail.conf</b> file for more details about the various settings.</p>
<h4><a name="ConfiguringVoiceMailBoxes-The%5Czonemessages%5Csection"></a>The [zonemessages] section</h4>
<p>The <b>[zonemessages]</b> section is used to define various timezones around the world. Each mailbox can be assigned to a particular time zone, so that times and dates are announced relative to their local time. The time zones specified in this section also control the way in which times and dates are announced, such as reading the time of day in 24-hour format.</p>
<h4><a name="ConfiguringVoiceMailBoxes-VoiceMailContexts"></a>Voice Mail Contexts</h4>
<p>After the <b>[general]</b> and <b>[zonemessages]</b> sections, any other bracketed section is a voice mail context. Within each context, you can define one or more mailbox. To define a mailbox, we set a mailbox number, a PIN, the mailbox owner's name, the primary email address, a secondary email address, and a list of mailbox options (separated by the pipe character), as shown below:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[mailbox=>pin,full name,email address,short email address,mailbox options
]]></script>
</div></div>
<p>By way of explanation, the short email address is an email address that will receive shorter email notifications suitable for mobile devices such as cell phones and pagers. It will never receive attachments.</p>
<p>To add voice mail capabilities to extensions <b>6001</b> and <b>6002</b>, add these three lines to the bottom of <b>voicemail.conf</b>.</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[vm-demo]
6001 => 8762,Alice Jones,alice@example.com,alice2@example.com,attach=no|tz=central|maxmsg=10
6002 => 9271,Bob Smith,bob@example.com,bob2@example.com,attach=yes|tz=eastern]]></script>
</div></div>
<p>Now that we've defined the mailboxes, we can go into the Asterisk CLI and type <b>voicemail reload</b> to get Asterisk to reload the <b>voicemail.conf</b> file. We can also verify that the new mailboxes have been created by typing <b>voicemail show users</b>.</p>
<p></p>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>server*CLI> voicemail reload
Reloading voicemail configuration...
server*CLI> voicemail show users
Context Mbox User Zone NewMsg
default general New User 0
default 1234 Example Mailbox 0
other 1234 Company2 User 0
vm-demo 6001 Alice Jones central 0
vm-demo 6002 Bob Smith eastern 0
5 voicemail users configured.</pre>
</div></div>
<p>Now that we have mailboxes defined, let's add a priority to extensions <b>6001</b> and <b>6002</b> which will allow callers to leave voice mail in their respective mailboxes. We'll also add an extension <b>6500</b> to allow Alice and Bob to check their voicemail messages. Please modify your <b>[users]</b> context in <b>extensions.conf</b> to look like the following:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<script type="syntaxhighlighter" class="toolbar: false; theme: Confluence; brush: javascript; gutter: false"><![CDATA[[users]
exten => 6000,1,Answer(500)
exten => 6000,n,Playback(hello-world)
exten => 6000,n,Hangup()
exten => 6001,1,Dial(SIP/demo-alice,20)
exten => 6001,n,VoiceMail(6001@vm-demo,u)
exten => 6002,1,Dial(SIP/demo-bob,20)
exten => 6002,n,VoiceMail(6002@vm-demo,u)
exten => 6500,1,Answer(500)
exten => 6500,n,VoiceMailMain(@vm-demo)]]></script>
</div></div>
<p>Reload the dialplan by typing <b>dialplan reload</b> at the Asterisk CLI. You can then test the voice mail system by dialing from one phone to the other and waiting twenty seconds. You should then be connected to the voicemail system, where you can leave a message. You should also be able to dial extension <b>6500</b> to retrieve the voicemail message. When prompted, enter the mailbox number and PIN number of the mailbox.</p>
<p>While in the <b>VoiceMainMain()</b> application, you can also record the mailbox owner's name, unavailable greeting, and busy greeting by pressing 0 at the voicemail menu. Please record at least the name greeting for both Alice and Bob before continuing on to the next section.</p>
<p>Go into lots of detail about the voicemail interface? How to move between messages, move between folders, forward messages, etc?</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;">
<a href="https://wiki.asterisk.org/wiki/users/viewnotifications.action" class="grey">Change Notification Preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Configuring+Voice+Mail+Boxes">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/pages/diffpagesbyversion.action?pageId=4817425&revisedVersion=8&originalVersion=7">View Changes</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Configuring+Voice+Mail+Boxes?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>