View Source

Step by step guide

We recommend you create a specific user for Elevator for JIRA in HipChat to create the required API Key. This negates the issue of individuals who create API Tokens leaving the company and closing their HipChat accounts.

Create a new user invite in HipChat

You must be an Administrator in HipChat

Log into your HipChat web portal https://{yourcompanyname}hipchat.com and select Group admin on the top main menu

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2016-08-23 at 11.44.17 PM.png

Once in Group Admin select Users form the top menu

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-10 at 7.38.16 AM.png

Enable the Invite URL and copy the provided link
Paste this Invite URL in a new browser window

Create a Elevator User Profile in HipChat

Add Elevator for Jira as a user, we suggest you enter the below fields with:

Your Full Name: Elevator for JIRA
Your Email: elevator@yourcompany.com
The email address does not need to physically exist
Enter a password and store this password
Select Sign up

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-10 at 8.13.10 AM.png

Create an API Token in HipChat

Once signed in, go to the user profile by selecting the User Iconon the far right and select Account Settings

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-10 at 7.57.49 AM.png

From the left hand side Account Settings menu select API Access

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-10 at 7.58.13 AM.png

From this page enter a label and select the Scopes Send message and Send Notification and select Create

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-10 at 8.04.00 AM.png

Copy the created Token ID

Notification Channel Setup

From the JIRA menu bar select the Rosters menu.

Elevator for JIRA Documentation > Setting up HipChat integration > CreateRoster_Rosters.gif

Return to your Notification Channels in JIRA by selecting:

The user must have JIRA administration access to setup Global Configuration

Select HipChat as a type and enter the API URL and select CREATE

If your HipChat instance is cloud based then you can use the default address.

Elevator for JIRA Documentation > Setting up HipChat integration > Screen Shot 2017-01-11 at 9.53.35 PM.png

Congratulations, you've now setup HipChat. Need to integrate slack, Email or a Webhook? Please see below.

Setting up individual users to receive HipChat notifications

Please see Setting up My Notifications

Setting up team rooms to receive HipChat notifications

Please see Setting up team Notifications

Elevator for JIRA Documentation > Setting up HipChat integration > Elevator_FA-LandscapeWithTag_RGB.gif