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.

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 window, click Add a webhook.

  4. Enter a name for your webhook (i.e. HipChat) and an Endpoint URL as follows:

    https://api.hipchat.com/v1/webhooks/pagerduty/?auth_token=<auth_token>&room_id=<room_id>

    Replace <auth_token> with one of your API auth tokens from HipChat. 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

    Replace <room_id> with the name or ID of the room you want the messages sent to. You can get your room’s ID via this page or the rooms/list API method.

  5. Click the Save button.

    Once you have added your webhook, you can see it update within your HipChat interface.

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.