Setup guide – Knowledge Base

Setting up the Staff Safe app involves a few required steps. Once this setup is complete, staff can discretely call for help by pressing a button on their Kontakt.io Smart Badge that activates an alert and sends notifications to responders with the staff's real-time location and alert details.

Prerequisites

To complete this setup, the following requirements are must be met.

Assigned user role: You are assigned to the Staff Safe Emergency Call Administrator role. For the advanced setup, you are also required to be assigned to the Company Settings Administrator role.
Infrastructure devices installed: This will vary by your deployment, but requires BLE to Wi-Fi gateways - either Kontakt.io Portal Lights or third-party BLE Access Points. Optionally, Kontakt.io Beam Minis for 100% room-level certainty at low latency (< 3 seconds).
Kontakt.io order claimed: The Smart Badge order is claimed in Kio Cloud Device Management 2.0.

Required setup steps

We recommend completing the tasks in the following order.

Task	Related article
Create Staff Roles and Staff Groups and Add Staff Staff Roles: A categorization of staff that commonly mirrors the types of roles or positions within your organization. Staff Roles apply to metrics, can be assigned to Alert Rules, and staff are required to be assigned to a Staff Role. Staff Roles are the Entity Types within Company Settings. Staff Groups (optional): An additional method to categorize staff. If your deployment requires the "average time to respond metric" that is computed by an alert's first responder, you will need to create Staff Groups. This metric requires responders to be added as Staff and assigned to a Staff Group and badge, and wear their assigned badge onsite at all times. A Staff Group is assigned to the Include Responder setting within Alert Rules. Staff: Each person within your organization that will wear a Kontakt.io Smart Badge must be added to Staff Safe. Staff are assigned to their Kontakt.io Smart Badge (tag), a Staff Role, and optionally a Staff Group. Staff will always be those that require the ability to activate a staff duress alert from their assigned Smart Badge. Staff will not have permissions to sign in to the Kio Cloud platform, which requires a User account. If your deployment includes the "average time to respond metric", that requires responders to also wear a Smart Badge they are required to be added as a Staff, and will also be added as a User that allows them to sign in to the Kio Cloud platform. Note Staff Roles and Staff can also be created and managed from the Kio Cloud Company Settings app. Within Company Settings, Staff Roles are Entity Types and Staff are Entities. For first-time setup, Kontakt.io recommends use of the Company Settings app. Staff Groups are only managed from the Staff Safe app.	Manage staff
Create Alert Rules An Alert Rule defines when an alert is activated by a Smart Badge button press event including the blue, red, or any button, who the alert applies that identifies the staff wearing badges, the location including one to multiple Campuses and Buildings, and the alert notification recipients that identifies the responders. Based on the scope of your deployment, you may have one to multiple Alert Rules. If your deployment includes sending alerts to a third-party system, you will also need to complete the Webhooks advanced setup.	Manage Alert Rules
Add Users A user is someone that requires access to Staff Safe and the Kio Cloud platform. This includes those responsible for the Staff Safe setup and administration, who will be responding to staff alerts, and users that require access to metrics and analytics.	Manage user access to Staff Safe
Assign staff to their Kontakt.io Smart Badges Each badge has a unique MAC address and Unique ID that is linked to the staff assigned to the badge.	Assign badge to staff from Staff Safe
Onboard responders and users Responders are those responsible for responding to staff duress alerts. It's important for them to know how to respond to and manage staff duress alerts. Users are commonly stakeholders interested in alert analytics and metrics.	Quick start guide Respond to or resolve an active alert from the Simple View Kio Staff Safe Alerts mobile: Respond to and resolve active alerts
Onboard staff wearing badges for staff duress alerts It's important for staff to know how to activate an alert, how to properly wear a badge, and how it all works. The Smart Badge button that activates an alert is dependent on your Alert Rules - that being either the blue, red, or either of the buttons.	Guide to activate a staff duress alert

Advanced setup

This setup is dependent on the scope of your deployment and is completed from the Kio Cloud Company Settings app.

Company Settings: Room Management

If your deployment includes the automating the status of staff by their real-time room locations, you will also need to set up Room Management within Company Settings.

Complete the tasks in the following order.

Task	Related article
Create Room Types	Room Type management
Match Smart Location rooms to their Room Type	Room Matching
Create Room Type rules by Entity Types (Asset Type)	Room Type rules

Company Settings: Webhooks

If your deployment includes sending alerts to a third-party system, this requires the set up of Webhooks.

Complete the tasks in the following order.

Task

Create and configure Webhooks

This task is commonly performed by your IT department or integration team.

Webhook management

Assign Webhooks to Alert Rules

This results in alerts being sent to the third-party system - configured within the Webhook.