.. _webex-app-workspaces: Webex Workspaces ------------------------------ .. _21.1|VOSS-725: .. _21.4-PB1|VOSS-1100: .. _21.4-PB1|VOSS-1144: .. _21.4-PB2|VOSS-1138: .. _24.2-PB1|EKB-21806: .. _25.2|EKB-23107: .. _25.3|EKB-25437: .. _25.3|EKB-25420: .. _25.4|EKB-25307: .. tip:: :ref:`use-action-search-to-navigate-automate` Overview .......... Webex App workspaces can be added in Webex Control Hub and from VOSS. Workspaces can be updated in VOSS and the changes are synced back to the Webex Control Hub. .. image:: /src/images/webex-workspaces.png Details synced in includes calling behavior and calendar settings, as well as phone numbers and device information associated with the workspace. .. rubric:: Workspace devices and line assignments Devices associated with a workspace can support multiple lines. Each line is represented as a device configuration member and mapped to a specific port on the device. Each line is represented as a device configuration member and mapped to a specific port on the device. Line assignment follows port order, where the primary line is mapped to port 1 and additional lines are mapped to subsequent ports (for example, port 2, port 3), depending on device capability. Additional lines can be assigned after device creation using the **Lines** tab on the **Webex Devices** page. This allows workspace devices (for example, meeting room or shared devices) to support multiple call appearances or shared line configurations, in the same way as user-associated devices. .. image:: /src/images/webex-workspaces-detail.png When a sync occurs, existing numbers in the number inventory are updated with workspace details, for example, in the corresponding Usage, Description, and Vendor fields. You can add various types of Webex App workspaces in VOSS, for example, meeting rooms or open spaces. .. rubric:: Related topics * .. raw:: latex Introduction to Cisco Webex App in the Core Feature Guide .. raw:: html Introduction to Cisco Webex App Add a Webex workspace ............................ This procedure adds a Webex workspace, and optionally, adds phone or conference devices. .. note:: Devices added to a workspace are configured with a primary line during creation. Depending on the provisioning workflow (such as Quick Add Webex Device), you can currently configure only one additional line during device creation (a maximum of two lines in total). To configure more lines, you must first create the device and then assign additional lines from the Webex Devices page, if supported by the device model. The number of supported lines depends on the device's available ports or line key buttons. 1. Log in to the VOSS UI as Provider admin, then go to the **Webex Workspaces** list view. #. Click the Plus icon (+) to add a new workspace, then choose the relevant site. .. image:: /src/images/workspaces-add.png #. Fill out details for the new workspace: * Add a workspace name. Once a workspace is added, you can update its name if required. * Define capacity (how many persons the workspace is suitable for). * Select the workspace type for example, desk, focus, huddle, meeting room, or open space. * At **Supported Devices** choose the device type, either *Collaboration devices* or *MPP phones*. .. note:: If the supported device selected is *Collaboration*, you'll be able to add one or more devices. .. image:: /src/images/webex-workspace-collaboration-device.png #. At **Send Device Activation Code To**, fill out the email address(es) where the device type code is sent. .. note:: The device activation code is unique to the 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 system schedule checks the expiration date and generates a new code. When a workspace activation code expires, a scheduled workflow refreshes codes for places without expiry dates or with expired/expiring codes, and continues processing remaining places if individual places fail. The **SIP Address** of the workspace is also shown. #. At **Calling Behavior**, select the workspace calling behavior: * No calling * Free calling (default) * Webex Calling * Third-party SIP URI * Webex Edge For Devices #. If you've chosen *Webex Calling* as the calling behavior, at **Webex Calling Settings**, fill out a phone number and extension. .. note:: Webex Calling settings display on the page *only* when Webex Calling is selected. .. image:: /src/images/webex-calling-settings.png #. At **Calendar Type**, optionally, select a calendar provider (these options are those available from the Scheduling section on the Webex Control Hub - for example, Microsoft Exchange / Office 365, or Google Calendar). If you choose a calendar type, you will need to fill out a workspace email address. #. If the supported device type is *Collaboration*, at **New Devices**, add one or more new devices to the workspace. This allows for activating devices in a workspace using the RoomOS driver: .. image:: /src/images/webex-workspace-collaboration-device.png .. note:: Existing devices in the workspace are shown in the **Devices** group, while all devices display via the **Devices** menu. For each new collaboration device: * Add the current **IP Address** for the Webex device. .. note:: The configured IP address must be reachable by all of the VOSS unified nodes via HTTPS using port 443. * Select the profile to use for configuring the device. .. note:: The profile includes the required parameters for the configuration. Profiles are managed on the Webex App **RoomOS Device Configuration Profiles** page. * 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 Webex Control Hub, by default, Webex 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 Webex Control Hub, locate your device, and access the device via the UI. #. Save your changes. Wait for the transaction to complete. The new workspace and devices are registered with Webex 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 **Webex Workspaces** list view. To view new devices, use the **Action** search to locate the **Webex Devices** page. .. _webex-app-manual-steps: Webex App manual steps .......................... When workspaces are created or updated in VOSS on the **Workspaces** page, the data entered is formatted as a sequence of steps in an email message to be carried out on the Webex App Control Hub. The content of these manual steps for a workspace configuration can be seen as the **Steps** content of the instance from the **Manual Steps** menu. .. rubric:: Related Topics * :ref:`webex-app-workspaces` * :ref:`global-settings` for an email message example. * :ref:`webex-app`