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.
ToolIntegration Configuration
JIRA
    • Get notifications in your HipChat rooms about issues.
      • Assignee updated
      • Someone leaves a comment
      • ...
    • Create a dedicated HipChat room from the issue you're working on and want to discuss with your team.
    • Preview JIRA issues and service desk 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

  1. Log in as a JIRA administrator
  2. Go to the JIRA administration console > Applications.
  3. Scroll down the page to the Integrations section and select HipChat.
  4. Select the link below Connect HipChat.
  5. Follow the instructions to link JIRA to your HipChat site.
  6. 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.

  1. You must be a logged in as an Administrator or a Project Administrator.
  2. Choose Administration > Projects. 
  3. Select a project.
  4. In the Project Administration menu, select HipChat Integration.
  5. Choose a HipChat room and select Add.
  6. Select the Issue Type, Priority, or select Advanced to enter a JIRA JQL Query.
  7. Select the actions that will send a notification to your room (issue created, assignee changed, new comments, and issue transitions).
  8. 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.
  9. 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

  • This setting can be overridden for individual projects by users with Project Admin permissions.
  • Enables issue links or issue key mentions to be displayed in guest rooms.
JIRA SoftwareSame 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 DeskSame like JIRA (see above)No need any JIRA Service Desk 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.
  • First your organisation's HipChat account needs to be connected to Confluence. It only takes a minute.

    • You'll need administrator permissions for your HipChat group to do this.

    • If you're a Confluence admin go to > General Configuration > HipChat Integration and click Connect HipChat to get started.

    • If you're a Space Admin you can go to Space Tools > Integration > HipChat to get started. 

      • Using the Documentation theme? If your space uses the Documentation theme go to Browse > Space Admin > HipChat.

    • You'll need to be logged in to HipChat as a Group Admin to complete the integration.

  • You'll need Space Admin permissions, and if you are connecting to private HipChat rooms, you will need to log in to HipChat on the integration screen.
  • To set up space notifications go to Space Tools > Integration > HipChat and add a room to the list
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:

  1. 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.
  2. Set up plan notifications in Bamboo that use the 'HipChat' Recipient type.
Bitbucket ServerThe HipChat integration lets Bitbucket send the following notifications to your HipChat rooms
  • Pull requests
    • created
    • commented
    • merged
    • declined
  • Commits
    • pushed
    • commented
  • 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 CloudThe HipChat integration lets Bitbucket send the following notifications to your HipChat rooms
  • Pull requests
    • created
    • commented
    • merged
    • declined
  • Commits
    • pushed
    • commented
  • Issues
    • created
    • updated
    • commented
  • To install or manage the integration from Bitbucket you need:

    • A HipChat account with access to the rooms which will receive notifications.
    • A Bitbucket account with one of the following:  
      • Individual account: you must own the repository you are trying to add the integration to you cannot just have administrator access.
      • Team: you must have administrator access to the team which owns the repository not just the repository you are trying to add.
  • Integration opportunities:
    • For a team, install from the team settings (Select Teams>Your team name then click Manage team) page, or a repository's Settings page.
    • For an individual account, install from a repository's Settings page
    • If you are using both team and individual account, do not forget to install the addon for teams and individuals too.
  • Steps of intagration:
    • Click HipChat integration.
    • Click Install integration and follow the onscreen instructions to install the integration.
    • Select the repository 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 you want to send notifications.
    • Select the notifications you want to receive.

/pages/viewpage.action?pageId=41091266


Posts

This page has no comments.