Create Webex Teams Service¶
This procedure adds a Webex Teams service.
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:
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 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.
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.
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 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 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 Quick Add Subscriber Groups 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:
|
HTTPS Proxy String |
Required only if a proxy server is required to connect to
the Webex Teams cloud, for example:
|
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.