HipChat notifications

What kind of notifications can I get?

The HipChat integration lets Stash send the following notifications to your HipChat rooms:

• Pull requests—when they are created, commented, merged, and declined
• Commits—when they are pushed and commented

Here's an example of what you might see (from an Atlassian HipChat room):

Install and configure the HipChat for Stash integration

To enable Stash to send notifications in HipChat you must connect Stash to your HipChat instance. In order to do this you need administration privileges for your Stash instance and for HipChat.

To integrate Stash and HipChat

1. Select Administration Settings > HipChat integration
2. If using HipChat Cloud, click the Connect HipChat button, which takes you to HipChat.com sign up page.
   If using HipChat Server, click the link below the Connect HipChat button, enter your HipChat server URL, then click Connect HipChat.
3. Log in to HipChat with an account that has admin rights. 
4. Click Install to finish installing the Stash HipChat Addon.
5. Select the repository that you want to send notifications from, and the HipChat room where you want the notifications to appear.
   • You can choose multiple rooms to receive notifications from a repository but must add each connection separately. 
   • Repeat this process for all the repositories where you want to send notifications.

In HipChat, you will see a notification in your room telling you that notifications were enabled.

Enable HipChat notifications for a repository

Once HipChat and Stash are integrated, you can enable and disable HipChat notifications for a particular repo by going to Settings > HipChat. You must have admin privileges for the project or repository you want to enable notifications for.

Initially, you will need to click the Log in to HipChat button to connect your Stash and HipChat user accounts. If you don't see the Log in to HipChat button you will need to talk to your Stash administrator and get them to install the integration first.

Now you can add room links between your repository and rooms in HipChat. Search for the room and press Add to get things going.

You can change the notification types by unticking some of the checkboxes.

I'm already using the old HipChat hook

There is a previous integration for Stash and HipChat which has been deprecated. It will continue working until Stash version 4.0. However, you are encouraged to upgrade to the latest version.

Once you are ready to setup the new integration make sure you disable all your configured old integrations.

1. Go to each repository that has the old hook configured.
2. Click Disabled to disable the old integration.
    
3. Setup the new integration by following the steps on this page