Webhooks

Antavo offers the capability to preconfigure multiple authenticated trusted sites in a single interface, streamlining the operation of outgoing webhook messages through workflows.

The Webhooks extension introduced the Webhook message workflow action node in the workflow editor. This node features a dropdown menu that enables you to select a preconfigured trusted site authentication, as opposed to the 'Webhook message (legacy)' node, where all details must be added individually. We recommend using this node as it simplifies the process of configuring trusted sites, minimizing the potential for errors.

For detailed instructions on preconfiguring multiple authenticated sites, refer to the Trusted sites user manual and the description of the workflow action node.

To access the module, search for Webhooks under the Modules menu. The page consists of two sub-menus: Logs and Queue.

Logs

Here’s the log of the outgoing webhooks. The list provides the following information about each webhook message trigger attempt:

Created at	The date when the webhook message was sent
Action	The event that triggered the webhook message
Customer	A link to the affected customer’s profile
Response code	The code that the external party responded with
Status	The status code of the webhook message Queued: The webhook message will be sent shortly. Resent: The external party responded with an error or did not respond within the timeout interval, so a new webhook message with the same content was resent in 10 seconds. Failed: Antavo attempts to resend the webhook message 5 times with a 10-second interval, and the failed status is registered after 5 unsuccessful attempts. Done: The external party responded with a success message.

📓

Log entries are retained for 90 days (7.776.000 seconds).

Queue

Management UI users can monitor the status of the webhook requests in case of asynchronous processing. The queue list has the following columns:

ID	The identifier of the webhook request
Customer	A link to the affected customer’s profile
Trusted Site	The trusted site’s name
Path	The URL Path where the webhook request was sent to. It is configured in the Path field of the Webhook message node (e.g.,/customers/{customer._id})
Action	The event that triggered the webhook message
Retries	The number of resends. If a webhook has failed, the system tries to send it a maximum of five times.
Source	The ID of the workflow that triggered the webhook message.

The search bar supports all values shown in the queue columns, allowing you to filter the list based on any displayed information.