[Index]

Model: relation/SparkCustomer

Customer Access

Webex Teams Feature Reference

Before You Begin

For VOSS-4-UC to connect to the Webex Teams Cloud API you need:

Both are obtained from the Cisco Webex page.

Procedure

See procedure below for clarity if required:

  1. Log in as provider or reseller administrator.

  2. Make sure that the hierarchy path is set to the correct customer node.

  3. Choose Services > Webex Teams > Access Token to open the Webex Teams Account form on a separate tab, i.e it opens the following URL:

    https://us-central1-webex-teams-auth-token.cloudfunctions.net/webex_teams_oauth

  4. Click the GET TOKENS link.

  5. Enter a valid Email address in the Email address field on the Cisco Webex page and click Next. An Email address and password are only required the first time you login to the Cisco Webex site.

  6. Enter a valid password in the Password field on the Cisco Webex page, and click Sign In. The following codes/tokens are generated and displayed on the form:

    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.
    • Refer to https://developer.webex.com/docs/integrations for more details on access token management.

  7. 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.

  8. Complete at minimum the other mandatory fields on the Customer Access form:

  9. Click Save to add the Webex Teams Service.

What to Do Next

Sync the Webex Teams Users for the customer by clicking Action > Sync Webex Teams Users on the Customer Access form.

Webex Teams Users can also be synced from Administration Tools > Data Sync, and then running the SyncSpark[Customer] data.

Customer Access

Full HTML Help

This procedure adds the Cisco Webex service (Webex Control Hub instance).

Prerequisites:

See the Network Device Lists (NDLs) topic in the Core Feature Guide.

Important

For users upgrading to release 21.4-PB2, existing access tokens need to be refreshed in order to update permissions for newly added workspace_locations.

To create the Cisco Webex service:

  1. Log in to the Admin GUI as a provider or reseller administrator.

  2. Select the relevant customer hierarchy.

  3. Go to (default menus) Apps Management > Webex Control Hub Access (or search for the page) to open the list view of all configured Webex Organizations.

    Note

    Existing accounts added before Automate 21.4-PB3 will show the internal account ID as the Organization Account Number, while accounts added from Automate 21.4-PB3 onwards, show the external account ID.

  4. Click the Plus icon (+), then, on the new record page:

    Note

    You'll need to add the Webex organization account details to Automate before access tokens can be obtained.

  5. Click Save.

    Note

    When adding a new Webex Control Hub Access entry for a customer, data syncs and schedules are automatically created. Deleting a customer's Webex Control Hub Access automatically deletes these data syncs and schedules.

  6. Once the new Webex organization is saved, return to the created account to view (in the Access Tokens section), the Connect to Webex Control Hub link that is used to request the tokens.

  7. Click the Connect to Webex Control Hub link to obtain the access tokens for the Webex Control Hub account, and to be redirected to the Automate Transactions page.

    Note

    When first using this link, a Webex admin user (with sufficient privileges) must log in and accept the API authorization scope that Automate requires for integration.

  8. On the Transactions page, monitor progress for retrieving the access tokens.

    Note

    • Syncing of roles and licenses into Automate is included in this transaction.

    • Once the transaction completes, you can view expiry times for the access token and for the refresh token.

      • Automate automatically refreshes the access tokens every 7 days for 90 days, that is, until the expiry of the Refresh Token.

      • The Refresh Token is valid for 90 days. You can use the Connect to Webex Control Hub link to refresh it. Automate General Settings provide options for Webex App Tab to send impending expiry notifications and messages. See: Global Settings.

        For more information around access token management, see https://developer.webex.com/docs/integrations

Related Topics

This relation implements the workflows to manage Spark Customer connection parameters and enabled services.

Model Details: relation/SparkCustomer

Title Description Details
Customer Name * Name of this customer
  • Field Name: name
  • Type: String
Organization Account Number This can be found when logging into the Webex Control Hub portal under the Account menu. E.g. 000fd0e4-83ef-d398-be23-d06998580fed
  • Field Name: account_number_external
  • Type: String
Admin Account Email This is the email address of the account used to generate the access token.
  • Field Name: account_email
  • Type: String
Organization Account Number (Internal) This is the internal API id for the organization. This is automatically resolved from the external account number.
  • Field Name: account_number
  • Type: String
Default Calling Behaviour This is the default calling behaviour for the organization.
  • Field Name: default_calling_behaviour
  • Type: String
  • Choices: ["Calling in Webex App", "Calling in Webex App (Unified CM)", "Cisco Jabber app", "Third-Party app"]
Email Domain for Hybrid Calling in Workspaces This is the email domain that will be used when creating a Unified CM user associated with a Workspace in Webex App Control Hub for hybrid calling.
  • Field Name: email_domain
  • Type: String
Directory Synchronization Enabled This setting must be enabled if the Organization has been enabled for Directory Synchronization on the Webex Control Hub side.
  • Field Name: dirsync_enabled
  • Type: Boolean
Please Note Field to display notes to the user.
  • Field Name: notes
  • Type: String
Authorize Webex This is the link to initiate the Webex OAuth flow to obtain tokens.
  • Field Name: token_link
  • Type: String
  • Format: link
Admin Access Token This is the Access Token provided when logging into Webex App Developer portal. This token is valid for 14 days. The Refresh token can be used to generate a new Access Token.
  • Field Name: token
  • Type: String
  • Is Password: True
Refresh Token This is the Refresh Token provided when logging into Webex App Developer portal. This token will be used to create a new access token. The refresh token is valid for 90 dyas.
  • Field Name: refresh_token
  • Type: String
  • Is Password: True
Access Token Expires At Time when the Access Token will expire.
  • Field Name: access_token_expires
  • Type: String
Refresh Token Expires At Time when the Refresh Token will expire.
  • Field Name: refresh_token_expires
  • Type: String
HTTP Proxy String HTTP Proxy string e.g. http://10.10.10.10:8123
  • Field Name: http_proxy
  • Type: String
HTTPS Proxy String HTTPS Proxy string e.g. https://10.10.10.10:8123
  • Field Name: https_proxy
  • Type: String
  • Is Password: True
  • Store Encrypted: True
Sync on Create Sync this organization's roles and licenses from Control Hub on creation.
  • Field Name: sync
  • Type: Boolean
Shadow
  • Field Name: shadow.[n]
  • Type: Array
  • Cardinality: [0..1]
Name *
  • Field Name: shadow.[n].name
  • Type: String
  • MaxLength: 1024