Please note that this is a Technical Preview and consequently that all documentation, content, or updates may contain errors and are provided for limited evaluation only. The Technical Preview, the documentation, and any updates are provided on an ‘as-in’ and ‘as-available’ basis without warranty of any kind, whether express, implied, by operation of law or otherwise. Nexthink specifically disclaims all implied warranties of merchantability, fitness for a particular purpose and non-infringement.

What happens when I create a webhook without creating the credentials first?

The webhook cannot be created because there will be no eligible credentials to select.

Is it possible to test and validate the credentials at the time of creation?

Unfortunately, this functionality is not available at the time the credential is being created. The Send test button must be used to test if the credential, request method and payload are correct.

Why isn't OAuth 2.0 currently supported as a valid authentication mechanism?

This authorization mechanism will be available in the upcoming releases. The interaction flow that will be supported is Client Credentials.

What happens when I remove a credential that is being used by a Webhook?

If a credential that is referenced in one or more webhooks is removed, the state of the webhook will remain inconsistent until either an existing credential is assigned to it or it is removed.

The webhook affected by a missing credential will not process any requests and it will give a false impression that it is working.

Until a proper mechanism to identify webhooks that are missing a credential is implemented, we recommend removing the webhook first and then the credential linked to it.

What happens when an alert is triggered and multiple disabled webhooks satisfy the criteria defined in NQL conditions?

Nothing occurs on disabled webhooks even when a triggered alert matches the filtering criteria. A webhook will not process an alert when it is disabled.

What happens when a valid NQL query is inserted in the NQL conditions field that does not reference an alert event?

When a valid NQL query is added into the NQL conditions field, it is not reported as an error. Webhook uses an NQL editor that contains greater capabilities than what is required for defining a webhook. In the NQL conditions field, only alerts and certain events are considered valid.

Refer to the https://nxdocs.atlassian.net/wiki/spaces/devnxitg/pages/991363073 documentation to learn more about how to create a valid NQL query for webhooks.

What kind of queries can be added into the NQL conditions field?

Refer to the https://nxdocs.atlassian.net/wiki/spaces/devnxitg/pages/991363073 documentation to learn more about how to create a valid NQL query for webhooks.

What Nexthink variables are supported in the Payload field?

Nexthink variables can be used within the payload to provide more context of the alert or event that is being triggered. The list of available variables to be used within the payload can be found in https://nxdocs.atlassian.net/wiki/spaces/devnxitg/pages/999882833/Method+resource+and+payload#Nexthink-datamodel-variables-used-with-payload.

Can I create a Webhook from the AlertHub directly?

Currently, the only way to create a webhook is by accessing the Webhook page, under the Integrations category from the main Administration menu. Central Admin access is required and an Integrations license is needed.

Where can I see the status of the calls made by a webhook?

Currently, there is no central place to visualize the status of the executions made by the different webhooks. We recommend using the Send test button if you suspect that the webhook is not behaving as expected.

In the future, a page containing the results of the different webhook executions will be created.