HipChat is fully integrated with Uptime to allow you to push alerts to their platform, and we have worked together to make the integration seamless. To get started, you will first need to setup a HipChat account at https://www.hipchat.com, or use your custom HipChat URL if needed .
In order to activate the integration of HipChat within your Uptime account, you will go to Alerting>Push Notifications then choose HipChat as the provider type when adding a new push notifications profile.
The following describes the fields shown when configuring HipChat within your Uptime account:
- Token: This will be obtained from HipChat. Please review the Obtaining HipChat API Tokens section below for further documentation.
- Room: Enter a single HipChat room you desire to send alerts to. If left blank, alerts will be sent to all available rooms within your HipChat account.
- Server: Enter your server if you’re using a custom URL for your HipChat account.
- Alias: The reference name you desire to assign to your HipChat profile. It can assist you with organizing multiple provider profiles within your Uptime account.
*Once you've configured your HipChat profile, you will need to assign the profile to a contact group located under Alerting>Contacts. The profile is assigned at the Push Notifications field within the contact group.
Obtaining HipChat API Tokens
Listed below is documentation on how to obtain the API tokens from HipChat:
API Version 1- If your HipChat account is using API version 1, then you will go to http://yoururl.hipchat.com/admin/api to create and view your API tokens. For API Version 1, you will need to either create an Admin token, or use a regular token and specify the room name exactly.
API Version 2- If your HipChat account is using API version 2, then you will go to http://yoururl.hipchat.com/account/api and create your token with the following scopes:
- Send Message
- Send Notification
- View Group
- View Room