| Table of Contents |
|---|
Overview
...
On the ISM homepage, go to Tools → Webhooks.
By clicking on the webhooks tool, you can create a new item or edit an existing item.
Webhooks can be created for various purposes. Consider an example of creating a new webhook for acknowledgments made to a ticket.
Click on New Webhook.
On the General tab, enter a preferred name for the webhook.
The Endpoint URI/Path is the third-party URL for which the updates are to be posted, or the notifications are to be triggered.
Choose the HTTP method like “POST” or “PUT” or “PATCH” as per the information required for the external system.
Select the type of request in the Form Type field. Based on the Ticket type selected for the Form Type field, further details specific to the Ticket type are populated in matching condition.
Select the Entity Type. Select “Ticket” in the entity type as currently, only the “Ticket” entity type is supported.
Under Related Events, You can choose any number of events for which notifications are to be triggered by enabling the checkbox.
Under Matching criteria, choose to match either All or Any condition. An option to define custom conditions is also available if a specific Ticket type is selected. For example, The ticket type selected is Incident then the matching condition will additionally have all custom fields for Incident.
The next section, while setting up a webhook, is the configuration details.
Enter the header details along with the respective information for the Key and Value.
The request body, on the other hand, holds the details to be posted for the external system. The JSON format here can contain any data which is different for distinct web applications.
Click on Save to create the webhook as per your requirement.
...
For Attachment created webhook, If filename is required to be sent in the payload, we have a new token which can be used as file_name=${attach_file_name}
For ServiceNow Attachment Endpoints supported earlier was were/now/attachment/file and now the supported endpoint is /now/attachment/upload, The later method supports multipart file attachment earlier was supporting binary in the payload.
...
Select the required Webhook.
Click on the Logs tab. Here you can view the list of events triggered with the following information:
Webhook name represents the name of the Webhook
Case# is the Ticket number for which the event is triggered.
Event Name represents the event triggered for the Webhook. For example, Ticket Creation, Ticket Update, etc.
Entity Name contains the entity for which Webhook is configured.
Executed On is the event execution date
Job Status is the status of the event. It represents if the event was successfully triggered or encountered an error.
Response contains the response received from the target system. In case of a failure, the response holds the error details which can be used in troubleshooting the webhook.
Retrigger an event
You can retrigger an event in the following ways:
From Webhook History
In case an event encounters an error, you can retrigger the failed event :from the Webhook History section. To do so,
Select the Webhook and navigate to the Logs tab.
On the events list, select one or more events.
Under Bulk Actions, click on Retry Events.
...
| Info |
|---|
Only Failed events can be retriggered with the original case details. |
From Ticket Center:
From the Ticket Center, you can retrigger the explicit Webhook events linked to a specific ISM ticket (Attachments, Relating CIs, Worklogs updates, SLA Events). To do so,
Navigate to Ticket Center and select the ticket.
In Actions → Ticket, click on Regenerate Webhook Events. The events for the selected ticket are listed in a popup.
Select the Webhook events to be retriggered and click on retrigger events.
The selected events are retriggered with the ticket details.