Skip to main content

Advanced Portal Beam outcomes: Seat and footfall occupancy guide

  • Updated

Kontakt.io Plugin + Cisco Spaces + Kio Cloud

In addition to room occupancy, a Kontakt.io Portal Beam can measure seat and footfall occupancy.  To get room seat-level or footfall floor-level occupancy outcomes, you'll need to complete additional integration steps. These steps include Kontakt.io's Kio Cloud platform setup and Portal Beam installation with Kontakt.io's Kio Setup Manager mobile app.

Note

Coming in 2025, the Kontakt.io Plugin will include these two additional Portal Beam occupancy outcomes, along with the Kio Workspace Insights app, from Cisco Spaces. These outcomes will be a seamless integration like the Portal Beam room occupancy outcomes available in Cisco Spaces today.

If you have any questions or need assistance, please reach out to our support team.

Topics include: 

Prerequisites

  • Portal Beam room occupancy setup and installation steps are complete. 

    This includes activating the Kontakt.io Plugin and claiming your Kontakt.io order in Cisco Spaces.

  • Kio Setup Manager mobile app. Required for Portal Beam installation.

    To download the app, go to the App Store or Google Play. Search for Kio Setup Manager app-icon.png.

    App requirements: Apple iPhone or iPad: iOS version 15 or later | Android phone or tablet: version 5.0 or later | Bluetooth enabled (on) | Internet connection

  • For Footfall occupancy, a Portal Beam must be externally powered; battery power is for backup purposes only. Required AC power adapter: 110-220VAC to 12VDC power supply, DC jack 5.5mm.

Step 1: Get a Kio Cloud account

If you already have a Kio Cloud account, proceed to the next step.

To create a new account, from a web browser go to https://cloud.kontakt.io/register

If you’re located in the United Kingdom/Europe, go to https://cloud.uk.kontakt.io/register

A Kio Cloud account activation is sent to your email address. It may take a few minutes for the email to arrive. Please be sure to check your junk/spam folder. The email is sent from hello@kontakt.io.

registration.png

Step 2: Activate the Kio Cloud app in Cisco Spaces

This step activates the integration between your Cisco Spaces and Kio Cloud account.

  1. From your Cisco Spaces account, go to the App Center.

  2. Locate and select the the Kontakt.io Kio Cloud app for your geographical location.

    US and North America locations: select Kio Cloud

    UK/Europe locations: select Kio Cloud UK.

    app-center-kio-cloud.png

  3. Select Activate.

Step 3: Get Cisco Spaces Device Management API Key

  1. Log in to your Cisco Spaces account.

  2. From your Cisco Spaces account, go to IoT Services > Device Management.

    DM-API-Key-step1.png

  3. From the top menu, select Devices > select the Mac Address of a device > from the Beacon Configuration section, select Advance Configuration > select Confirm.

    DM-API-Key-step2-advanced-confg.png

  4. From the Server API Key section, select Copy to clipboard. You'll need this API Key in the next step.

    DM-API-Key-step4-get-api-key.png

Step 4: Synchronize Kontakt.io Devices with Kio Cloud

In this step, using your Cisco Spaces Device Management 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 view and manage your devices from either platform.

  1. Sign in to your Kio Cloud account.

    US region: go to https://cloud.kontakt.io

    UK region: go to http://cloud.uk.kontakt.io

  2. From your Kontakt.io Launchpad, select Device Management 2.0.

  3. From the left menu, go to Add Devices > select Device Federation.

  4. From the Add Devices via Device Federation, enter in your Cisco Spaces Device Management API Key > select Create.

    device-federation-window.png

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.

The Kontakt.io will also activate the Kio Workspace Insights app to view the Portal Beam real-time seat or floor traffic occupancy.

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

Step 6: Install Portal Beams

Once you've received confirmation that the map import is complete, you can begin to install your Portal Beams.

Important

Before installing a Portal Beam, be sure to write down its 12-character MAC address for future reference. Once mounted to the ceiling, it is not visible.

During installation, you are required to provide the ceiling height of the Portal Beam mounting location.

Portal Beam seat-level occupancy setup and installation

Complete the each of the following steps to to get seat-level occupancy outcomes. A single Portal Beam can measure up to a maximum of 6 seats.

Setup: add seats to room locations in Smart Location

Unique to seat-level occupancy, you need to create the seats within each room where a Portal Beam will measure seat-level occupancy.

Complete the following steps for each room where a Portal Beam is measuring seat-level occupancy.

  1. Sign in to Kio Cloud > from your Launchpad, select Smart Location.

    US region: go to https://cloud.kontakt.io

    UK region: go to http://cloud.uk.kontakt.io

  2. Navigate to the floor where the Portal Beam will be installed.

  3. Select Configure Floor.

  4. From the top menu, select Room Outlines.

  5. From the floor plan, select the room where the seat-level Portal Beam will be installed.

  6. From Add seats, select the number of seats in the room that will be measured > enter a Name/ID for each seat.

    IMPORTANT: take note of the room name and each seat name/ID. When installing the Portal Beam with the Kio Setup Manager app, you'll need these details.

  7. From the floor plan, each seat is identified as a GREEN circle. You can move each seat (green circle) within the room to identify its actual location.

    TIP You may need to zoom in on the floor plan to move the seats, select the + button.

  8. When the room's seats are set, select Save.

Install Portal Beam for seat-level occupancy

