Model: data/RoomosDeviceConfigurationProfile

Webex App Workspaces

Overview

Webex App workspaces are synced in from a Webex Control Hub.

This includes Calling Behaviour and Calendar settings, as well as Phone Numbers and Devices information associated with the workspace.

Upon sync, existing numbers in the Number Inventory will also updated with workspace details, for example in the corresponding Usage, Description, and Vendor fields.

You can define Webex App workspaces of various types in VOSS Automate, for example, meeting rooms or open spaces.

Add a Webex App Workspace

This procedure adds a Webex App workspace, and optionally, adds devices.

Note

You can add devices when adding a new workspace or when updating an existing workspace.

In the Admin Portal, go to (default menus) Cisco Webex App > Workspaces.
Choose the relevant hierarchy.
Provide a workspace name, and capacity, and from the Type field, choose the workspace type.
In the Send Device Activation Code To field, fill out the email address(es) where the device type code is sent.

Note

This code is unique to this created workspace and is entered into the device itself.

Once the code is created, the Device Activation Code (read only) value is returned and shown, as well as its Device Activation Code Expiration Date.

A VOSS Automate schedule checks the expiration date and generates a new code. The SIP Address of the workspace is also shown.
In the Calling section, choose the calling behavior (free or hybrid).
Note

The hybrid calling option displays additional fields where you need to choose a site and an available directory number, which then generates a mail ID is generated from CUCM. The auto-generated value in the Mail ID from Unified CM field uses the following:

wt_ + <random-number> + the email hostname set up for the Webex App service

For example, wt_886821663180@myhost.com.

A subscriber user for the device is then added at the selected site, with the following:
- User Id and Last Name: wt_886821663180
- First Name: workspace Name
- Primary Extension: Directory Number
- Phone: Spark Remote device with workspace specific settings
Once the device code is entered, the page displays details of the device associated with the workspace in the Devices group, for example: Product, Connection Status and IP Address. A link to the device is then also available, to show details (read only) as listed under the Devices menu for Webex App.
At Calendar section, you can add select a Calendar provider as available from the Scheduling section on the Webex Control Hub.
At New Devices, you can add one or more new devices to the workspace. This allows for activating devices in a workspace using the RoomOS driver.
1. Add the current IP Address for the Webex device.
  
  Note
  
  The configured IP address must be reachable by all of the VOSS Automate unified nodes via HTTPS using port 443.
2. Select the Profile to use for configuring the device.
  
  Note
  
  The profile includes the required parameters for the configuration. Available profiles are managed via (default menus) Webex App > RoomOS Device Configuration Profiles.
3. Add the device Username and Password if needed.
  
  Note
  
  You can add a device with the default username, admin, and no password. However, it is recommended that you add a second user on the device since, when the device registers with the Control Hub, by default, Control Hub disables the default username (admin) as part of the registration process, which prevents you from logging back in to the device using its IP address, unless you've added a second user. For example, without the second user, reset via the Admin Portal will not work because you will need to provide a username and password. If the default username is disabled, go to the Control Hub, locate your device, and access the device via the UI.
Existing devices in the workspace are shown in the Devices group, while all devices are shown from the Devices menu.
Save your changes. Wait for the transaction to complete.
- The new workspace and devices are registered with Control Hub, which assigns an activation code. The activation code is used to make a second connection to the device local IP address to run the activation step with the configuration you specified in the configuration blocks.
- In the Admin Portal, you can:
  - View the new workspace in the the Workspaces list view via (default menus) Webex App > Workspaces, or type Workspaces in the Admin Portal search bar).
  - View new devices via (default menus) Webex App > Devices (or type Devices in the Admin Portal search bar).

Workspace Call Settings

Synced Webex Workspaces are maintained in VOSS Automate in the relation/WebexWorkspaceCallSettings model, and will show from the Workspace Call Settings menu list - with corresponding Webex location if available.

Note

Settings cannot be added or removed.

RoomosDeviceConfigurationProfile

Model Details: data/RoomosDeviceConfigurationProfile

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title					Details
Name *					Field Name: name Type: String
	Configuration Blocks				Field Name: configuration_blocks.[n] Type: Array
		Name *			Field Name: configuration_blocks.[n].name Type: String
		Body			Field Name: configuration_blocks.[n].body Type: String
			Values		Field Name: values.[n] Type: Array
				Name *	Field Name: configuration_blocks.[n].values.[n].name Type: String
				Value	Field Name: configuration_blocks.[n].values.[n].value Type: String
				XML Escape	Field Name: configuration_blocks.[n].values.[n].xml_escape Type: Boolean