How to setup the Cisco Bar Integration

Before you begin setting up the integration, ask the Flowscape Support Team to provide the following information:

• Environment prefix
• Realm UUID

Create a Cisco sensor provider in the admin portal

In the Flowscape Admin Portal:

• Go to Integrations → Sensor Providers and press “Create“.
• Select “Cisco Workspace“.
• Give the provider a fitting name, eg. "Cisco integration"
• Generate an API secret, and enter this into the “API Token“ field. This will be used later on.
  • The API secret can be a randomly generated UUID. Can be done in a terminal or using a resource like Online UUID Generator Tool.
• Press “Create”.

Create webhook in Webex Control Hub

To set up a Cisco integration, a webhook has to be created in Webex Control Hub for each workspace they want to use.

Go to https://admin.webex.com/overview and navigate to Workspaces → Integrations → Add Integration and select “Connect webhook“.

For the “General information“ section, enter the following:

• Name: Flowscape
• URL: https://<environment-prefix>.flowscape.se/cisco/notify/realm/<realmUuid>/provider/<providerUuid>
  • Environment prefix: Provided by Flowscape Support
  • Realm UUID: Provided by Flowscape Support
  • Provider UUID: Can be accessed through the Flowscape admin portal under Integrations → Sensor Providers from the field “Flowscape ID“. Make sure that this field is selected under “active columns“ if you cannot see it.

• Authentication:
  • Method: Authentication token
  • Value: <token-value>. This is the value we entered as “API Token“ for the Cisco integration in the Flowscape Admin Portal in the previous step.

For the “Select xAPIs“ section, select “RoomAnalytics PeopleCount Current“.

Finally, press “Validate and connect“

Create sensors in the admin portal

Make sure that all devices have “Room analytics: People counting out of call“ enabled.

First we will need the device UUID:s and corresponding rooms from the client. These can be obtained by using the /v1/devices API. Can be accessed via their docs: https://developer.webex.com/docs/api/v1/devices/list-devices .

You might receive data from the API for different product types for the same asset, make sure to collect the UUID from the correct Product type “Cisco Room Bar”.

The IDs will be listed as Base64, you can use this tool to decode it: https://www.base64decode.net/

After decoding, you should get the correct format as a GUID, example: 48f84ca1-6e68-4c17-ad62-0cb68c9762d8

(Note: I do not have access to a Cisco workspace with devices to investigate this, but this is so far the only way I know to access the UUID:s).

In the admin portal, for each device:

• Go to Devices → Sensors and press “Create“.
• Enter
  • Name of device
  • Region
  • Site
  • Office
  • Floor
  • Asset (room to be monitored)
  • Provider (the one created in the first step "Cisco integration")
  • Provider ID. Enter the UUID for the device which as displayed in the result from the /v1/devices API call.
• Press “Create“