When you receive your Kontakt.io order, it's time to begin your journey with Kontakt.io and Cisco Spaces. Kontakt.io IoT devices deliver multiple use-case solutions from asset tracking, staff duress and safety, patient experience and safety, occupancy, to indoor environmental monitoring.
This guide will walk you through each step, illustrated in the image below, to ensure a successful deployment. If you have any questions or need assistance, please reach out to our support team.
Important: Deploying Portal Beams or Beam Minis? Each outcome has its own deployment guide with all the steps. For Portal Beams for room occupancy, see Deployment guide: Portal Beam room occupancy with Cisco Spaces. For Portal Beams for seat or footfall occupancy, see Advanced Portal Beam outcomes: Seat and footfall occupancy guide. For Beam Minis for room-level certainty, see Beam Mini deployment and installation.
Deployment overview
Prerequisites
Before you begin your deployment, the following prerequisites must be met.
A Kontakt.io Kio Cloud account. If your organization doesn't have one, submit a Kontakt.io support request > Request a new account.
A Cisco Spaces account with an Advantage (ACT) or Premier license. Learn more from the Cisco Spaces Setup Guide.
-
Cisco Spaces: IoT Services (Wireless) prerequisites are met.
This includes controllers added and active, Access Points connected and added to Maps, IoT Manage Streams enabled, and Access Points synchronized.
Refer to the Cisco Spaces: IoT Services Configuration Guide (Wireless) for complete details and instructions.
Cisco Spaces Maps with floor images setup is complete.
Step 1: Claim Kontakt.io order in Cisco Spaces
Claiming a Kontakt.io Order ID within Cisco Spaces adds the order's devices to your Cisco Spaces device inventory. When integrating with Cisco Spaces, Kontakt.io orders are not to be claimed in the Kio Cloud platform.
You'll need the Kontakt.io Order ID provided on the Quick Start Guide included in the order packaging. The Order ID is also provided in your order confirmation emails.
Log in to your Cisco Spaces account.
Go to IoT Services > Inventory.
-
Select Claimed Devices > Claim devices.
-
From Claim Devices, select BLE Tags & Sensors > Next.
-
Enter the Kontakt.io Order ID (it is case sensitive) > select Claim.
Verify the Kontakt.io devices were claimed: from Inventory > Claimed Devices, verify the devices are listed.
Step 2: Activate the Kio Cloud app in Cisco Spaces
This step activates the integration between your Cisco Spaces and Kio Cloud account.
Note: If you have been working with Kontakt.io and we did not include Kio Cloud in your deployment plan, you can skip this step and step 3. Not all solutions require Kio Cloud, such as Indoor Wayfinding.
To learn more about the Kio Cloud platform, please reach out to your Kontakt.io pre-sales engineer or our sales team.
From your Cisco Spaces account, go to the Home menu > Partner Apps.
-
Select Show all Partner Apps > search for Kontakt.io > select the Kontakt.io Kio Cloud app for your geographical location. For US and North America locations, select Kio Cloud and for UK and Europe locations, select Kio Cloud UK.
Select Activate.
Step 3: Get Cisco Spaces Device Management API Key
This step is required when you've activated the Kio Cloud app. This API Key is unique to the Cisco Spaces account.
From your Cisco Spaces account, go to IoT Services > Manage.
-
Select BLE Devices > select the MAC Address of a device.
-
From the Beacon Configuration section, select Advance Configuration > select Confirm.
-
From the Server API Key section, select the copy icon. You'll need this Server API Key in the next step.
Step 4: Synchronize Kontakt.io Devices with Kio Cloud
In this step, using your Cisco Spaces Server API Key, you'll complete a one-time setup to synchronize the Kontakt.io devices claimed in Cisco Spaces with your Kio Cloud account. Once complete, Kio Cloud automatically synchronizes daily with Cisco Spaces Device Management allowing you to also view and manage your devices in the Kio Cloud platform from Device Management.
Sign in to your Kio Cloud account.
From the Kontakt.io Launchpad, select Device Management.
From Add Devices > select Device Federation.
-
From Add Devices via Device Federation, enter in the Cisco Spaces Device Management API Key > select Create.
Step 5: Submit Cisco Spaces map import request to Kontakt.io
This step results in the Kontakt.io team importing your Cisco Spaces Maps into your Kio Cloud Smart Location. Once complete, you can access your maps from Smart Location.
To request a map import, submit a Kontakt.io Support Request.
Please include the following information:
Description: Cisco Spaces map import and activate Kio Workspace Insights app.
Your contact details: name, phone number
Cisco Spaces account detail (admin account)
Your Kio Cloud account email address
The Kontakt.io Order ID claimed within Cisco Spaces
Begin your Kontakt.io IoT journey
Once all of the above steps are complete and Kontakt.io has confirmed the map import is complete, you can begin your journey with Kontakt.io.
With the Kio Cloud app activated from Cisco Spaces, along with your Kio Cloud account and a Kontakt.io support or services subscription, learn more about Kio Cloud data to begin your IoT integration with Kontakt.io.
Ensure your Kontakt.io devices are ready for use, visit the Kio Devices section in our Knowledge Base.
If you have questions or need assistance, reach out to our support team or your Kontakt.io Sales Consultant.
Post-deployment device monitoring and management with Cisco Spaces
From Cisco Spaces, you can monitor and manage your Kontakt.io IoT devices. For complete details, please refer to the Cisco Spaces Runbooks & Knowledge Articles.