kanboard_ynh/sources/doc/hipchat.markdown

Hipchat integration
===================

You can send notifications to Hipchat for all projects or only for specific projects.

- To send notifications for all projects, go to **Settings > Integrations > Hipchat**
- To send notifications for only some projects, go to **Project settings > Integrations > Hipchat**

Each project can send notifications to a separate room.

Send notifications to a room
-----------------------------

Example of notifications:

![Hipchat notification](http://kanboard.net/screenshots/documentation/hipchat-notification.png)

This feature use the room notification token system of Hipchat.

### Hipchat configuration

![Hipchat room token](http://kanboard.net/screenshots/documentation/hipchat-room-token.png)

1. Go to to **My account**
2. Click on the tab **Rooms** and select the room you want to send the notifications
3. On the left, choose **Tokens**
4. Enter a label, by example "Kanboard" and save

### Kanboard configuration

![Hipchat settings](http://kanboard.net/screenshots/documentation/hipchat-settings.png)

1. Go to **Settings > Integrations > Hipchat** or **Project settings > Integrations > Hipchat**
2. Replace the API url if you use the self-hosted version of Hipchat
3. Set the room name or the room API ID
4. Copy and paste the token generated previously

Now, Kanboard events will be sent to the Hipchat room.