Webhook Messages

The Webhook Messages show a log of all outgoing webhook notifications that X4fleet sends to connected target systems on certain events. The page is aimed at dispatchers and administrators and serves to monitor interface communication: you can view the delivery status, inspect individual messages in detail, adjust and resend them if needed, export them or delete them.

1. Navigation

The webhook messages are accessible via the main menu under Monitoring › Webhook Messages.

Note: Access is available to users with the Dispatcher and Administrator roles.

2. Overview table

The overview shows all sent webhook messages in a paginated, sortable table. Each row represents one webhook message.

Default columns

Sorting

Clicking a column header sorts the list ascending or descending by that column.

Multi-selection

Using the checkboxes at the start of each row, several messages can be selected at once. The toolbar actions "Resend" and "Delete" operate on all selected messages.

3. Date range

The date range filter lets you restrict the list to a time period (from/to). Only messages whose timestamp falls within the selected period are shown.

The last selected date range is saved and automatically reapplied the next time the page is opened.

Note: On this page only a single, bounded period (from/to) is possible; extended variants ("before"/"after") are not available here.

4. Group area

The displayed messages are restricted to the currently active group and its subgroups. The "Current group only" option lets you limit the display to messages of the active group; if it is disabled, messages of the subgroups are included as well.

If the active group is switched via the global group toggle, the table reloads automatically.

Note: For subcontractor groups the "Current group only" option does not apply.

5. Column filters and quick search

A filter row is available below the column headers. A search value can be entered per column; the list is restricted accordingly.

• For the Status, Tour trigger and Shipment trigger columns the filter is offered as a selection list with the respective available values.
• The Timestamp column cannot be filtered via the filter row; for the time restriction use the date range (see Section 3).

In addition, the quick search searches the displayed list across multiple columns. The "Reset filters" button removes all active filters again.

6. Resend messages (selection)

If the dispatch of a webhook message fails or a message needs to be redelivered, selected messages can be resent directly from the toolbar.

1. Select one or more messages in the list.
2. Click the "Resend" button in the toolbar.
3. The selected messages are resent to their respective target URL.

After successful dispatch a confirmation message appears.

Note: The button is only active as long as at least one message is selected.

7. Detail view: display, edit, resend

The detail view lets you fully inspect, adjust and resend an individual webhook message. It opens as a wide window.

The detail view contains:

• Log / errors: An expandable area with the log entries for the delivery of the message. Any error messages are visible here.
• Raw message: The complete message content as a structured JSON editor.
• Payload: The transmitted payload as a second structured JSON editor.

Both JSON editors are displayed in an expanded form view and can be edited.

Edit and resend

1. Open the detail view of the desired message.
2. If needed, adjust the content of the raw message or the payload in the JSON editors.
3. Click the "Send" button – the message is resent to the target URL with the currently displayed (possibly edited) content.

Note: Larger message contents are loaded on demand from storage during display. With very large payloads, opening the detail view may therefore take a moment.

8. Delete messages

Webhook messages that are no longer needed can be deleted directly from the overview.

1. Select one or more messages.
2. Click the "Delete" button in the toolbar.
3. Confirm the confirmation prompt.

The selected messages are permanently removed from the log.

Warning: Deletion is irreversible. Deleted messages cannot be restored.

9. Export

The webhook messages can be exported.

• The export button in the toolbar exports the content of the currently displayed table.
• In addition, separate exports for shipment-related and tour-related webhook messages are available.

During export the associated payloads are merged. Irrelevant partial shipments can be excluded depending on the webhook settings.

Note: Access to the exports is secured per group; only messages of the groups for which you are authorized are exported.

10. Table layout and templates

The column and layout settings of the webhook messages are saved automatically per user and persist after logging out.

• Column selection / layout: The layout functions of the toolbar let you show and hide columns and adjust the table arrangement.
• Templates: Saved templates can be applied to the current view via the corresponding buttons in the toolbar, to quickly switch between different column and filter configurations.

11. Summary: available actions