Kontakt.io supports a one-way integration to send Asset Tracker alerts to a third-party system. This is achieved using a Webhook, which is created and managed within the Kio Cloud Company Settings. Once created, Webhooks are then assigned to Asset Tracker Alert Rules to enable the integration.
Prerequisites
You're assigned to the Asset Tracker Administrator role.
Alert Rule is created.
Webhook is created in Kio Cloud Company Settings and assigned to the Asset Tracker app.
Assign a Webhook to an Asset Tracker Alert Rule
To send alerts to a third-party system, the Webhook must be assigned to an Alert Rule.
From your Kontakt.io Launchpad, open Asset Tracker.
From the Settings menu, select Alert Rules.
From the list, select the Name of the Alert Rule > select Edit.
Navigate to the Actions section. It lists the recipient options available to every Alert Rule — Emails, Text Messages, and Webhooks.
Select the Webhooks checkbox. Select Webhook is then displayed — choose the Webhook to assign.
Select Save.
Test the Webhook integration
-
Trigger an alert.
Asset Tracker alert: triggered by the condition in the Alert Rule — the assets and locations the alert applies to must be included in the Alert Rule with the assigned Webhook.
Confirm the third-party system received the alert.
From your Kontakt.io Launchpad, select Asset Tracker > navigate to the Alerts menu, select the List view > locate and select the alert triggered in step 1 > view its Activity Timeline > verify the Webhook event is present and view its details.
Go to Kio Cloud Company Settings > navigate to the Webhooks menu > select the History Log tab > verify the alert event details and a successful status (200).
View an alert's Webhook events
When an alert is triggered by an Alert Rule with an assigned Webhook, you can view the Webhook event from the alert's profile.
From your Kontakt.io Launchpad, select Asset Tracker.
Navigate to the Alerts menu, select the List view.
Locate and select the alert > view its Activity Timeline > locate the Webhook event and view its details.
-
From the Activity Timeline > locate the Webhook alert event(s).
Each event response/status provides an option to show details for additional information.