AlertOps Inbound Integration Configuration 

Select Hipchat from the Integration Template, add Integration Recipients and save it. You can get the URL to use in Hipchat by clicking the “Copy URL” button. You can also test the integration by clicking the “Test” button.  

Hipchat Configuration Details
Note: Mentionname in Hipchat should match Username in Alertops for a User

Go to Integrations, and Build your own integration for that particular Room in Hipchat  

Integration sample using AlertOps Endpoint
Note 1.”Send messages to this room by posting to this URL” will be used as a group contact later in Alertops
Note 2.”We will POST to this URL” is explained in detail below  

How to create “We will POST to this URL” 

Hipchat API field mapping 

REST API URL: https://notify.alertops.com/RESTAPI.svc/POSTAlertV2/generic/[your api key]/[Source]/[Source Name]/None/None/None/None/None/None/None/None 

*Note: You can change the field mapping at any time, AlertOps does not require that the Hipchat fields are mapped as shown here. You can create you own custom mapping. 

Source = hipchat (you can use any name so long as it matches a Mapping Rule Source)
Source Name= item^room^name(it will map the Room Name in Hipchat)
Subject = NONE
Incident Id = NONE
Status = NONE
Severity = NONE
URL = NONE
Short Text = NONE
Long Text = NONE
Assignee = NONE 

Now, you can send alerts from Hipchat to AlertOps using the following patterns:

Open Alert on Value: This value will be used as a command from Hipchat to open a new Alert. You can configure this command however you like
Enter your slash command open subject

Close Alert on Value: This value will be used as a command from Hipchat to close an Alert. You can configure this command however you like
Enter your slash command close alert id resolution

Acknowledge Alert on Value: This value will be used as a command from Hipchat to acknowledge an Alert. You can configure however you like
Enter your slash command ack alert id
When AlertOps receives an Acknowledge command from Hipchat, it will match the user on the Alert to the sending user from Hipchat. 

Assign Alert on Value: This value will be used as a command from Hipchat to assign an Alert. You can configure this command however you like
Enter your slash command assign alert id
When AlertOps receives an Assign command from Hipchat, it will match the user on the Alert to the sending user from Hipchat. 

Update Alert on Value: This value will be used as a command from Hipchat to reply to an Alert. You can configure this command however you like
Enter your slash command reply alert id subject 

Sample Hipchat to Alertops pattern

Sample inbound Message list in Alertops  

Update the group contact in your Alertops group with Hipchat “Send messages to this room by posting to this URL”  

Add the Hipchat Group Contact Type to a Message Rule in Alertops.   

Testing and Troubleshooting

Click here to read about Web API Testing and Troubleshooting. 

Did this answer your question?