Introduction

The mail and SMS plugins enable users to receive alarm and status message over email or via message on their mobile phones. The mail plugin needs access to an SMTP server which in turn will require internet access. The SMS plugins also require internet access because these use cloud-based services to deliver the SMS messages.

At the moment only two SMS providers are supported, both offer international messaging but one is more cost effective for the UK and other for the US.

Contents

Mail Plugin

The Mail Plugin enables alarms and status updates to be sent as email alerts to external devices. To include this plugin in a Witness system:

1. Enable the Config Function, select Mail Plugin under the Integration Configurations folder, in the Configuration Tree then select Edit in the Configuration Panel to configure the email options:
   
   

   Open

   

   
   Enable Plugin: Select to toggle the plugin on and off.

   Priority: Define the minimum priority of alarm that sends off an alert.

   Name: The name of the plugin.

   Host: The server host for the outgoing email account.

   Port: The port for the outgoing email account.

   Use TLS: Transport Layer Security is a cryptographic protocol designed to provide communications security over a computer network. This must be selected when sending an email to or from an Office365 account.

   Send Timeout (s): The Send timeout period.

   User Name: The username for the outgoing email account.

   Password: The password for the outgoing email account.

   From: The outgoing email account.

   To: The receiving email account or accounts. The user can add multiple email addresses that must separated with a comma or semicolon.

   Send Stat Updates: Select to include carriageway status updates in the email alerts. Specifically, any change to a queue status or an empty carriageway status.

2. Select Save.
   
   

   Open

   

    

3. Select Test Email in order to check that the plugin has been correctly configured and is now functional.
   
   

    

4. A test email should arrive shortly in the receiving inbox.
   
   

    

5. The receiving inbox will now receive an email alert for every alarm equal to or greater than the designated priority.
   
   

SMS

To include this plugin for Witness:

1. Enable the Config Function, select SMS Plugin under the Integration Configurations folder, in the Configuration Tree, then select Edit in the Configuration Panel to configure the text message options:
   
   

    

   Enabled: Select to enable text message notifications.

   Name: The name of the plugin.

   Provider:

BulkSMS: A UK based provider.

TextMarketer: A US based provider.

SMS Providers

Witness requires a third-party to support SMS integration, and it is necessary to choose and sign up for an SMS provider. There will be an external cost attached to this. Currently, two SMS providers are integrated into Witness:

BulkSMS

https://www.bulksms.com/products/sms-api.htm

According to BulkSMS, their SMS provider can:

• Review "detailed reporting of all sent and received SMS messages."

• "Build scalable solutions easily."

• "Enable Sender IDs."

• "Design software to interact and integrate with our system."

• "Send messages using Unicode character sets."

• Utilise "2-way messaging both locally and internationally."

TextMarketer

https://www.textmarketer.co.uk/

According to TextMarketer, their SMS provider offers:

• "No set up fee, monthly fee or contracts - just powerful, affordable simple SMS."

• "Extremely low prices and free unlimited UK support for you and your customers."

• "High quality direct Tier 1 network connections."

• "Quick and simple" integration - "you'll be up and running in minutes."

Related Information