Create Webex Teams Service¶
This procedure adds a Webex Teams service.
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:
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 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.
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.
Workflow Animation
The animation demonstrates how to create a Webex Teams service.