Notifications

From WHMCS Documentation

Revision as of 10:17, 23 October 2017 by Matt (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Overview

Notifications Home.png

WHMCS integrates with popular team communication apps including Slack and HipChat to allow you to be notified in real-time as events occur within WHMCS.

Using conditions, you can setup WHMCS to notify you in your Slack channels and HipChat rooms about the events that are important to you. Here are some examples.

  • Notify my Support channel/room when a new ticket is opened in the Support department with a High priority
  • Notify my Enterprise Support channel/room when a new ticket is opened or replied to by a customer belonging to the Enterprise Customers client group
  • Notify my Emergency channel/room when a new ticket is opened containing the words "Emergency" in the subject
  • Notify my Sales channel/room when a new order is placed with a value over $25
  • Notify my Billing channel/room when an invoice is paid by a customer belonging to the High Value client group
  • Notify my Customer Service channel/room when an order is placed for the product Business Hosting

Configuring Notification Providers

At the time of writing, WHMCS supports the following notification providers out of the box. Select one to learn more and for information on how to configure it.

You can add additional notification providers by creating a custom notification module. You can learn more about that here: https://developers.whmcs.com/notification-providers/

Creating a Notification Rule

Notifications are based around rules.

Each rule defines when a notification should be triggered through a combination of events and conditions.

To create a new rule, follow the steps below.

1. Click the Create New Notification Rule button.
2. Enter a name/description for your rule that will allow you to easily identify it again later.
3. Choose an Event Category from the available selector buttons.

Notifications Events Selector.png

4. Choose one or more events that should trigger the notification within the selected event category. Use Ctrl+click to select multiple ones.
5. Configure any conditions you want to use to restrict when the notification is triggered. The conditions available to you will vary based on the selected event category.

Notifications Conditions.png

By default all conditions default to unrestricted. To apply a condition to a rule, simply select or provide a value for a given condition. In the case of a free text based condition such as Subject, you are given the option of choosing from an Exact Match or Containing Match. In a monetary value condition such as Order Total, you have the option of specifying a Greater Than or Less Than match.

6. Configure the desired Notification Settings:

Notifications Notification Settings.png

i. Begin by choosing the desired notification provider for this rule. Here we have chosen HipChat.
ii. The other options here will depend upon the notification provider selected, but in the case of both HipChat and Slack, you will be asked to choose a Room/Channel for the notification to be posted to and be given the ability to override the default message with a custom one of your choosing.
iii. In the case of HipChat, you also have the ability to select whether the notification should trigger an alert for the user. When selected, this can include playing a sound, a mobile notification, and more based on an individual users notification settings.

Modifying a Notification Rule

Notifications Manage.png

To edit a notification, locate the notification rule you wish to edit and click the pencil icon.

This will open the rule configuration dialog where you can make your desired changes.

For more information on the configuration options that are available, please refer to the Creating a Notification Rule guide.

Duplicating a Notification Rule

Notifications Manage.png

To duplicate a notification, locate the notification rule you wish to copy and click the copy icon (indicated by two files).

This will open the rule configuration dialog where you can customise the rule and then click the Duplicate button to complete the process.

For more information on the configuration options that are available, please refer to the Creating a Notification Rule guide.

Enabling/Disabling a Notification Rule

Notifications Manage.png

The current status of each notification rule is indicated within the Notification Rules table by an on/off slider.

To toggle the status of a notification, simply click the slide toggle for the desired notification rule.

Deleting a Notification Rule

Notifications Manage.png

To delete a notification, locate the notification rule you wish to edit and click the trash can icon.

You will be asked to confirm you are sure you want to delete the rule before it is removed.

Please note that a rule cannot be restored after it has been deleted so if you may want to re-use the rule in future, we recommend disabling the rule instead of deleting it.

Hooks

Using hooks, it is possible to implement more complex conditional logic than is possible with the conditions available via the UI.

Documentation coming soon.

Adding a Custom Notification Provider

You can add additional notification providers that notification rules can use by creating a custom notification module. You can learn more about that here: https://developers.whmcs.com/notification-providers/