HipChat Integration Notifications / HipChat Integration

The StatusDashboard HipChat integration allows you to automatically post messages to your organization's HipChat rooms from StatusDashboard.  The HipChat integration settings can be accessed by navigating to Notifications > HipChat and then selecting the Options menu in the upper right.

The HipChat integration has the following functionality:

Events

Post messages to your organization's HipChat rooms, with links to your dashboard and event information, whenever events are created or updated.

Activity Log

Post the activity log in real time to your organization's HipChat rooms.


Activating the HipChat Integration

The HipChat integration may be enabled/disabled by navigating to Notifications > HipChat > Options > Enable/Disable and changing the toggle button. When this option is disabled, the option to post HipChat messages when creating or updating events will not be available.

In order to use the StatusDashboard HipChat integration, you must first obtain a HipChat API token which will authorize StatusDashboard to post messages to one or more of your HipChat rooms. To obtain a HipChat API token, login to your HipChat account and create a HipChat user for StatusDashboard. Then create a new API token with access to send notifications.  Once you have a valid HipChat API token, enter it into your StatusDashboard HipChat configuration by navigating to Notifications > HipChat > Options > API Token.

Optional Configuration Options

Option

Path

Description

HipChat Content

Notifications > HipChat > Options > HipChat Content

By default, all HipChat messages posted to your rooms about events will include a direct link on your dashboard to the event details page. You also have the option of including additional information in the HipChat message by configuring the options below. These options will be the default settings when events are created and will persist with the event once set (although you can change these settings on the event at any time).

Include Event Details

When enabled, all current event details will be included in the HipChat message that is posted to a room when an event is created or updated.

HipChat Message

An optional message that you would like to accompany HipChat messages sent to your rooms when events are created or updated.

Color

The background color that will be used when the event information is posted to your HipChat room.

Room Add

Notifications > HipChat > Options > room Add

Manually add a HipChat room to StatusDashboard. You must include the HipChat room Name and HipChat room ID when adding a room. If you have many HipChat rooms to add, it is preferable to use the import option (see Room List).

Room List

Notifications > HipChat > Options > Room List

View, import or delete HipChat rooms. Any HipChat rooms that are shown in this list will also be available for posting messages to when creating or updating events. Once a valid HipChat API token has been entered, you will also see a download icon, which when clicked, will import all current HipChat rooms from your HipChat account.

Send Test HipChat Message

Notifications > HipChat > Options > Send Test HipChat Message

Once you have added a valid HipChat API token and added or imported HipChat rooms, use this option to post a test message to one of your HipChat rooms to validate your settings.


Source IP Addresses

IP addresses from which we will access the HipChat API are listed in our public StatusDashboard configuration file.  This file is updated whenever our IP addresses change.


Required Permissions Role: Administrator or Notifications