PagerDuty to HipChat Integration Guide

HipChat is persistent group chat for teams, with over 140 integrations and native clients for desktop and mobile devices. Hipchat has integrated its chat and communication platform into PagerDuty’s alerting ecosystem. This means that thanks to webhooks, HipChat is able to rebroadcast PagerDuty incident status on all state changes including triggers, acknowledgements, resolves, assigns and escalations. This complements our HipChat to PagerDuty integration which allows you to trigger incidents in PagerDuty from HipChat via a slash command. If you are using a self-hosted version of HipChat, please use our self-hosted integration guide.

In PagerDuty

  1. In your account, under the Configuration menu, select Services.
  2. Click on the service which you would like to tie to your HipChat.
  3. Within the service’s Integrations tab, click Add an extension.
  4. Select HipChat from the Extension Type drop-down.
  5. Enter a name for your extension (i.e. HipChat), enter in your V1 HipChat Auth token, and enter in the name of ID of the room you want the messages sent to in the Room ID field (you can get your room’s ID via this page or the rooms/list API method.). To get the proper V1 Token from HipChat, please follow these steps:
    1. Go to https://<YourSubdomain>.hipchat.com/admin/api
    2. Create a new token with the token type Notification
    3. Set the token label to PagerDuty

     

    PagerDuty

  6. Click the Save button. PagerDuty

You now have completed the integration, when an incident is triggered, acknowledged, or resolved in PagerDuty the update will post to HipChat.

HipChat

FAQ

What events trigger a webhook to be sent?

PagerDuty sends webhooks for various events related to an incident.  Please review our documentation for additional information.

What data is sent within a webhook?

For additional information about the payload, please review our documentation.

How can I test receiving a webhook?

You can use a website such as RequestBin to view the contents of a webhook payload.