Integrate Opsgenie with Salesforce Service Cloud

What does Opsgenie offer Salesforce Service Cloud users?

Use the integration to send Salesforce Service Cloud cases to Opsgenie with detailed information. Opsgenie acts as a dispatcher for Salesforce Service Cloud cases, determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

This document describes how to configure the integration and details of data that Opsgenie receives from Salesforce Service Cloud.

Functionality of the Integration

• When a case is created by Salesforce Service Cloud, an alert is created in Opsgenie.

• When the case's state is changed to Working in Salesforce Service Cloud, the corresponding alert is acknowledged in Opsgenie.

• When the case's state is changed to Closed in Salesforce Service Cloud, the corresponding alert is closed in Opsgenie.

• If Send Alert Updates Back to SalesForce Service Cloud is enabled, actions for Salesforce Service Cloud are executed in Salesforce Service Cloud when the chosen action is executed in Opsgenie for alerts which are created by the Salesforce Service Cloud integration.

• These action mapping features are explained in detail in the Action Mapping Feature section below.

Adding Salesforce Service Cloud Integration in Opsgenie

1. Go to Settings > Integrations. Search for Salesforce Service Cloud and select Add.

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

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

4. Select Save Integration.

Configuration on Salesforce Service Cloud

1. Download the opsgenieClass.apxc file.

2. In Salesforce Service Cloud, click the Settings icon and click the Developer Console.

3. In Developer Console page select File and click New -> Apex Class and copy opsgenieClass.apxc, then click Save.

4. Download the opsgenieTrigger.apxt file.

5. On the Developer Console page, select File.

6. Click New -> Apex Trigger and paste opsgenieTrigger.apxt. Then, paste the API URL copied previously into the endpoint field in the trigger function.

7. Click Save.

8. Go back to the Salesforce page and select Setup from settings and go to Setup->Security->Remote Site Settings page.

9. Add a new remote site: name it "Opsgenie" and then paste the URL copied previously to the "Remote Site URL" field.

10. Click Save.

Action Mapping Feature

• Opsgenie allows customers to define action mappings between Opsgenie actions and Salesforce Service Cloud actions.

For alerts created by Salesforce Service Cloud

• Use this section to map Opsgenie actions to Salesforce Service Cloud actions when the source of the alert is Salesforce Service Cloud (i.e When the alert is created by Salesforce Service Cloud integration.)

• Map different Opsgenie actions to different Salesforce Service Cloud actions. For example, set case status to Working in Salesforce Service Cloud, when the alert is acknowledged. In order to do this, define If alert is acknowledged in Opsgenie, set case's status to Working in Salesforce Service Cloud. mapping in Send Alert Updates Back to Salesforce Service Cloud section.

• a tag is added to the alert and a custom action is executed on alert actions differ from other actions. When one of these actions is selected, an extra field appears to enter for which tags or for which custom action this mapping works.

• Enter multiple tags by separating the tags with a comma. If multiple tags are entered, the mapping works if the alert has one or more of the specified tags. Leave the tags field empty to have the mapping to work for any tag.

• If an Opsgenie action is mapped to multiple Salesforce Service Cloud actions, an error occurs except for the a tag is added to the alert and a custom action is executed on alert actions. Save multiple mappings for these actions because they differ by the given tags and the given custom action names.

For other Opsgenie alerts

• Use this section to map Opsgenie actions to Salesforce actions when the source of the alert is NOT Salesforce (i.e When the alert is created by another integration.)

• For this purpose, use Create Salesforce Issues for Opsgenie Alerts section. In order to use this functionality, map one Opsgenie action to create an issue Salesforce action. The Opsgenie action doesn't have to be alert is created, it can be other actions as well.

• a tag is added to the alert and a custom action is executed on alert actions differ from other actions. When one of these actions is selected, an extra field appears to enter for which tags or for which custom action this mapping works.

• Enter multiple tags by separating the tags with a comma. If multiple tags are entered, the mapping works if the alert has one or more of the specified tags. Leave the tags field empty to have the mapping to work for any tag.

• If an Opsgenie action is mapped to multiple Salesforce actions, an error occurs except for the a tag is added to the alert and a custom action is executed on alert actions. Save multiple mappings for these actions because they differ by the given tags and the given custom action names.