Complete this step at the Portal Beam install location with the Kio Setup Manager mobile app. You will also mount the beam during this step.

  1. Power ON the Portal Beam. From its underside, move the battery switch to the ON position.

  2. Tap Install Devices > Beam > Portal Beam.

  3. Set its mode to Seat.

  4. Scan its QR Code.

  5. Mount the Portal Beam.

  6. Follow the in-app guided steps.

Portal Beam footfall install and setup

For floor-level footfall occupancy, a Portal Beam must be installed at all floor entrances or interior spaces to count people as they pass through its invisible threshold line.

Install Portal Beam for footfall occupancy

Complete this step at the Portal Beam install location using the Kio Setup Manager mobile app. You will also mount the beam during this step.

  1. Open the Kio Setup Manager app > from Select a Sign in Method, tap Kio Cloud account.

  2. From Select Region, tap the region of your Kio Cloud Account.

  3. Tap Install Devices > Beam > Portal Beam.

  4. Set its mode to Footfall.

  5. Scan its QR Code.

  6. Mount the Portal Beam.

    For Footfall occupancy, a Portal Beam must be externally powered; battery power is for backup purposes only. Required AC power adapter: 110-220VAC to 12VDC power supply, DC jack 5.5mm.

    Before mounting, power ON its battery-backup power. From its underside, move the battery switch to the ON position.

  7. Follow the in-app guided steps.

Setup: Add Footfall locations in Smart Location

Footfall locations are virtual spaces that identify the floors where footfall occupancy is measured. For example, if you are measuring footfall on three floors of a building, each floor must be designated as a Footfall location, such as Bldg A Flr 1, Bldg A Flr 2, and Bldg A Flr 3.

Add a Footfall location for each floor-level location where footfall occupancy will be measured.

  1. Sign in to Kio Cloud > from your Launchpad, select Smart Location.

  2. From the left menu, select Footfall. You will now add a Footfall location for each floor where Portal Beams are installed - measuring people footfall occupancy within the floor.

  3. Select + FOOTFALL > enter Name > select Create.

Assign Portal Beam to its Footfall location

Each Portal Beam measuring footfall occupancy is required to be assigned to either an inbound or outbound Footfall location. This is determined by the orientation of its thermal camera eye and its threshold line set during installation.

Complete the following steps for each footfall Portal Beam.

  1. From your Kio Cloud Launchpad, select Smart Location.

  2. Navigate to and select the floor where the Portal Beam is installed >select Configure Floor.

  3. From the top menu, select Infrastructure.

  4. From the floor plan map, locate the room where the Portal Beam is installed > from the floor map, select the Portal Beam.

  5. From its settings, assign an Inbound or Outbound Footfall location; which is the floor where the Portal Beam is located.

  6. Select Save.

Step 7: Set up the Kio Workspace Insights app

Once this step is complete complete, from the Kio Workspace Insights app you'll experience room-level seat occupancy and footfall floor-level occupancy outcomes.

Seat-level occupancy: Create Room Types and Match Rooms

Room Types and Room Matching is a fundamental component of the Kontakt.io Kio Apps. Room types are user-defined categories that are used to match your Smart Location rooms to their room type and is where you set the workplace occupancy rules for each room type.

Create Room Types

Complete the following steps for each room type where a Portal Beam is measuring occupancy.

  1. From your Kio Cloud Launchpad, go to Company Settings > from the Room Management menu, select Room Types.

  2. Select CREATE ROOM TYPE, enter its Name (must be unique; duplicate are not allowed) > select CREATE.

  3. From the list of Room Types, select the Name of the Room Type created > select Workplace > select Edit.

  4. Set its settings

    Max Capacity: quantity of seats within the room measured by the Portal Beam.

    Target Occupancy: quantity of seats in the room measured by the Portal Beam.

    Workplace Type: set to Concentration; workspaces that can only be occupied by one person. For example, a single office or a workspace with seats that can be occupied by one person.

  5. When done, select Save.

Match Rooms to their Room Types

Complete the following steps for each floor location where a Portal Beam is measuring seat-level occupancy.

  1. From the Company Settings Room Management menu, select Room Matching.

  2. Select the floor location.

  3. Select Not matched rooms only.

  4. Select Assign Room Type.

  5. From the list, Select the room.

  6. Select is assigned Room Type.

  7. Select the Occupancy Method.

    Occupied Workstations: Portal Beam installed in room is set to seat-level occupancy mode.

    Footfall: Portal Beam installed in room is set to footfall mode.

    People in Room: Portal Beam installed in room is set to room occupancy mode.

Footfall occupancy: Create Footfall Floors

A Footfall Floor associates a Smart Location floor and a virtual Footfall location to deliver Footfall Analytics within Workspace Insights. And for each Footfall Floor, you will set its Maximum Capacity and Target Utilization.

Complete the following steps for each floor where floor-level occupancy is being measured - where Portal Beams are installed at each entry location within the floor.

  1. From the Settings menu, select Footfall Floors.

  2. Select Create Floor.

  3. Select the floor being measured for footfall occupancy.

  4. Select the Footfall associated to the floor.

  5. Set the Maximum capacity of the floor.

    Refers to the highest number of people that can safely and comfortably occupy the specific floor space at any given time.

  6. Set the Target Utilization of the floor.

    Refers to the desired level of people occupying the specific floor space, expressed as a percentage of the maximum capacity. For example if the Maximum Capacity is 200, if the Target Utilization is set to 150, this results in a Target Utilization percentage of 75%.

  7. Select Save.

Related articles