How To Integrate HipChat with PagerDuty

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.  The HipChat – PagerDuty integration is a quick and simple process.  Please follow this guide to get your account setup.  If you are having trouble completing the integration please contact us.

In PagerDuty:

  1. Go to the Services tab and then click on the service which you would like to tie to your HipChat.
  2. Within the service window, click on the + Add a webhook button.
    Add a PagerDuty Webhook
  3. Enter a name for your webhook (e.g. HipChat) and an Endpoint URL as follows:

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

    Add a PagerDuty Webhook

    • Replace <auth_token> with one of your API auth tokens from HipChat.
    • 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.
  4. Click the Save button.

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

PagerDuty Webhooks in Action

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 http://requestb.in to view the contents of a webhook payload.