Courseware:IT Plus - The Voicemail app
(Redirected from IT Plus - The Voicemail app)
This book explains how to set up and use the voicemail app
Preparation
If you don't have an AP running on the SSD of your IP411LEFT, please set up an Application Platform as described in the book. So don't proceed if you don't have an AP running on your IP411LEFT.
As we start we prepared a new start configuration for you. As a result, please load a new configuration onto your devices:
This book also has a start configuration for your AP. So don't forget to click on the 
Load initial lesson configuration to your Application Platform
button once it appears. This may take a while, so bear with us and keep trying 
Please reset the IP232 to factory defaults as it should not receive any configuration from devices. The IP232 will then register with our PSTN simulation.
Upload new configuration to your Devices
This book also has a start configuration for your AP. So don't forget to click on the Load initial lesson configuration to your Application Platform button once it appears. This may take a while, so bear with us and keep trying Please reset the IP232 to factory defaults as it should not receive any configuration from devices. The IP232 will then register with our PSTN simulation.To log into myApps use ckl and ip411 as password.
Use this address: https://hq-dvl-ckl2.training.innovaphone.com
Quick facts about the voicemail
What is the Voicemail app?
The voicemail app allows you to record and manage voicemail messages for your users or groups. You can receive visual notifications of messages in myApps.
How can I use the app?
To use the app, you must give your users permission and assign them a voicemail license, which is included in the UC license. You can do this using the Templates PBX Manager plugin.
Does the user need the voicemail app in order to use the voicemail?
No, he does not. The user can configure his voicemail box (e.g. personal greeting, PIN) by calling his voicemail box directly. A voice prompt guides the user through the audio menu.
Can I customize the standard voicemail?
The Voicemail PBX object includes an XML script interpreter that allows you to run any XML script when the object is called.
Download in different languages
The voicemail app is available in several languages 
as listed on our website. They are technically the same, but they differ in the language of the voice prompts.
To install the voicemail app (and to see which languages are available), open the PBX Manager and then the app installer plugin. Then follow the steps below: If your app installer only shows an empty page, please refresh your myApps session with F5 and try again.
as listed on our website. They are technically the same, but they differ in the language of the voice prompts. To install the voicemail app (and to see which languages are available), open the PBX Manager and then the app installer plugin. Then follow the steps below:- Search for voicemail in the upper right corner
- Please open the English voicemail (Voicemail_en) - (Only the English voicemail is listed in the moodle app store. This is on purpose because the config checker only works with the English voicemail)
- Install the version marked as srTraining
- After the Install, please close the PBX Manager
voicemail in the upper right corner If your app installer only shows an empty page, please refresh your myApps session with F5 and try again.Configuration
To set up the voicemail app, you must first assign it a free number in your dialing plan. This number will be used as a prefix for all voicemail numbers for your users. For example, if you assign the number 8 to your voicemail app and you have a user with extension 11, his voicemail number will be 811. Only voicemails received on this number will appear in that user's voicemail app.
When you reopen the PBX Manager, you will find a new PBX Manager plugin named AP voicemail_en. Open the plugin and then open the voicemail app. Before we can use voicemail, we need to configure it. The following configuration options are available:
AP voicemail_en. Open the plugin and then open 
. Open the plugin and then open the voicemail app. Before we can use voicemail, we need to configure it. The following configuration options are available:
Before we can use voicemail, we need to configure it. The following configuration options are available:- Name: The name of the Voicemail App. It must be unique in the system. It will be shown in myApps and should have an intuitive name (e.g. Voicemail En). Its value is preconfigured by Install, but can be changed to suit customer requirements.
- SIP: This has no relevance to the user or administrator. It is only used for internal PBX communication. You can use the preconfigured value, but keep in mind that it must be unique in the system.
- Number: Like the other values, it must be unique and is used as a prefix for a user's personal voicemail number as described above.
- PBX: The name of the PBX on which the voicemail will run. In a single-PBX system, this is always the name of your PBX.
- Node: The dial plan node where the voicemail number should reside. In a flat numbering space, it is root.
- default PIN: You can configure the default PIN. If not configured the default PIN for all users is 8765. For security reasons, we recommend that you change this in a productive system.
- email notifications: This is a global parameter that allows any user to receive voicemail as email. The voicemail app uses the SMTP parameter you configured during the install.
- custom: checked if you want to provide your own (custom) voicemail script.
with the following parameters:- Name: Voicemail en
- SIP: voicemail-en
- Number: 8
- PBX: hq
- Node: root
- default PIN: 123456
- email notifications: On
- custom: Off
The default PIN length is 4 digits. You can change the length of the default PIN to whatever you want. This will also affect the personal PIN, which will be the same length as the default PIN.Further settings
Access credentials
In the Settings section of the Voicemail PBX Manager plugin, you can 
of the Voicemail PBX Manager plugin, you can configure a username and password that will be used to retrieve voicemail prompts and to save and retrieve voicemails. Any change to the credentials is pushed to the voicemail objects and to the AP's web server, so both sides use the same credentials and a mismatch is prevented.
that will be used to retrieve voicemail prompts and to save and retrieve voicemails. Any change to the credentials is pushed to the voicemail objects and to the AP's web server, so both sides use the same credentials and a mismatch is prevented. To ensure this consistency, do not configure the HTTP authentication on the voicemail PBX object itself, but use the PBX Manager plugin.
itself, but use the PBX Manager plugin.Automatic deletion
You can configure an automatic deletion of voicemails after x days to prevent your database from filling up to the point where your AP stops booting. This feature is disabled by default.
an automatic deletion of voicemails after x days to prevent your database from filling up to the point where your AP stops booting. This feature is disabled by default.
after x days to prevent your database from filling up to the point where your AP stops booting. This feature is disabled by default.Encryption key
You can configure an encryption key on the Voicemail PBX object in the advanced UI. This key is used to encrypt voicemail files in the voicemail database. If someone exports the database, they cannot listen to the voicemail without the key.
an encryption key on the Voicemail PBX object in the advanced UI. This key is used to encrypt voicemail files in the voicemail database. If someone exports the database, they cannot listen to the voicemail without the key.
on the Voicemail PBX object in the advanced UI. This key is used to encrypt voicemail files in the voicemail database. If someone exports the database, they cannot listen to the voicemail without the key.However, if you change the key, recorded messages are no longer available. So be careful when changing the encryption key. We recommend leaving it empty unless you receive a request from a customer.
Trying it
(All Apps area).
- Your own voicemail number which can be dialed by pressing the green handset icon.
- You can take a look or change your own PIN. Note that the length of the PIN is determined by the length of the default PIN.
- You can set a call forwarding to your voicemail directly from the voicemail app. You don't need to go through the Phone/Softphone app or your profile.
Enabling call forwarding from the voicemail application will overwrite an existing call forwarding of the same type. Administrative forwards are not affected. An existing call forwarding to your own voicemail is only read when you start the application. This means that there is no live update to the voicemail app if you set the call forwarding in a different way. So let's try it out, you can set a CFU to your voicemail box and call (11) from Jane's IP112. The call will be forwarded to your voicemail.
and call (11) from Jane's IP112. The call will be forwarded to your voicemail.When you want to listen to your voicemail, you have the following options.
- You can call 811 from your softphone app. You have to enter your PIN to access your voicemail box.
- You can also listen to your voicemail on your PC using your myApps voicemail app.
- You can log into your mail account and listen to the voicemail you received as an email notification. This only works out of the box if you specified your mail server during the install, which is not the case in our setup. We will take care of this in the next chapter.
The E-mail Plugin
To receive the voicemail as an email notification, we need to set up an SMTP connection to a mail server. If you have already done this step during the install, you are lucky, because you do not need to repeat the configuration.
Open the PBX Manager and the Email plugin to add an email account. Configure the following parameters.
Call yourself (11) again from Jane's phone and leave a voicemail.
Open the PBX Manager and the Email plugin to add an email account. Configure 
Configure the following parameters.
- SMTP server: Enter the address of your mail server
- training-mail.innovaphone.com:587
- Email address: The FROM address of the E-mail
- dvl-ckl2@class.local
- User name: For the authentication at the mail server
- dvl-ckl2@class.local
- Password: For the authentication at the mail server
- ckl-pw
- Sender's name: Enter the name that you want to appear as the sender
- Voicemail
Click OK to save the configuration. You will immediately receive a test email from the email plugin to verify that your configuration works.
Call yourself (11) again from Jane's phone and leave a voicemail.To see if you successfully receive the voicemail as mail, log into our mail server:
username: dvl-ckl2@class.local
password: ckl-pw
MWI function key
You can also receive notification of a new voicemail on your phone. If configured correctly, an LED on the phone will indicate that a new voicemail is available.
We will configure the MWI key directly on the advanced UI of the IP111. Open the Devices app, open the IP111 AdminUI, and then go to Phone/User-1/Function -Keys. To test it, set a CFU to 8 through the phone UI of John Does IP111 and enable it. Afterwards call John Doe (14) from Jane Doe (IP112). You will be able to leave a voicemail.
We will configure the MWI key directly on the advanced UI of the IP111. Open the Devices app, open the IP111 AdminUI, and then go to Phone/User-1/Function -Keys.
- Select any key from 1 to 8.
- Select the type Message Waiting
- Press Add
A new Window will appear that allows you define the MWI key.
define the MWI key.
- Configure the text of the Idle state to no new message
- Configure the text of the active state to new voicemail, set the letter icon and the LED should blink.
- Configure the Number 8 and tick the Append Own Number option.
- Press OK
To test it, set a CFU to 8 through the phone UI of John Does IP111 and enable it. Afterwards call John Doe (14) from Jane Doe (IP112). You will be able to leave a voicemail.Voila, the MWI key will be blinking.
The voicemail group app
Innovaphone offers the option to set up a group voice mailbox which can be shared by several users. All group members have the possibility to listen to, download or delete all voicemails in this shared group.
For a detailed description of how to set up a group voicemail, please refer to 
the step-by-step guide in our wiki.
the step-by-step guide in our wiki.Call from external to "global" voicebox
In this chapter we want to test calls from externally so please set up a SIP trunk as described.
Use the Trunks PBX Manager plugin to create a trunk object named Afterwards please create a SIP trunk connection on your IP411LEFT (Default SIP Trunk) with these parameters:
- Country Code:
+49
- Connection type:
DDI
- International number
+496213428231
- Lowest extension:
0
- Number mappings:
+4962134282310 ->0 +4962134282311 ->11 +4962134282312 ->12 +4962134282313 ->13 +4962134282314 ->14
- User:
DDI49.621.3428231
- Password:
pw123
- Protocol:
TCP
- Domain:
siptrunk.class.local
- Media Relay:
on
set the Busy or No answer destination in the PBX Manager Trunks plugin to a group voicemail object.
in the PBX Manager Trunks plugin to a group voicemail object. You can try this by redirecting the call to your personal voicebox, so configure 812 as destination for Busy and No answer. If not already done, please remove the CFU from your user object. Afterwards call 004962134282311 from your IP232 and let it ring until the call goes to your voicemail box. Of course the destination of such a forward can also be a group voicemail, but for simplicity's sake we have used your personal voicemail as an example.