mobile menu

Auto Send an Email

You are here
Auto send an email when a browser test has completed


This tutorial explains how to trigger an email automatically when a test has completed. This process uses the MCS event system in conjunction with the test Session ID.

Step 1: Configure SMTP Server

From the MCS main menu click the General Config link (fig 1). The SMTP settings will be at the bottom of the resulting page (fig 2).

Enter the SMTP details and use the test email settings button to confirm the settings are correct. Once that is confirmed click the Submit Changes button.

mcs general config

Fig 1: General Config link

smtp settings

Fig 2: Email SMTP Settings

Step 2: Create an Email Template

The email MCS sends will be based on a template. To configure an email template click on the Configure Events link in the MCS administration menu and then the Customize Email Templates link.

Enter a name for the new email template and click the Create button. The resulting page allows an email template to be created using standard text and MCS variables. The example below (fig 3) shows how a VoIP email might be compiled.

email template

Fig 3: Email template

Click the Save Template button when editing is complete.

Step 3: Setup an Event

Click the Configure Events link in the main MCS administration menu. On the next page enter a name for the new event and click the Create button.

Choose 'When a test is performed which meets certain criteria' from the drop down menu and check the 'With a specific Session ID' check box.

modify event

Fig 4: Modify event

Scroll down to the bottom of the event configuration page and do the following...

*Setting the Session ID will be covered below. This example is designed to pin point specific tests, not ALL tests. So, it's important to ensure the characters at the start of the session ID are unlikely to be replicated. In the example below, the event will fire for any test with a session ID that starts with VOIPPA_ (note the * that denotes a wildcard, meaning any characters can appear after VOIPPA_ and the event will fire.

configure event session ID and email

Fig 5: Email and SID settings

Step 4: Specifying a Session ID

The event in step 3 above has been set up to trigger for a session ID that starts with VOIPPA_. So, how is this achieved?

When a browser test is published in MCS it creates an HTML page, which contains test parameters.

Editing the page to add the session ID parameter is the key step. The image below (fig 6) shows the parameters for one of the default MCS VoIP tests.

voip test parameters

Fig 6: VoIP test parameter tags

The parameter required is <param name="sid" value="*VOIPRA_">. With this added to the test page the event configured will fire and an email will be sent.

This alone isn't much use. Creating a Session ID on a test by test basis can be done programatically and can be achieved with some basic JavaScript. This tutorial touches on some basics that will be required.

Step 5: Complete

If the browser test example above is run with the correct session ID then an email will be triggered.