• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with Kayako

Kayako logo

What does Opsgenie offer Kayako users?

Opsgenie provides a powerful bidirectional integration with Kayako. When a new conversation is created in Kayako, a corresponding Opsgenie alert is automatically created, containing rich information about the ticket. Opsgenie provides rich notifications with on-call rotations, scheduling features, and alert escalations to ensure the best ticket management for Kayako customers. As users execute actions on the alerts, like acknowledge, add note or close, the conversation in Kayako is also automatically updated according to mapped actions preferred by the customer.

Functionality of the integration

Kayako to Opsgenie:

  • When a conversation is created in Kayako, an alert is created in Opsgenie.

  • When a conversation is solved or closed in Kayako, it closes the alert in Opsgenie.

Opsgenie to Kayako:

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

  • If Create Kayako conversations for Opsgenie Alerts is enabled, actions for Kayako are executed in Kayako when the chosen action is executed in Opsgenie for alerts which have a source other than the Kayako integration.

  • This action mapping feature is explained in detail in the Action Mapping Feature section below.

Add Kayako Integration in Opsgenie

You can add this integration from your team dashboard

If you're using Opsgenie's Free or Essentials plan, or if you’re using Opsgenie with Jira Service Management's Standard plan, you can only add this integration from your team dashboard as the Integrations page under Settings is not available in your plan.

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.

To do that,

  1. Go to your team’s dashboard from Teams,

  2. Select Integrations, and select Add integration.

Follow the rest of the steps to complete the integration.

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

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

  3. Copy the integration URL.

  4. Select Save Integration.

Action Mapping Feature

  • Opsgenie allows customers to define action mappings between Opsgenie actions and Kayako actions.

  • To use the Action Mappings feature, provide the information listed below in the integration:

Kayako credentials
  • Kayako Email: The e-mail address used to login to Kayako.

  • Kayako Password: The password used to login to Kayako.

  • Kayako Subdomain: The subdomain used to visit the Kayako page. Subdomain must be "john", if the Kayako page URL is: https://john.kayako.com

For alerts created by Kayako

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

  • Map different Opsgenie actions to different Kayako actions. For example, add notes to a Kayako conversation when the alert is acknowledged. In order to do this, define If alert is acknowledged in Opsgenie, add note in Kayako. mapping in the Send Alert Updates Back to Kayako section.

Alert created by Kayako

For other Opsgenie alerts

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

  • For this purpose, use the Create Kayako Cases for Opsgenie Alerts section. In order to use this functionality, map one Opsgenie action to the create a conversation Kayako action. The Opsgenie action doesn't have to be alert is created, it can be other actions as well.

For other Opsgenie alerts
  • 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 is provided 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 for the mapping to work for any tag.

  • If a custom action mapping is selected, specify the name of the custom action that the mapping works. It cannot be left empty.

  • If an Opsgenie action is mapped to multiple Kayako 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.

Kayako tags

Configuration in Kayako

  1. In Kayako, go to the "Settings" page.

  2. Select Endpoints under "APPS".

  3. Click New Endpoint.

Kayako new endpoint

4. Select Webhook from the opened list.

Kayako webhook

5. Paste the integration URL into Request URL. Select POST as "Method" and JSON as "Request content type".

Kayako new end point

6. Click Save.

7. Now from the settings panel, select Triggers under Automation.

8. Create the triggers following this instructions file.

Kayako new trigger
Kayako triggers

Sample Webhook Message from Kayako

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "Case ID": "9", "Subject": "subject", "Team": "General", "Assignee": "testUser", "Requester": "testUser", "Priority": "", "Type": "", "Status": "New", "Tags": "", "Brand": "OpsGenie", "Form": "Default", "Custom fields": [], "Source channel": "MAIL", "Last replier": "testUser", "Rating status": "UNOFFERED" }

 

Additional Help