.. _create-webex-teams-service: Create Webex Teams Service -------------------------- .. _21.1|EKB-8338: .. _21.1|VOSS-725: This procedure adds a Webex Teams service. :ref:`Webex-Teams-Feature-Reference` **Prerequisites**: To allow VOSS Automate to connect to the Webex Teams Cloud API, obtain the following from the Cisco Webex page: * a Webex Teams Organization Account Number * an Access and Refresh token **Perform these steps**: 1. Log in to the Admin GUI as a provider or reseller administrator. 2. Select the hierarchy path to the correct customer node. 3. Select **Services > Webex Teams > Access Token** to display **Webex Teams Account**. The form opens on a separate tab, at the following URL: ``https://us-central1-webex-teams-auth-token.cloudfunctions.net/webex_teams_oauth`` 4. Click the **GET TOKENS** link. 5. In the **Email address** field on the **Cisco Webex** page, enter a valid email address; then, click **Next**. An email address and password are only required the first time you log in to the Cisco Webex site. 6. In the **Password** field on the **Cisco Webex** page, enter a valid password; then, click **Sign In**. 7. View the codes/tokens generated and displayed on the form: * **Organization ID** * **Access Token** (14 days) * **Refresh Access Token** (90 days) .. note:: * VOSS Automate automatically refreshes the access tokens every 7 days. To manually refresh the access tokens, click **GET TOKENS** on the **Webex Teams Account** form or **Action > Refresh Access Token** on the **Customer Access** form. * The Refresh Token is valid for 90 days. The number of valid days remaining for the access token is displayed in the **Refresh Token Expires in** counter on the **Webex Teams Access Token Management for VOSS4UC** page. * See https://developer.webex.com/docs/integrations for more details on access token management. 8. Click on each **Copy** button in turn to copy the item, return to the VOSS Automate tab, and paste in the appropriate field on the **Customer Access** form. Note that the access tokens must also be pasted into the 'Repeat' fields. 9. Fill out, at minimum, the other mandatory fields on the **Customer Access** form under **Account Details**: .. tabularcolumns:: |p{4cm}|p{11cm}| +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Field | Description | +==============================================================================+=============================================================+ | Webex Teams Customer Name | Populated automatically, using the customer name. | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Default Calling Behavior | Can be applied to synced in users, if also set in **Global | | | Settings** (**Automatically apply default calling behavior | | | on Webex Teams user data sync**) | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Use Organization's Domain | Can be enabled if you select option **Calling in Webex | | | Teams (Unified CM)** (same as Webex Teams Control Hub | | | behavior) | | | | | | When selected, you may also enable **Default UC Manager | | | Profile** | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Email Domain for Hybrid Calling in Workspaces | When hybrid calling is enabled for a workspace, a dummy | | | subscriber email domain can be added. | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Subscription ID | Fill out the subscription ID (as seen on the Control Hub | | | portal) to selectively manage multiple subscriptions in | | | multiple sites. If required, fill out the newly managed | | | subscription ID here. | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Site URL | The site URL for Webex Enterprise Edition meeting services. | | | When syncing licenses and subscriptions, VOSS Automate only | | | syncs in subscriptions matching the ID and services from | | | the site. See also :ref:`webex-teams-licenses` | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | Enterprise Content Management Enabled and Jabber Team Messaging Mode Enabled | These settings match the configuration setting on the user | | | user feature of the Webex Teams Control Hub, and apply to | | | the corresponding **Default Calling Behavior** selection: | | | Calling in Webex Teams (Unified CM) and Cisco Jabber app. | | | | | | Note that with these calling behavior options, Quick Add | | | Group Templates for Jabber devices under the Webex Teams | | | group are applied. | | | See :ref:`quick_add_subscriber_group_default_model` | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | UC Manager Profiles | Added for use when managing users. | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | HTTP Proxy String | Required only if a proxy server is required to connect to | | | the Webex Teams cloud, for example: | | | ``http://[ip address]:port`` | +------------------------------------------------------------------------------+-------------------------------------------------------------+ | HTTPS Proxy String | Required only if a proxy server is required to connect to | | | the Webex Teams cloud, for example: | | | ``https://[ip address]:port`` | +------------------------------------------------------------------------------+-------------------------------------------------------------+ 10. Click **Save**. The Webex Teams Service is added. 11. Sync the Webex Teams Users for the customer. To do this, click **Action > Sync Webex Teams Users** on the **Customer Access** form. .. note:: Webex Teams Users can also be synced from **Administration Tools > Data Sync**, and then running the SyncSpark[Customer] data. .. rubric:: Workflow Animation The animation demonstrates how to create a Webex Teams service. |create-webex-teams-service-new| .. |create-webex-teams-service-new| image:: /src/images/create-webex-teams-service-new.gif