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-60701 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 mechanism is not reliable, because there is no spooling implemented. Currently, there will be one transmission attempt per email.

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. No email-body is transmitted. 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 Voicemail As Email Attachment

Emails won't carry a voicemail attachment 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, modify the line

    <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. From on Windows XP SP2 the Mediaplayer will contain the required codecs.

The wave files will be streamed into an email on-demand, without ever being physically present on the mass-storage.

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.