Integration with HipChat

First, install the HipChat plugin. In your Jenkins instance, go to Manage Jenkins > Manage Plugins > Available > and search for the HipChat plugin.

Restart the Jenkins instance.

Open another browser tab and navigate to your HipChat API url. For public/cloud HipChat, the URL is https://www.hipchat.com/account/api. For self-hosted/Datacenter HipChat, the URL will be https://YOURHIPCHATHOST/account/api

You will be prompted to log into HipChat if you haven’t already. Log in as the user you want to send HipChat notifications from. We recommend that you create a dedicated HipChat user for this, named e.g. "Jenkins."

Generate a new API token with the following permissions: Send Notification, View Room. You can put anything in the Label field, such as "Jenkins notifications." This is just to help you track in HipChat where the API token is used.

Select and copy the API token string.

In Jenkins, go to Manage Jenkins > Configure System, and scroll down to the section labeled "Global HipChat Notifier Settings."

For cloud HipChat, leave the server hostname set to api.hipchat.com. For self-hosted hipchat, the hostname should be the same one you used to access the web UI, e.g. "hipchat.mycompany.com."

Leave "Use v2 API" checked.

Click the "Add" button next to "Credentials," set the Kind to "Secret text," and paste your HipChat API token into the Secret field. In the ID field put something like "hipchat-api." After saving the credential, select it from the dropdown menu.

Enter the name of the room you want notifications to be sent to by default (you can override this on a per-job basis).

Put the name of the HipChat user you used to create the API token (e.g. Jenkins in our example) in the "Send As" field.

At this point if you click the "Test configuration" button you should see a test message appear in the HipChat room you specified.