One of the most important benefits of the Atlassian ecosystem is the power of integration opportunities. The difference between using one or two Atlassian applications is not merely the additional functionality you gain form the the second one but also the new dimensions deriving from the synergy.
This post demonstrates the power of integration and explores how Atlassian products can be connected with HipChat making it the central source of notifications and a platform of team collaboration.
Before you create integration
Consider what you need: global or room based integration? Global integration apply to all rooms in your HipChat group. Per-room integrations apply only to the rooms in which you install them.
- To install global integration, go to Group admin > Integrations. This takes you to the Find New page that lists available integrations.
- To install per-room integration, go to Group admin > Rooms and select the room. Then, click Integrations in the left menu bar.
Tool
|
Integration
|
Configuration
|
JIRA |
-
- Get notifications in your HipChat rooms about issues.
- Issue created
- Assignee updated
- Someone leaves a comment
- Issue transitioned to: ...
- Create a dedicated HipChat room from the issue you're working on and want to discuss with your team.
- Preview JIRA issues and service management requests directly in HipChat when someone on your team mentions them.
|
The JIRA and HipChat integration is packaged with JIRA 6.4 and later versions. For previous versions of JIRA or for the latest integration plugin go to the HipChat for JIRA integration plugin page and follow the installation instructions.
Before you start, make sure JIRA and HipChat server are behind the same firewall (integration uses both pull and push way). You can check the connection status between JIRA and HipChat (Connected, Limited, Not connected, Unknown).
Now you can link JIRA to HipChat
- Log in as a JIRA administrator
- Go to the JIRA administration console > Applications.
- Scroll down the page to the Integrations section and select HipChat.
- Select the link below Connect HipChat.
- Follow the instructions to link JIRA to your HipChat site.
- Once integrated, you can connect your JIRA projects to your HipChat rooms.
You can link JIRA projects with one or more HipChat rooms so that when issues are updated or created, messages are sent to the HipChat rooms that you specify.
- You must be a logged in as an Administrator or a Project Administrator.
- Choose Administration > Projects.
- Select a project.
- In the Project Administration menu, select HipChat Integration.
- Choose a HipChat room and select Add.
- Select the Issue Type, Priority, or select Advanced to enter a JIRA JQL Query.
- Select the actions that will send a notification to your room (issue created, assignee changed, new comments, and issue transitions).
- Select to notify users (using HipChat notifications) when a message is sent to the room.
Notify Users in This Room uses HipChat notifications (playing a sound, popups, and bouncing dock icon) to alert users of new messages sent from JIRA. This functionality is only available in the web and IOS clients.
- Changes are saved automatically, continue browsing your project to continue.
Private rooms
Private rooms in HipChat are by invitation only. In order to in connect JIRA to a private room in HipChat you will need to authorize HipChat from the HipChat Integration setup screen.
Once you have authorized JIRA, all of the private rooms that you are a member of will be displayed in the room selector drop-down menu. When your JIRA project and room are integrated, everyone in the private room will be able to see the notifications that are sent to that room.
Afterwards you can configure the following
-
Enable issue preview globally for all projects
This setting can be overridden for individual projects by users with Project Admin permissions.
- Enable issue preview for guest rooms
Enables issue links or issue key mentions to be displayed in guest rooms.
|
JIRA Software |
Same like JIRA (see above) |
No need any JIRA Software specific settings
Planning Poker (https://www.planningpoker.com/) for HipChat is coming soon, it will be a very cool addon.
|
JIRA Service Management |
Same like JIRA (see above) |
No need any JIRA Service Management specific settings |
Confluence |
- Space - Room level integration opportunities (the HipChat integration lets Confluence send the following notifications to your HipChat rooms)
- Page is created
- Page is updated
- Blog post is Created
- Who is online
- When you hover over a user mention or a byline it will show if the user is available in HipChat. Green, yellow and red icons indicate when someone is available, away or doesn't want to be disturbed.
|
|
Bamboo |
You get Bamboo notifications in your chat room for events such as:
- when a build passes or fails
- when you are assigned responsibility for a breaking build
- when a build you are responsible for has been fixed
- when a manual stage of a build is ready to be run
- when a deployment starts, and completes
...and many other notification events.
|
You can get Bamboo plan notifications in HipChat rooms:
- Specify the hipchat.api.url system property that is used when Bamboo is starting. The hipchat.api.url value must be set to the URL of the HipChat.
-
Set up plan notifications in Bamboo that use the 'HipChat' Recipient type.
|
Bitbucket Server |
The HipChat integration lets Bitbucket send the following notifications to your HipChat rooms
- Pull requests
- created
- commented
- merged
- declined
- Commits
|
- Select Administration Settings > HipChat integration
- Using HipChat, click the link below the Connect HipChat button, enter your HipChat URL, then click Connect HipChat.
- Log in to HipChat with an account that has admin rights.
- Click Install to finish installing the Bitbucket Server HipChat Addon.
- 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.
|
Bitbucket Cloud |
The HipChat integration lets Bitbucket send the following notifications to your HipChat rooms
- Pull requests
- created
- commented
- merged
- declined
- Commits
- Issues
- created
- updated
- commented
|
|
For further details
Please read the following documentations: