Use HipChat and Confluence together

Still need help?

The Atlassian Community is here for you.

Ask the community

HipChat is a group messaging and video chat app for team communication.

Connect a Confluence space to a HipChat room to get instant updates about changes in the space, send realtime notifications to the room, and share what you've been working on with your team.

Don't have HipChat yet? Sign up for free and start chatting right away.

Connect Confluence and HipChat

You’ll need to be a site admin with global permissions for both Confluence and HipChat to set up the initial connection between Confluence and your HipChat group. Go to  > General Configuration > HipChat Integration and choose Connect HipChat.

On this page:

Connect spaces to rooms

If you're a space admin, connect your space to a HipChat room by going to Space Tools > Integration > HipChat and selecting which rooms you'd like to connect. A space can be connected to as many HipChat rooms as you like, and a HipChat room can be connected to multiple spaces.

Send space notifications to HipChat

When choosing which rooms to connect, you can also choose which notifications you'd like to send to each room.

  1. Pick a room: choose a HipChat room to send notifications to. 
  2. Decide what to send: select the type of notifications to send to the room. 

Notifications appear in realtime, and clicking on them takes you straight to Confluence.

You can choose different notification settings for each space-room connection. A design team working on a specific project could choose to get updates from that project's space whenever a page is updated, so they can keep close track of its progress. From their team space, though, they might choose to be notified only when there’s a new a blog post, so they’re up to date on important team news but don't get interrupted by any other changes in that space.

Change the notification settings whenever you like by going to Space Tools > Integration > HipChat, and clicking on Edit Notifications next to the room name.


tip/resting Created with Sketch.

Permissions and restrictions

Want to keep something private? Don't worry, rooms are never notified about the creation or update of any content with view restrictions on it.

Get Confluence in your HipChat sidebar

Find content you've viewed or worked on in Confluence in your HipChat sidebar, so you can easily resume, share or discuss work with your team. Once a space has been linked to a room, you can find this in your sidebar either under the space name or, if you have multiple spaces linked to your room, under the name of your instance.

Select the name of your space or instance, then follow the prompts to authenticate your account. This will let you open up a Confluence glance in your sidebar. Switch tabs to view either all Updates from the space linked to that room, or My Work from across Confluence.

The My Work tab lets you filter all the content from Confluence that you've been Mentioned inRecently Worked onRecently Visited or Saved for later. Now, when you want to share an important piece of information with your team, ask them to review your work or collaborate with you, you can find and link them to relevant content directly from HipChat.

Need to chat? See from Confluence if someone's online on HipChat

Got questions about something someone else has worked on? Once your Confluence instance is linked to your HipChat group, you can hover over a user mention or a byline in Confluence to see if the user is available in HipChat. Green for available, yellow for away, or red for do not disturb.

Spice up your pages with HipChat emoticons

In the editor go to Insert > Emoticons to bring your pages to life with  emoticons.  You can also type them right into the editor like this (success) →  

All HipChat's default emoticons can be found here, along with any custom ones people in your organization have added. 

Create HipChat rooms from Confluence

Setting up a new team or project? Create a new HipChat room at the same time, through Confluence. If you're a space admin, go to Space Tools > Integration > HipChat and instead of selecting an existing room in the dropdown, type in the name of the new room you want to create and hit Add.

Invite users to HipChat from Confluence

If you're a global admin for both Confluence and HipChat, you can send users HipChat invites directly from Confluence. Go to  > General Configuration > HipChat Integration > Invite users to HipChat.

You'll need at least one space integrated with a room to see the Invite users link.

Last modified on Jun 26, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.