HipChat Server Integration Guide

HipChat is persistent group chat for teams, with over 140 integrations and native clients for desktop and mobile devices. This integration allows you to integrate your self-hosted HipChat Server with PagerDuty, allowing you to see when incidents have been triggered, acknowledged and resolved in a HipChat room of your choice.

If you do not have a self-hosted version of HipChat, please follow our standard PagerDuty to HipChat Integration Guide instead.

In PagerDuty

  1. From the Configuration menu, select Services.
  2. Click on the service that you wish to integrate with your HipChat server.
  3. Once you are on your service page, go to the Integrations tab.
  4. On the Integrations section of your service, click on New Extension.

  5. For the Extension Type select Generic Webhook.
  6. Enter in a Name for your Extension.
  7. You will need a 30-character HipChat API v1 token. To get a v1 token:
    1. Go to https://YOUR-HIPCHAT-SERVER-ADDRESS/admin/api
    2. Create a new token with the token type Notification
    3. Set the token label to PagerDuty
  8. Edit and paste the following URL into the Details section; you will need to add your HipChat server address, HipChat API v1 token, and room ID:

    https://YOUR-HIPCHAT-SERVER-ADDRESS/v1/webhooks/pagerduty/?auth_token=YOUR-30-CHARACTER-V1-TOKEN&room_id=YOUR-ROOM-API-ID

    Note: This integration requires a 30-character HipChat API v1 token; 40-character v2 tokens will not work.

  9. Click Save.
  10. Congratulations! You now have completed the integration process, when an incident is triggered, acknowledged, or resolved in PagerDuty the update will post to HipChat.