You can configure webhooks to deliver alerts about your application, device, or network performance. You can also use webhooks in an alert rule and configure multiple alert rules to the same webhook from your third-party provider. To learn more, see Configuring an Alert Rule.

To configure a new webhook in the ZDX Admin Portal:

1. Go to Administration > Integrations > Webhooks > Add New Webhook.

2. In the Add New Webhook window:
   • Name: Enter the name of the webhook.
   • Status: Choose either Enabled or Disabled.

   • URL: Enter the URL of the webhook provider.

     Ensure your URL does not include any space.

   • Authentication Type: Choose either Basic, Token, or OAuth for authentication. The webhook provider determines the authentication type used. Refer to your provider for details.

     You can configure OAuth 2.0 for ServiceNow when configuring a webhook. To learn more, see ServiceNow Webhook Configuration Guide.

     • Basic

       Enter a Username and Password. Password information is hidden by default, but you can view it by clicking the View icon.

       See image.

       

       Close

       Close
     • Token

       Enter the bearer token. A bearer token is a unique alphanumeric string used for authentication. You can obtain the bearer token from your webhook provider.

       See image.

       

       Close

       Close
     • OAuth

       Enter the following:

       • Application: Select an application.
       • Client ID: Enter your Client ID.
       • Client Secret: Enter your Client Secret.
       • Refresh Token Expiration: Select the date your token expires. The default is the current date.

       Click Authenticate Tenant to authorize access to your application as a tenant.

       See image.

       

       Close

       Close

     See image.

     

     Close

3. Click Test Webhook to check the configuration.

   1. If the test is successful, a message indicating success appears.

      Click Save to save he webhook configuration and activate the changes.

      Test Webhook for OAuth does not post a test message. Instead, it acquires the OAuth token.

   2. If the test is unsuccessful, an error message appears.
      • To resolve the error, check for issues in the URL or the Authentication Type fields.
      • If the error persists, click Cancel so that the webhook configuration containing errors is not saved.

After the webhook is configured on your webhook provider site, you can view alert information such as:

• Alert start and end time
• Devices impacted
• Severity
• Rule name
• Alert criteria

The following provides guidance for webhook configuration for a supported platform:

• Microsoft Teams Webhook Configuration Guide
• OpsGenie Webhook Configuration Guide
• PagerDuty Webhook Configuration Guide
• Slack Webhook Configuration Guide
• Splunk Webhook Configuration Guide
• ServiceNow Configuration Guides:
  • ServiceNow Webhook Configuration Guide
  • ServiceNow Webhook Configuration Guide for Developers