59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
---
|
|
stage: Create
|
|
group: Ecosystem
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# 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 to *any* room.
|
|
|
|
HipChat v2 API has tokens that are can be created using the Integrations tab
|
|
in the Group or Room administration page. By design, these are lightweight tokens that
|
|
allow GitLab to send messages only to *one* room.
|
|
|
|
### Complete these steps in HipChat
|
|
|
|
1. Go to: `https://admin.hipchat.com/admin`
|
|
1. Click on "Group Admin" -> "Integrations".
|
|
1. Find "Build Your Own!" and click "Create".
|
|
1. Select the desired room, name the integration "GitLab", and click "Create".
|
|
1. In the "Send messages to this room by posting this URL" column, you should
|
|
see a URL in the format:
|
|
|
|
```plaintext
|
|
https://api.hipchat.com/v2/room/<room>/notification?auth_token=<token>
|
|
```
|
|
|
|
HipChat is now ready to accept messages from GitLab. Next, set up the HipChat
|
|
service in GitLab.
|
|
|
|
### Complete these steps in GitLab
|
|
|
|
1. Navigate to the project you want to configure for notifications.
|
|
1. Navigate to the [Integrations page](overview.md#accessing-integrations)
|
|
1. Click "HipChat".
|
|
1. Ensure that the **Active** toggle is enabled.
|
|
1. Insert the `token` field from the URL into the `Token` field on the Web page.
|
|
1. Insert the `room` field from the URL into the `Room` field on the Web page.
|
|
1. Save or optionally click "Test Settings".
|
|
|
|
## Troubleshooting
|
|
|
|
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 the `XXX` value under
|
|
`auth_token=XXX`.
|