Howto:Send Email MWI Notification From The innovaphone Voicemail

Applies To

This information applies to

Note: The following information relates to an experimental functionality. The required firmware mentioned in this article originates from the ongoing development path and is not meant for production environments.

• innovaphone PBX, Build 07-60700 and later
• innovaphone Voicemail, Build 07-60046 and later

To obtain these builds, please have a look into the download section within the "unofficial builds/Firmware6" area.

More Information

Email notifications about newly received voicemails can be sent towards the owner of a voicebox. The destination email address is to be taken from a file, that is to be located within the ../personal directory of a voicebox.

Such an email currently and only consists of a subject "You have received a new voicemail from: xxx", where xxx stands for the number of the calling party. There is experimental functionality available to attach a voicemail as a wave file to an email.

The email will be sent by means of the Simple Mail Transfer Protocol (SMTP).

As SMTP Authentication mechanisms are supported (as of the writing of this arcticle): LOGIN and CRAM-MD5

Installation

Install the above mentioned voicemail build as usual.

• Just take note of the newly distributed file email.xml.
• Ensure that the IP configuration (Default Gateway, DNS server) is appropriate.

Provisioning Of Destination Email Addresses

During the writing of this document the email address must be taken from the mass storage. The destination email address must be written into a file.

Provisioning of a user's email address

• Within a text editor open up a new file.
• Enter the user's email address, e.g.: pbxuser@mycompany.com
• Save the file as ...yyy/personal/mail.txt, where yyy stands for the directory name of the user's voicebox.

Repeat these steps for each voicebox.

Configure the SMTP Agent

By default the email will be sent with the sender- and destination- email address being identical. In addition will the email be sent alike a Mail Transfer Agent (MTA) does.

You can configure the content of the above mentioned file email.xml, in order to provide a different sender email address.

You can also control that emails are to be sent alike a Mail User Agent (MUA) does, or in other words: alike a regular email SMTP client does.

Open up the file email.xml within a text editor.

• In order to modify the sender email address, modify the line

    <assign out="$from" value="$to"/>

into e.g.

    <assign out="$from" value="voicemail@mycompany.com"/>

MTA-to-MTA communication may fail, depending on policies implemented within the receiving MTA. Therefore, it is desirable to turn our sending MTA into a simple MUA. That is, emails are to be sent via an SMTP provider server. Such a server is often termed as an Outgoing SMTP Server.

Open up the file email.xml within a text editor.

To configure an outgoing SMTP server, modify the lines

    <assign out="$server" value=""/>
    <assign out="$user" value=""/>
    <assign out="$password" value=""/>

into e.g.

    <assign out="$server" value="smtpserver.myprovider.com"/>
    <assign out="$user" value="myuser"/>
    <assign out="$password" value="mypassword"/>

Send Voicemai As Email Attachment

Emails won't carry a voicemail by default. The file email.xml can be edited, in order to send voicemails as wave files together with the notification email.

Open up the file email.xml within a text editor.

    <assign out="$file" value=""/>

into

    <assign out="$file" value="$vm"/>

The wave files will inform about themselves as to contain a-law-, respectively u-law content.

Testing

• Call a user with a CFU into his/her voicebox.
• Leave a voicemail, tear down (on-hook) the call.
• The owner of the voicebox should now have received an email.

Troubleshooting

Before contacting the support, you are asked to create a trace file covering the transmission attempt for an email.

The following lines in the configuration must be changed manually, from:

config change DNS0
config change SMTP0

into

config change DNS0 /trace
config change SMTP0 /trace

Activate the trace checkmark at the affected voicemail object. In addition should the voicemail object's trace flags be set to the value 59 alike: http://192.168.0.1/drive/CF0/vm.xml?$_trace=59.