Send Incidents or Alerts to Zendesk

You can configure a Moogsoft outbound integration to post incidents or alerts to Zendesk.

Before you begin

This integration was validated with Zendesk v10654 on April 13, 2021. Before you start to set up your integration, make sure:

  • You have an active Zendesk account.

  • You have the necessary permissions to create alerts and notifications channels in Zendesk.

  • Zendesk can make requests to external endpoints over port 443. This is the default.

  • You have your Zendesk subdomain name.

Prepare Zendesk to receive API Actions

To prepare Zendesk to receive incidents from Moogsoft do the following:

  1. Log in to Zendesk.

  2. Click Admin in the left sidebar.

  3. Go to Channels > API.

  4. Enable Password access.

Configure the webhook in Moogsoft

To create a new webhook in Moogsoft do the following:

  1. Log in to Moogsoft .

  2. Click Data Config > Outbound.

  3. Click Webhook.

  4. Click ADD A WEBHOOK.

  5. Enter the following values:

    1. Name: Zendesk

    2. Select the type of data to send.

      • Type: Incident, or

      • Type: Alert

    3. Filter: Default (leave blank)

    4. URL: The Zendesk endpoint for your instance. Example: https://<subdomain>

  6. Click Authorization.

  7. Select Basic Auth for the Authorization Type, and then enter the following values:

    1. USERNAME: <your-Zendesk-user-name>

    2. PASSWORD: <your-Zendesk-user-password>

  8. Click Headers.

  9. Click Add New Row and enter the following:

    1. Key: Content-Type

    2. Value: application/json

  10. Click Body and enter the following information:

    When sending incidents:

    {"ticket":{"comment":{"body":"An incident $id reported by Moogsoft, with severity $severity : $description \nClick here for details - $incident_url"},"priority":"urgent","subject":"Incident $id with severity $severity "}}

    When sending alerts:

    {"ticket":{"comment":{"body":"An alert $alert_id reported by Moogsoft, with severity $severity : $description \nClick here for details - $alert_url"},"priority":"urgent","subject":"Alert $alert_id with severity $severity "}}
  11. Click Test.

    When the integration test is successful, continue to the next step. Otherwise, check your configuration and make any necessary changes, then try testing it again.

  12. Click Save.

The integration is now active.