Managing webhooks
Last updated
Last updated
Before Nexthink can export data to any third-party supported tools, you must create and define new credentials to connect and enable such communication and then apply the credentials when configuring a webhook. Refer to the Connector credentials documentation for more information.
Nexthink uses a mechanism to regulate the delivery of messages sent to third-party tools, preventing them from becoming overloaded with data.
This means that information delivery is not immediate and some delays may occur.
To configure a Webhook, you must have Central Administrative privileges and the Integrations module enabled.
Follow these steps to access Webhooks:
Open Administration > Outbound connectors from the main menu.
Select Webhooks from the list of outbound connectors.
The system lists all existing webhooks. Therefore, when you access the Webhooks page for the first time, no elements are displayed
Confirm the validity of an existing webhook setup by checking and hovering over the icons under the Configuration column.
Find below the table fields on the Webhooks page:
Active: Toggle that enables a webhook to listen to the occurrence of an alert or event in order to perform an action
Name: Name of the webhook
Credentials: Defines the credentials from the third-party tool that the webhook will push the data to
Description: Meaningful description of the action performed by the webhook
From the Administration > Outbound connectors > Webhooks page:
Click New webhook button located to open the webhook configuration page.
Fill out the form:
Name the webhook being created.
Description of the action performed by the webhook.
NQL Conditions is a NQL query that specifies the condition of an alert or event that triggers an action configured in the Request method section. Refer to the Configuring webhook NQL conditions documentation.
Credentials specify the credentials of the third-party tool that you intend to target.
Request method, Resource and Payload define the information that represents the action executed on the third-party tool. Refer to the Configuring webhook fields: Method, Resource, and Payload documentation for information about request methods, Resource API and Payload.
Send Test to verify the correct configuration of Credentials, Request method, Resource and Payload.
The system warns you of any mistakes or missing configuration fields.
Testing does not replace any use of placeholders within the payload, for example: {{variable_name}}. The system treats all variables as plain strings.
The image below displays an example of webhook configuration fields.
The image below shows the ServiceNow incident created using the Sent Test button from the webhook configuration page.
From the Administration > Outbound connectors > Webhooks page:
Hover over the webhook to reveal icons on the right side of the selected item:
Click on the pencil icon to open the configuration page for the webhook.
Click on the bin icon to delete the webhook.
Deleting a webhook cannot be undone.
Disabling a webhook disengages the third-party tool even if the NQL conditions satisfy the alert setting requirements.
You can switch off the Active toggle for a webhook in two different places:
In the Active column of the list of webhooks on the Webhooks page.
On the Webhook edit page by editing the webhook Active property.
RELATED TASK
