Skip to main content

Alert Rule management

  • Updated

Alert Rules define the monitored conditions that trigger staff duress alerts, primarily based on button events from a Kontakt.io Smart Badge that are worn by staff.

When the conditions set in an Alert Rule are met, the rule activates a new alert and notifications are sent. These conditions include the Smart Badge button event (blue, red, or any button), the staff the rule applies to, the location monitored by the rule, and actions. Actions specify who receives alert notifications and the notification method. Notifications can be sent via email, SMS text, or through a Webhook to a third-party system. Webhooks are configured in Company Settings and assigned to Alert Rules.

Note

To view and manage Alert Rules, you must be assigned to the Administrator role within the Kio Staff Safe app. Roles are managed by those assigned to the Administrator role within the Kio Cloud Users app.

Topics include: 

Alert Rule settings

Each rule is configured with the following settings.

Category

Settings 

General

Alert Name: Uniquely identifies the rule. Recommended to define a standard naming convention. For example, Campus name or building. location, type of alert, staff type (role, group) as "Main Campus Critical Nurses Only"

Alert Description (optional): For information sharing purposes.

Alert Severity: Options include: Critical, High, Medium, Low, and Info. A rule set to Critical, results an in-app and audio notification.

Include Responder: To allow the system to auto-acknowledge a first responder and track response time metrics, an Alert Rule's Include Responder setting is required to be assigned to a Staff Group. A Staff Group(s) must include those Staff designated as responders for the alerts activated by the Alert Rule.

Applies To

Identifies the staff, those wearing and assigned to a Smart Badge, the rule will monitor. Options include: specific Staff, Staff Role, or Staff Group.

When any of the staff assigned to the Applies To activates an alert from their badge, the Alert Rule immediately triggers a new alert and sends alert notifications that are defined within the rule's Actions.

Locations

Identifies the locations, managed in Kio Cloud Smart Location, the rule will monitor.

For example, if you have multiple campuses and responders unique to each campus, assigning specific campus locations to a rule allows you to set the rule's actions (alert notification methods) to be set to the specific location responders.

Conditions

The Smart Badge button event that will activate and trigger an alert.

Options include: Blue Button, Red Button, or Any Button.

Actions

Identifies how responders or other staff are notified when an alert is activated by a staff from their Smart Badge.

An alert is required to be set to one action and multiple methods can be set. Regardless of the method, all alert notifications include the Alert Severity, Staff Name, and the location where the alert was activated including the campus, building, floor, and room.

Available notification methods include:

  • Email: Alert notifications are sent to each email address.

    Be sure to include a subject and optiontally add additional information to the message.

  • Text (SMS): Alert notifications are sent to each phone number.

    Phone numbers must include the country code (for example, for the US entered as 1-area code-xxx-xxxx).

  • Webhooks: Alert notifications are sent to a third-party system.

    Webhooks are managed from Company Settings and commonly created and configured by IT staff or those responsible for integration.

Important

To allow those that receive notfiications to view, acknowledge, and resolve an alert, they are also required to be a Kio Cloud User assigned to a Staff Safe user role with permissions to alerts.

Create an alert rule

When creating a new alert rule, you'll be guided through the six configuration steps.

  1. From your Kontakt.io Launchpad, select Staff Safe Emerg. Call.

  2. From the Settings menu, select Alert Rules.

  3. Select Create Alert > Button Click.

  4. You are guided through each the following configuration steps.

    • Step 1: General: set the name to uniquely identity the rule and its severity level.

      If your organization is tracking alert response times by responders wearing badges, from the Include Responder setting, select the Staff Group the responders are assigned to.

      By default, the rule is in active status (ON) and monitors the configured conditions that will trigger alerts. If you don't want alerts to be triggered, such as during the setup phase, you can deselect Activate Alert Rule after saving. When you begin a testing or go-live phase, the rule's status will be required to be changed to ON.

    • Step 2: Locations: select the campus and or building locations the rule will monitor.

    • Step 3: Applies to: select the staff the rule will monitor.

    • Step 4:Conditions: select the button event that triggers an alert.

    • Step 5: Actions: set how and who is notified when an alert is activated.

    • Step 6: Summary: verify all settings are correct. To edit a setting, select its edit icon.

  5. Once the six steps are complete, select Save.

Important

Once a new Alert Rule is active (ON), it's recommended to test activating alerts on a subset of badges following your organization's acceptance testing requirements.

Edit an alert rule

  1. From your Kontakt.io Launchpad, select Staff Safe Emerg. Call.

  2. From the Settings menu, select Alert Rules.

  3. From the list, locate the rule > select its Alert Name. Its profile is displayed.

  4. Select Edit > locate the setting being edited > select its edit icon.

    To edit additional settings, select NEXT to advance to the next group of settings.

  5. Once complete, select Save.

Related articles