Using Mapiq's Cisco Wi-Fi integration, you can access valuable information about occupancy levels within your building. Mapiq offers a seamless integration with Cisco Wi-Fi for easy access to this data.
In this article, we will cover some prerequisites and provide a comprehensive, step-by-step guide on enabling the integration and linking your buildings across both platforms.
Pre-Requisities
Mapiq Enterprise subscription;
Cisco Spaces EXTEND (or ACT) license;
Devices registered on Cisco Spaces;
Cisco Infrastructure and network (Meraki and/or Catalyst);
Mapiq integrates with Cisco Wi-Fi data through the Firehose API provided by the Cisco Spaces environment. Organizations with the necessary setup can activate Mapiq's app in the App Spaces Center, where you will be guided through the activation process.
In the Cisco Spaces App Center there are two Mapiq apps available. This article describes the process of setting up Cisco for office attendance, called Mapiq office attendance which are used for showing office attendance in the Cisco Wi-Fi reports in our analytics. The second app, is for meeting room occupancy used on the Here & Now page. You can find more information about that here.
Enabling the Cisco Wi-Fi Integration
Navigate to the Cisco Spaces App Center.
Search for “Mapiq” and select the “Mapiq Office Attendance” app, then click “Activate”.
Review and provide consent for the required permissions, granting Mapiq access to:
Device Presence
Location Information Change
Activation Events
Select the appropriate locations within your Cisco Spaces location hierarchy to make the data available for Mapiq. If not all Cisco locations in the Cisco portal use Mapiq, you can also select a subset of locations.
Confirm if you are an existing Mapiq-Cisco customer:
If yes, sign in to your Mapiq subscription. This will associate your Cisco Spaces tenant to the Mapiq subscription and enables the Cisco Spaces integration in your Mapiq Admin portal.
If no, select the respective option, and an email will be directed to Mapiq's Sales Team ([email protected]) for further assistance.
Integration Status
In the Settings menu under the integrations tab, subscription administrators can access an overview of the all integrations and their status.
For both Cisco Webex & WiFi integrations:
The toggle should be set to ON if the Cisco-Mapiq App (either one or both) is successfully activated in the Cisco App center and the Occupancy feature is enabled in the accounts portal.
If either toggle is set to OFF, the corresponding app has not been activated yet in the Cisco App center.
If you don't see either one of the Cisco toggles at all, you are not an Enterprise customer.
If you see none of the Occupancy integrations, you do not have the Occupancy add-on.
Linking Cisco Buildings with Mapiq
After successfully activating the Cisco Wi-Fi app, subscription administrators need to link the Cisco Location to its corresponding building in Mapiq.
Follow the steps below to link Cisco Locations with Mapiq:
Go to the Integrations overview in the Settings page.
Click on the Cisco Wi-Fi row ( ⚠️ this can only be done if the Cisco Wi-Fi app is activated successfully in the Cisco Spaces App Center), and a side panel will open with an overview of all Cisco locations, which Mapiq were granted access to in Cisco Spaces App.
Select the Cisco location you want to link to a Mapiq building. Mapiq will suggest buildings based on name but only for those buildings that are published Mapiq buildings.
Optional: If you also want to receive attendance insights on floor level, you can also link the floors. Again, Mapiq will suggest a corresponding floor, if applicable.
Once locations are successfully linked, a link icon will be shown on the top level. All child nodes (sub levels) are greyed out and non-selectable.
If you accidentally linked the incorrect buildings, go to the building in Mapiq with the incorrect Cisco building association, open the linking menu, and deselect the Cisco building.
Note: Not all locations in the Cisco location hierarchy can be expanded. Mapiq checks whether a Cisco location is listed as a “building” and has child nodes.
Note: If a link between buildings is broken, all previously linked child nodes (e.g. floors) are also broken up.
Calibrating Logic
As Mapiq receives the device count from Cisco based on connected devices to the company's network, we want to support the admin also understanding how this relates to the number of people counted.
To ensure accurate data interpretation, Mapiq sets a default ratio of 2 to 1 for device count to people count. This ratio can be manually adjusted based on admin preferences, and the calibrated people count is used in reports.
The calibrated people count (either manually entered or based on historical data) is used in the reports.
💬 Need More Help?
If you’d like extra assistance, reach out via the Messenger (question mark in the corner) and chat with our support team, or email us at [email protected].
We’re always ready to help! 😉