.. _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`
**Prequisites**:
To allow VOSS-4-UC 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.
#. Select the hierarchy path to the correct customer node.
#. 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``
#. Click the **GET TOKENS** link.
#. 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.
#. In the **Password** field on the **Cisco Webex** page, enter a valid password; then, click
**Sign In**.
#. View the codes/tokens generated and displayed on the form:
* **Organization ID**
* **Access Token** (14 days)
* **Refresh Access Token** (90 days)
.. note::
* VOSS-4-UC 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.
#. Click on each **Copy** button in turn to copy the item, return to the VOSS-4-UC
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.
#. Fill out, at minimum, the other mandatory fields on the **Customer Access** form
under **Account Details**:
=================================================== =============================================================================
Field Description
**Webex Teams Customer Name** Populated automatically, using the customer name.
**Default Calling Behaviour** Can be applied to synced in users, if also set in
**Global Settings** (**Automatically apply default calling
behaviour 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-4-UC only syncs
in subscriptions matching the ID and services from the site.
See also :ref:`webex-teams-licenses`
**Enterprise Content Management Enabled** and These settings match the configuration setting on the
**Jabber Team Messaging Mode Enabled** user feature of the Webex Teams Control Hub, and
apply to the corresponding **Default Calling Behaviour**
selection: Calling in Webex Teams (Unified CM) and Cisco Jabber app.
Note that with these calling behaviour 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``
=================================================== =============================================================================
#. Click **Save**. The Webex Teams Service is added.
#. 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