• Get started
  • Documentation

Integrate Opsgenie with Desk.com

Desk logo

What does Opsgenie offer Desk.com users?

Use Opsgenie’s Desk.com Integration to forward Desk.com alerts to Opsgenie. Opsgenie determines the right people to notify based on on-call schedules– notifies via text messages (SMS), phone calls and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed. Forward Opsgenie’s "add note" alert activities to Desk.com.

Functionality of the integration

  • When new case is created on Desk.com, an alert is created in Opsgenie automatically through the integration.

  • When the case on Desk.com closed or resolved, the alert is closed in Opsgenie.

  • When a note is added to the alert in Opsgenie, the note is also added to the case on Desk.com.

Add Desk.com Integration in Opsgenie

This integration is only available with Standard and Enterprise plans in Opsgenie, and Premium and Enterprise plans in Jira Service Management.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only. Follow the rest of the steps in this section to set up the integration.

  1. Go to Settings > Integrations. Search for Desk.com and select Add

  2. Specify who is notified of Desk.com alerts using the Responders field. Auto-complete suggestions are provided as you type.

  3. Copy the integration URL which includes Opsgenie endpoint as well as the API key.

  4. Select Save Integration.

Configuration on Desk.com

  1. In Desk.com, go to the Admin Panel.

  2. In "Apps" tab, install Custom Action.

  3. Enter the action name "Opsgenie", Select "None" as the authentication method.

  4. Paste the Integration URL copied when adding the integration.

Desk.com install custom action

5. Click Create.

6. After installing app, Add Action.

7. Set name as "Send to Opsgenie"

8. Select Post a JSON string to a URL as "Action Type"

9. Fill the "JSON to POST" field by referring to this file.

Desk.com new action

10. Click Add Action.

11. Go to Cases -> Rules -> Inbound Interaction.

12. Click + Add Rule.

13. Enter a name and click Add.

Desk.com add inbound interaction rule

14. Add a Rule Action with selecting Trigger an App Action and Opsgenie: Send to Opsgenie.

15. Set "Enabled" as "Yes" and Update.

Desk.com edit inbound interaction rule

You can configure an Outbound Interaction to update and close Opsgenie alerts on case changes.

Alert properties can be configured from Desk.com Integration / Advanced Settings page.

Configuring Opsgenie to Desk.com Integration (Optional)

To enable Opsgenie to send alert actions to Desk.com, configure both Desk.com and Opsgenie.

At Desk.com

Add an API Application

  • In Desk.com, go to Admin Panel->Settings

  • Add API Application named "Opsgenie"

  • Generated keys are used by Opsgenie

Desk.com token

In Opsgenie

Add the following information to your Desk.com integration in Opsgenie.

  • Go to Opsgenie Integration page and click the Desk.com integration to modify.

  • Make sure Send Actions to Desk.com is checked.

  • Enter the subdomain for the Desk account.

  • Paste the Key of the "OpsGenie" API Application to "Consumer Key" field.

  • Paste the Secret of the "OpsGenie" API Application to "Consumer Key Secret" field.

  • Paste the Token of the "OpsGenie" API Application to "Access Token" field.

  • Paste the Token Secret of the "OpsGenie" API Application to "Access Token Secret" field.

  • Click "Save Integration".

Desk.com save settings

Opsgenie uses this information to send Desk.comm the API requests and keep cases up-to-date. This configuration is optional; leave "Send Actions to Desk" unchecked and keep using Desk.com integration one-way.

Sample Payload

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 { "caseId": "2558", "caseSubject": "Fwd: test123", "caseDescription": "", "caseLabels": "", "caseStatusName": "New", "caseGroupName": "General", "caseChannel": "email", "casePriority": "4", "caseUserId": "", "caseUserName": "", "caseOpenedAt": "2015-01-29 15:45:47 UTC", "caseCreatedAt": "2015-01-29 15:42:47 UTC", "caseUpdatedAt": "2015-01-29 15:42:47 UTC", "customerId": "290081130", "customerName": "Tuba", "customerEmail": "tuba@gmail.com", "customerPhone": "12345", "customerCompany": "ifountain" }

 

Still need help?

The Atlassian Community is here for you.