New to HipChat: Connect dialogs

Reading Time: 2 minutes

We are proud to announce that the HipChat UI is now extensible for add-on developers. Powered by Atlassian Connect, you can now customise your HipChat experience by surfacing arbitrary HTML in modal dialogs.

Dialogs can be opened from links sent in chat messages, which allows users to experience rich, interactive, context-aware information without leaving the HipChat web client. Great examples include opening calendar invite details or information on why your CI test suite just failed. Dialogs are available to all HipChat add-ons, which can be kept private for your team only, or distributed to thousands of others using the Atlassian Marketplace. The availability of dialogs is just the first step in the road towards extensibility within the HipChat client.

Raise your first HipChat dialog in a matter of minutes by following our HipChat dialogs documentation.

What does a HipChat dialog look like?

Here are two examples of internally developed dialogs.

I want it! How do I raise dialogs?

A super brief summary: post a link marked up with a data-target="dialog" attribute and with its href pointing to your web service, then in the HTML that you serve at that URL load a specified JS file. When users of the web client click the link they will see it as a dialog.


<a href="https://example.com/mydialog.html" data-target="dialog">Click me!</a>

Read more in our HipChat dialogs documentation.

If you’ve ever used dialogs in JIRA or Confluence then you already know a lot about how they work in HipChat.

What else is coming?

Right now, Connect dialogs are available only in the web client, and they will eventually make their way into other desktop clients. Users of clients that do not support dialogs will see your content in their web browsers, and when non-web clients begin supporting dialogs then users will simply see your dialogs inside these clients without you having to do any further work.

Build something amazing with HipChat dialogs.