Setting up HipChat integration

Owned by Lenny Emmerton
Last updated: Aug 24, 2016 by Keith Ferguson

Step by step guide

 

Overview

Elevator for JIRA sends 1:1 HipChat messages.  To do this Elevator for JIRA requires its own user to be created in your HipChat instance.  Once you create the user you generate an API token and configure Elevator for JIRA to authenticate with the generated user token.

Create a new user invite in HipChat

  • Log into your HipChat web portal and select Group admin

Please note

You must be an Administrator in HipChat

  • Once in Group Admin select Users form the top menu
  • Enable the Invite URL and copy the provided link
  • Paste this link 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 feilds with:
    • Your Full Name: Elevator for JIRA

    • Your Email: elevator@yourcompany.com

      Note

      The email address does not need to physically exist

    • Enter a password and store this password
    • Select Sign up

Create an API Token in HipChat

  • Once signed in, go to the user profile by selecting the User Iconon the far right
  • From the drop down select Profile
  • From the left hand side Account Settings menu select API Access
  • From this page enter a label and select the Scopes Send message and Send Notification and select Create
  • Copy the created Token

 

Inserting API Token into Elevator for Jira

  • Log into Jira, select Elevator in the main menu
  • On the far right next to New Roster select the admin cog
  • In the HipChat section
    • Tick Enable HipChat notifications
    • Api Token - Enter the API token that was copied from HipChat
    • HipChat API - Enter your Hipchat API location

Note

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

  • Select Save

 

Important

Once Save is selected Elevator for JIRA will test the API token and API location by sending a test message. If either are incorrect you will receive a failure notification.

 

 

 

 

Setting up users to receive HipChat notifications

Users simply need to have an account in HipChat and for the email address to align to their JIRA user account email address. If so escalations will populate their personal HipChat room.

 

Winning!

Now that HipChat is configured you're ready to roll!

Try escalating your first issue, and then you can look at more advanced features including: