Skip to main content

Advanced Portal Beam outcomes: Seat and footfall occupancy guide

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 soon, the Kontakt.io Plugin for PortalBeam will include these two additional occupancy outcomes. 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.

Prerequisites

  • A Kontakt.io Kio Cloud account. If your organization doesn't have one, submit a Kontakt.io support request > Request a new account.

  • 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. Required for Portal Beam installation.

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

    App requirements: Apple iPhone or iPad: iOS version 17 or later | Android phone or tablet: version 8 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: 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 Home menu > Partner Apps.

  2. 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.

    Cisco Spaces Partner Apps search results showing the Kio Cloud and Kio Cloud UK apps

  3. Select Activate.

Step 2: Get Cisco Spaces Device Management API Key

This API Key is unique to the Cisco Spaces account.

  1. Log in to your Cisco Spaces account.

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

  3. Select BLE Devices > select the MAC Address of a device.

    Cisco Spaces Device Management BLE Devices tab with a device MAC address selected

  4. From the Beacon Configuration section, select Advance Configuration > select Confirm.

    Cisco Spaces device details with Advance Configuration in the Beacon Configuration section

  5. From the Server API Key section, select the copy icon. You'll need this Server API Key in the next step.

    Cisco Spaces Server API Key section with the copy icon

Step 3: 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.

  1. Sign in to your Kio Cloud account.

  2. From the Kontakt.io Launchpad, select Device Management.

  3. From Add Devices > select Device Federation.

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

    device-federation-window.png

Step 4: 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.

Kontakt.io also activates the Kio Workspace Insights app, where you view Portal Beam seat occupancy and floor footfall 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 5: 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, write down its 12-character MAC address for future reference. Once mounted to the ceiling, it is not visible.

Install seat and footfall Portal Beams with Kio Setup Manager signed in with Kio Cloud Account. Seat and footfall installation isn't available when you sign in with Cisco Spaces Account, which is only for Portal Beam room occupancy. During installation, the app asks for the mounting height, measured from the floor to the ceiling.

Sign in to Kio Setup Manager

Sign in to Kio Setup Manager with Kio Cloud Account before you install seat or footfall Portal Beams.

  1. From your mobile device, open Kio Setup Manager.

    The first time you sign in, or after you reinstall the app, you complete all of the following steps. After you sign in, the app remembers your Region and Tenant ID.

  2. Select a Sign in Method > tap Kio Cloud Account.

    Cisco Spaces Account: for use only when installing Portal Beams for room occupancy integrated with Cisco Spaces.

    Sign in with Kontakt.io QR code: for use only when instructed by the Kontakt.io team.

    Kio Setup Manager Select a Sign in Method screen

  3. Select Region > tap the geographic location of your organization's Kio Cloud account.

    United States: North America and Asia/Pacific locations.

    United Kingdom: UK and European locations.

    Custom Region: only select when instructed by the Kontakt.io team.

    Kio Setup Manager Select Region screen

  4. Enter your organization's Tenant ID, based on how your organization signs in to Kio Cloud:

    • Tenant account (most organizations): enter your organization's Tenant ID > tap Continue. The Tenant ID is the first part of your Kio Cloud sign-in URL, for example https://[Tenant ID].app.cloud.[us or uk].kontakt.io.

      Kio Setup Manager Enter Tenant ID screen

    • Non-Tenant account: if you sign in to Kio Cloud from https://app.cloud.us.kontakt.io or https://app.cloud.uk.kontakt.io, tap I don’t have Tenant ID.

  5. The Kio Cloud sign-in page opens. Sign in with your Kio Cloud user credentials (email and password, or SSO).

Portal Beam seat-level occupancy setup and installation

Complete the following steps to get seat-level occupancy outcomes. A room can have up to 6 seats, the most one Portal Beam can measure.

Setup: add seats to rooms 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 the Kontakt.io Launchpad, select Smart Location.

  2. Go to the floor where the Portal Beam will be installed > select Edit.

  3. Select the Room Outlines tab.

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

  5. From Add seats (max 6), select the number of seats in the room that will be measured > enter a Seat Name/Id for each seat. Each seat needs a name.

    Important: Note the room name and each Seat Name/Id. You'll need these details when you install the Portal Beam with Kio Setup Manager.

  6. Position each seat: on the floor plan, click a numbered seat, move it to the seat's location in the room, then click again to place it.

  7. 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 Kio Setup Manager, signed in with Kio Cloud Account. You will also mount the beam during this step.

  1. Turn on the Portal Beam. On its underside, move the battery switch to the ON position.

  2. Tap Install > Beam > Portal Beam > Seat Occupancy. On Android, the mode is Seats Occupancy.

  3. Scan the Portal Beam's QR code. You can also tap Enter MAC / Unique ID or Scan Nearby Devices.

  4. From Choose location, tap the campus, building, floor, and room where the Portal Beam is being installed > place the Portal Beam on the floor plan.

  5. From Mount the device, enter the mounting height > mount the Portal Beam > tap Next.

    If another Portal Beam is already installed in the room, the app shows its spacing guidance and uses that beam's height. On Android, the app then shows Mounting orientation.

  6. From Assign Seats to Portal Beam, tap a seat > have someone take the seat > tap Capture Image > Add Seat Location > move the green box over the seat > tap Save. Repeat for each seat in the room.

  7. Add a device note > the app displays Installation Success!

Note: On iPhone or iPad, the Portal Beam needs firmware 2.6.7 or later for seat occupancy. If it's older, the app displays Unsupported firmware.

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, the Traffic Footfall Line.

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.

Install Portal Beam for footfall occupancy

Complete this step at the Portal Beam install location with Kio Setup Manager, signed in with Kio Cloud Account. You will also mount the beam during this step.

  1. Turn on the Portal Beam's battery backup. On its underside, move the battery switch to the ON position.

  2. Tap Install > Beam > Portal Beam > Footfall.

  3. Scan the Portal Beam's QR code. You can also tap Enter MAC / Unique ID or Scan Nearby Devices.

  4. From Choose location, tap the campus, building, floor, and room where the Portal Beam is being installed > place the Portal Beam on the floor plan.

  5. From Mount the device, enter the mounting height > mount the Portal Beam > tap Next.

  6. From Traffic Footfall Line, tap Capture Image > check the line and its direction arrow, and adjust the line if needed.

    The line's direction sets which way people count as entering or leaving. You use it when you assign the Portal Beam's Inbound and Outbound Footfall locations in Smart Location.

  7. Add a device note > the app displays Installation Success!

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 the Kontakt.io Launchpad, select Smart Location.

  2. Select Footfall > Add Footfall.

  3. Enter a Footfall Name > select Create.

Assign Portal Beam to its Footfall locations

Each Portal Beam measuring footfall occupancy is assigned to Inbound and Outbound Footfall locations, based on the direction of its Traffic Footfall Line set during installation. A Portal Beam can have more than one of each.

Complete the following steps for each footfall Portal Beam.

  1. From the Kontakt.io Launchpad, select Smart Location.

  2. Go to the floor where the Portal Beam is installed > select Edit.

  3. Select the Infrastructure tab.

  4. From the floor plan, select the Portal Beam.

  5. From Add Inbound Footfall and Add Outbound Footfall, choose the Footfall location for each direction.

  6. Select Save.

Optional: Set up the Kio Workspace Insights app

Once you've installed the Portal Beams, from the Kio Workspace Insights app you'll see seat-level room occupancy and floor-level footfall occupancy outcomes.

Seat-level occupancy: Create Room Types and Match Rooms

Room Types and Room Matching are 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 are where you set the workplace settings for each room type.

Set up Room Types and Room Matching in Company Settings. In Workspace Insights, Room Types and Room Matching are view-only, except a Room Type's Workplace settings, which you can also edit there.

Create Room Types

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

  1. From the Kontakt.io Launchpad, select Company Settings > from Room Management, select Room Types.

  2. Select Create Room Type > enter a Room Type Name (it must be unique) > select Create.

  3. From Room Types, select the name of the Room Type you created > select the Workplace tab > select Edit.

    Company Settings Room Type Workplace tab with Max Capacity, Target Occupancy, and Workplace Type

  4. Set its workplace settings:

    • Max Capacity: the number of seats in the room measured by the Portal Beam. It must match the number of seats added to the room in Smart Location, or the Room Type isn't listed when you match the room.

    • Target Occupancy: the number of occupied seats you aim for in the room. It can't be more than Max Capacity.

    • Workplace Type: select Concentration, for workspaces that can only be occupied by one person, such as a single office or individual seats. Collaboration is selected by default.

  5. Select Save.

You can also edit a Room Type's workplace settings from Workspace Insights: go to Settings > Room Types > select the Room Type > Workplace tab > Edit.

Workspace Insights Room Type Workplace tab with Edit

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 Company Settings > Room Management, select Room Matching.

  2. From All Rooms, select the floor location.

  3. Select Not matched Rooms only.

  4. Select Assign Room Type.

  5. Select the Room > select its Room Type.

  6. From Occupancy Method, select the method that matches the Portal Beam's mode:

    • Occupied Workstations: a Portal Beam installed for seat occupancy.

    • Footfall: a Portal Beam installed for footfall occupancy. Also select the Footfall Space.

  7. Select Assign.

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. For each Footfall Floor, you set its Maximum Capacity and Target Utilization. To create Footfall Floors, your Kio Workspace Insights role must be Administrator.

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 Workspace Insights, go to Settings > Footfall Floors.

  2. Select Create Floor.

  3. From Select Floor, select the floor being measured for footfall occupancy. Only floors that don't have a Footfall Floor yet are listed.

  4. From Assign Footfall, select the Footfall location associated with the floor.

  5. Enter the floor's Maximum Capacity.

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

  6. Enter the floor's Target Utilization, as a number of people. It can't be more than Maximum Capacity.

    Refers to the desired number of people occupying the specific floor space. The app shows it as a percentage of the maximum capacity. For example, if the Maximum Capacity is 200 and the Target Utilization is 150, the Target Utilization is 75%.

  7. Select Create.