Skip to content

Atlassian HipChat

GitLab provides a way to send HipChat notifications upon a number of events, such as when a user pushes code, creates a branch or tag, adds a comment, and creates a merge request.

Setup

GitLab requires the use of a HipChat v2 API token to work. v1 tokens are not supported at this time. Note the differences between v1 and v2 tokens:

HipChat v1 API (legacy) supports "API Auth Tokens" in the Group API menu. A v1 token is allowed to send messages toanyroom.

HipChat v2 API has tokens that are can be created using the Integrations tab in the Group or Room admin page. By design, these are lightweight tokens that allow GitLab to send messages only tooneroom.

Complete these steps in HipChat

  1. Go to:https://admin.hipchat.com/admin
  2. Click on "Group Admin" -> "Integrations".
  3. Find "Build Your Own!" and click "Create".
  4. 选择desired room, name the integration "GitLab", and click "Create".
  5. In the "Send messages to this room by posting this URL" column, you should see a URL in the format:
https://api.hipchat.com/v2/room//notification?auth_token=

HipChat is now ready to accept messages from GitLab. Next, set up the HipChat service in GitLab.

Complete these steps in GitLab

  1. 导航到project you want to configure for notifications.
  2. 导航到Integrations page
  3. Click "HipChat".
  4. 选择"Active" checkbox.
  5. Insert thetokenfield from the URL into the令牌field on the Web page.
  6. Insert theroomfield from the URL into theRoomfield on the Web page.
  7. Save or optionally click "Test Settings".

故障排除

If you do not see notifications, make sure you are using a HipChat v2 API token, not a v1 token.

Note that the v2 token is tied to a specific room. If you want to be able to specify arbitrary rooms, you can create an API token for a specific user in HipChat under "Account settings" and "API access". Use theXXXvalue underauth_token=XXX.

Baidu
map