Cisco sensor data - Integration guide
Cisco devices are managed centrally through the Webex Control Hub, providing a streamlined way to configure and monitor your devices.
Webex Webhooks use token-based authentication, allowing GoBright to securely validate each incoming request using a shared token. This approach ensures a simple implementation while maintaining a secure and reliable endpoint.
In Cisco terminology, a Workspace corresponds to a Space in GoBright. Within a single workspace, multiple devices can be configured and managed, offering flexibility in how meeting rooms and resources are set up.
Cisco provides three event types for GoBright:
- Room in use
- People presence (not supported yet)
- People count (not supported yet)
Connect Cisco sensor data to GoBright in 3 steps
- Sign in at admin.webex.com and add your Cisco devices
- Set up the Integration in the GoBright portal
- Couple each room in GoBright to the corresponding Cisco sensor in the GoBright Portal
Step 1: Sign in at admin.webex.com to add Cisco devices
- Sign in at admin.webex.com.
- In the left menu bar click on Devices and add your devices.
- Select Shared usage and press Next.
- Choose to set up for existing or new workspace with the correct room details.
- Choose the device you want to add.
- Select the services needed for this workspace and activate your device.
Titel
- In the GoBright Portal, at the right top, navigate to the Admin center.
- Select Integrations and press the Add button
- Give the integration a name and in the External system pulldown menu choose Sensoring Cisco.
- Press Generate Credentials.
- The necessary WebHook URL and Token are generated.
- Copy them to a temporarily safe location and press Save.
- Go back to your Webex Control Hub and select Workspaces in the menu on the left and click on Add – integration and select Connect webhook.
- Give the integration a name, paste the generated URL from the GoBright Portal integration page.
- Choose Authentication token as Authentication.
- ! Type the word Bearer in the token field following by one space and then paste the generated token from the GoBright integration page and click on Validate and save.
- Go to Select xAPIs and tick these 3 boxes.
Titel
- In the GoBright Portal, at the right top, navigate to Meet-Work-Visit.
- Navigate to Settings – Devices.
- Navigate to Sensors and press Add.
- Select the room (workspace) where the sensor is located and choose Cisco sensor under Type.
- In the Integration pulldown menu select the previously created Cisco integration.
- In the Workspace ID field fill in the correct Cisco sensor ID.
- Explained in the next step where you can find it.
- The Area ID / Location ID of the room (workspace) can be found in the Webex Control Hub. In the left-hand menu navigate to Workspaces and click on the Workspace that corresponds with the one in the GoBright Portal.
- Copy the Workspace ID from the URL by selecting it, click right mouse button and select copy.
- Go back to the GoBright Portal, right click in the Workspace ID field and paste the ID and Save.
- Enjoy your Cisco room occupancy detection in your GoBright system!