Recipe overview

This recipe provides step-by-step instructions on building a self-service form in Confluence that can be used to run a report when needed to monitor public HipChat rooms for references to a sensitive term, such as conversations that may be discussing pending merger or acquisition talks.

This recipe utilizes the following items:

The Run macro of the Run Self-Service Reports for Confluence add-on which runs the provides the self-service form used to solicit the term to monitor.
The CLI macro of the Run CLI Actions in Confluence add-on, along with the HipChat Command Line Interface (CLI) add-on, to retrieve the public HipChat room references to the specified term with its output directed to a CSV file.
The CSV macro of the Advanced Tables for Confluence add-on to present the HipChat CLI output in a table.
The Macro Security for Confluence add-on to safeguard the self-service form by ensuring that only Administrators can use the Run macro.

It will take you approximately 14-15 minutes to complete this recipe.

Note that an Intermediate version of this recipe is also available: How to Monitor Language in Public Chat Rooms (Intermediate)

Recipe level

Ingredients

Ingredients for Bonus Tip

Preparation

Install the latest downloadable HipChat CLI Client on your computer, following all of the /wiki/spaces/HCLI/pages/70353210 including the steps marked optional.
Configure a profile which Run CLI Actions for Confluence will use to connect to your HipChat instance and make sure it references an API Access Token of a HipChat user who has access to all of the public rooms you wish to monitor.
Create rooms in HipChat for your team, if you have not done so already.
Open a command window you'll use to execute CLI commands.