Notifications

The Notifications menu is where you setup your notifications and triggers whenever an specific number or numbers are dialed out.

You can have notifications sent to Email, SMS, Clearly Cloud Chat and Text Messages sent to CIP phones.

Notifications menu will use the following variables:

• %%CALLID%% – Caller ID of the call.
• %%COMPANY%% – Company of the user that placed the call.
• %%DATE%% – Date the call was placed.
• %%DIALED%% – Dialed number.
• %%EXTNAM%% – Extension name of the user that placed the call.
• %%EXTNUM%% –  Extension number of the user that placed the call.
• %%LOCATION%% –  Realm or domain.
• %%TIME%% – Time of the call.
• %%TRUNK%% –  Trunk used by the call.

The Notifications menu has two main sections:

• Notifications – Notifications are the actual specific Notification such as SMS or Email and they link to 1 or more Trigger Rules.
• Trigger Rules – These are the actual rules to trigger a Notifications such as someone calling 911 and the actual notifications link to these rules.

Trigger Rules 

In this menu you can see the list of Trigger Rules created on your Clearly IP Cloud instance.

To setup a Notification, you need to first setup a Trigger Rule.

A Trigger Rule is where we define the number (literal) or group numbers (regular expression)  the system will be aware of in order to send a Notification.

To add a Trigger Rule click on the Add button

A new window will appear on which you need to enter the following information:

• Name: Name of the Rule
• Description: Description of the Rule
• Destination Number Regexp: The phone number or group of numbers (by using regular expressions) that when dialed, the system will trigger a notification.
• Caller Number Filter: The local extension number or group of local extensions (by using regular expressions) that when they dial the destination number(s) defined above, the system will trigger a notification.

Click on ‘Create’

Example

As an example we will create a Trigger Rule that will send a notification via email whenever any user whose local extension number begins with 502 dials 933.

Managing Trigger Rules

Remember that you can Edit, Delete (with previous confirmation), and search for a Trigger Rule. Also, when a Notification is using a Trigger Rule, we can test the Rule with the Test Rule Button.

Notifications

• In this menu you will see all the current notifications available in your Clearly IP Cloud instance.

To add a notification click on the Add button and enter or select the following information:

• Type: Here you can specify the type of notification you would like to get: Chat, Email, SMS, SIP Message (call to an extension or number).
• Trigger Rules:  Select the Trigger Rule to use for this notification. Use the arrows to move it from the Available column to the Selected column.
• From: This is the email address, or Caller ID (in case you select SMS) or extension in case you select Chat or SIP Message you would like to be displayed as the sender of the notification.
• To: This is the email address, or Caller ID (in case you select SMS) or extension in case you select Chat or SIP Message the notification will be sent to.
• Subject: This is the subject of the Notification. (Only used for Email)
• Body: This is the Body or main message for the notification.

Please notice that depending on the type of notification a template will be displayed to help you fill the right information.

Click on Create.

Notifications Templates

Here are the currently supported templates that will appear when creating a Notification.

• Email

• SMS
  • In the From field you can use the drop-down menu to select the DID you would like to use to send the notification from.

SIP Message

• Only works with phones that support receiving a SIP Text Message. CIP phones have been tested and verified to work. Other phones may work but you would have to verify they support SIP Messaging and configured to receive them.
• In the From field you can use the drop-down menu to select the extension you would like to use to send the notification from. A similar situation applies with the ‘To’ field.

Chat

• In the From field you can use the drop-down menu to select the extension you would like to use to send the notification from. A similar situation applies with the ‘To’ field.
• You can pick to send notifications to 1 or more Chat users and/or 1 or more Public Channel rooms. At this time we do not support sending notifications to Private Rooms.

Managing Notifications

Remember that you can edit, delete (with previous confirmation), and search for a notification.

Testing Trigger Rules

You can test a rule by pressing the Testing Rule button in the Trigger Rules menu.

Here is the example when testing a rule that will trigger a notification when someone dials 933 . A warning will be displayed letting you know that when testing, variables you might be using in a notification subject or body won’t be working and will be left as you entered it. In a real scenario, those variables will be replaced by a proper value.

Click on Send.

Here is how the email notification associated with this Triggering Rule would look like:

Example

Below is the implementation of setting up a  Notification that will send an Email and an SMS when someone dials 933.

Email:

• SMS:

This how an an SMS and an Email are received when using the Notifications module.