Creating a Webhook Subscription
Create Webhook Subscription Dialog
Open the Webhooks module in the Alerts section.
Click Create Webhook Subscription
in the top right corner.Fill in the required fields (marked with *) for each step in the dialogue.
Click Create.
Types of Webhook Subscriptions
The VMS supports three types of webhook subscriptions: HTTP, Email, and Websocket.
HTTP and Email: These types send notifications as a HTTP request or as an email.
Websocket: This type pushes notifications directly to users via VMS.
Below are illustrations and detailed descriptions of the fields required to create a new Webhook Subscription for each type.
Receiver Step
Trigger Step
The Trigger specifies the condition that must be met to send a notification to the Receiver. Below are examples of various Webhook Subscription types, ranging from simple to more complex Trigger conditions.
Default example: will send notifications to the Receiver whenever a Cargo object your user has access to is updated.
Example Expression
To trigger a notification in this example, multiple conditions must be satisfied:
The
cargoQuantitymust be modified and be greater than or equal to 1000.The
chartererkey of the Cargo must match a specific user key.
These criteria ensure that notifications remain relevant and informative.
Easily set up by selecting a pre-existing alert script. Ensure the script is already created in the Alert Scripts module under Alerts, and it should include its own configurable object type and event type triggers.
All Object Types example: requires little configuration on the Trigger step, as it will create Webhooks for all Object Types for a given Event Type. This type is only allowed for a HTTP Receiver and should be thought through, as it may flood the server with notifications.
This mode creates a webhook for all object types, which may flood the server with notifications. Most use cases will be covered by Default and Expression Webhooks. If you are unsure, use one of these instead.
Payload Step
Template Message and Fields are optional. Template Message allows for a custom message where field values from the object can be inserted in the sent notification.
General
All options are optional except User, which must be selected. This should in most cases be set to the user intended to receive the notification. As the permissions of that User decides the access to objects when the notification is sent. Failing notifications could be due to the User not having the right access. The description icon (i) can be hovered over to reveal additional information about their function.
Last updated
Was this helpful?