This is an example enhanced unbooking macro for empty Webex workspaces with added support of handling bookings of different durations, meeting title and organizer names along with a external logging feature to track the macros behaviour.
This macro monitors booking start event and applies a room monitoring unbooking policy based on booking duration, meeting title keywords or organizer name. Below is a breakdown of the how it can handle each type of matched meeting.
In this example duration profile, if the booking has a duration from 0 to 60 minutes, then the macro will begin to monitor the workspace for people presence immedicably and will only monitor the workspace the first 10 minutes of the meeting. If no one detected for 5 minutes during that time, then the macro will unbook the meeting.
{
type: 'duration', // Profile type: duration | keywords | organizer
name: 'Short Meetings', // Name of profile for logging
duration: [0, 60], // Duration of booking in minutes: From zero minutes to 60 minute meetings
monitor: true, // Enable monitoring for this matched profile
startMonitoringDelay: 0, // Number of minutes after the booking starts in which to begin monitoring
stopMonitoringAfter: 10, // Number of minutes after the booking starts in which to stop monitoring
requiredUnoccupiedDuration: 5, // Number of minutes the workspace is unoccupied before unbooking
alertBeforeUnbookingDuration: 1 // Number of minutes before unbooking in which to alert user
}We may want to leave high priority bookings unmonitored so we can use the Meeting Title keyboard profile to disable monitoring in these cases. It is also possible to monitor these booking with different timer delays if required
{
type: 'keywords', // Profile type: Keywords
name: 'Meeting Title Keyword', // Name of profile for logging
keywords: ['Training', 'Test'], // Array of keywords in which to look for in the booking title
monitor: false // Disable monitoring for these matched bookings
}We may want to disable monitoring for bookings made by specific organisers. This example profile will check the Organiser name associated with the booking.
{
type: 'organizers', // Profile type: Keywords
name: 'Organizers Name', // Name of profile for logging
organizers: ['William Mills'], // Array of organizer names to match with bookings
monitor: false // Disable monitoring for these matched booking
}The macro has an external logging feature so admins can monitor and audit how the macro and workspaces are being used and managed. This is disabled by default but can be enabled in the macros config. The data is sent to the logging server as a HTTP POST with a JSON Payload, an example is shown below.
External Logging Configuration:
externalLogging: {
enabled: true, // Enable or Disable External Logging of macro events: true | false
url: 'https://<Your Logging Sever>', // URL to your external logging server
token: '<Logging Server Access Token>' // Bearer Access Token for your external logging server
}External Logging Data Payload:
{
bookingTile: "<Booking Title>",
profile: "<Match Booking Profile>",
action: "<Description of action and outcome taken for Booking>"
}---
title: Monitoring One Hour Meeting With Two Monitors
displayMode: compact
config:
theme: base
themeVariables:
primaryColor: "#00fff0"
primaryTextColor: "#ff0fab"
---
gantt
dateFormat HH:mm
axisFormat %H:%M
section Bookings
%% Initial milestone : milestone, m1, 17:49, 2m
1 Hour Meeting : 09:00, 1h
section Room<br>Presence
Not Detected : 09:00, 09:07
People Entered - Detected : 09:07, 09:40
People Left Early - Not Detected : 09:40, 10:00
section Macro<br>Monitoring
M1 - Unbooks If 15min Unoccupied : 09:00, 09:15
M2 - Unbooks If 10min Unoccupied : 09:30, 10:00
section Macro<br>Events
%% Triggers If No One Detected For 15min : 09:00, 15m
Starts Monitor :milestone, 09:00,
People Detected :milestone, 09:07,
Stops Monitor - No Action Taken :milestone, 09:15,
Starts Monitor :milestone, 09:30,
No Dection :milestone, 09:40,
10 Min Unoccupied - Unbooking :milestone, 09:50,
- Webex Device with RoomOS 11.x or above
- Web admin access to the device to upload the macro
- Download the
unbook-workspace.jsfile and upload it to your Webex Devices Macro editor via the web interface. - Configure the macros monitoring policies, presence detection and external logging (optional) as required, there are comments for each field to help with the configuration.
- Enable the Macro on the editor.
*For more demos & PoCs like this, check out our Webex Labs site.
All contents are licensed under the MIT license. Please see license for details.
Everything included is for demo and Proof of Concept purposes only. Use of the site is solely at your own risk. This site may contain links to third party content, which we do not warrant, endorse, or assume liability for. These demos are for Cisco Webex use cases, but are not Official Cisco Webex Branded demos.
Please contact the WXSD team at [email protected] for questions. Or, if you're a Cisco internal employee, reach out to us on the Webex App via our bot ([email protected]). In the "Engagement Type" field, choose the "API/SDK Proof of Concept Integration Development" option to make sure you reach our team.