Configuring JIRA with HipChat

If your JIRA site has been configured with HipChat, you can:

• Generate a HipChat notification when an issue goes through a particular workflow transition. To do this, add a post function to the workflow transition you want to notify users about.
• Apply JQL criteria to a post function to fine tune when a notification is sent as a result of a workflow transition being executed.

Before you can configure HipChat notifications in JIRA, you need to configure JIRA with a HipChat API Auth Token of type Admin, which is generated through (and associated with) a specific HipChat account. This allows JIRA to send notifications to HipChat rooms associated with this HipChat account.

Generating a HipChat API Auth Token of type Admin requires a HipChat account with admin-level access.

To configure your HipChat API Auth Token in JIRA:

1. Visit the HipChat API Auth Token page to generate an admin-level token.
   A HipChat account with admin-level access is required to do this.
2. Log in as a user with the JIRA Administrators global permission.
3. Choose > System. Select Mail > HipChat Configuration to open the HipChat API Auth Token Configuration page.
   Keyboard shortcut: g + g + start typing hipchat configuration
   
4. Copy your HipChat API Auth Token and paste it into the Admin Token field.
5. Click the Save button.
   Please Note:
   
   • If you receive a message indicating that your HipChat configuration was saved successfully, you can proceed to add HipChat notifications to your workflow transition's post functions.
   • The HipChat rooms that JIRA has access to are those rooms configured through your admin-level HipChat account.