.. _create_spark_service:

Create Webex Teams Service
--------------------------


:ref:`Webex-Teams-Feature-Reference`

Before You Begin
................

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

* a Webex Teams Organization Account Number
* an Access and Refresh token

Both are obtained from the Cisco Webex page. 


Procedure
.........


|create-webex-teams-service-new|


See procedure below for clarity if required:

1.  Log in as provider or reseller administrator.
#.  Make sure that the hierarchy path is set to the correct customer node.
#.  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``
    
#.  Click the **GET TOKENS** link. 
#.  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.
#.  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:
    
    * **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.
       * Refer to 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.
#.  Complete at minimum the other mandatory fields on the **Customer Access** form:

    *  The **Webex Teams Customer Name** field is populated automatically using
       the Customer Name.
    *  Enter the **HTTP Proxy String**. Only if a proxy server is required to connect
       to the Webex Teams cloud, e.g. ``http://[ip address]:port``. 
    *  Enter the **HTTPS Proxy String**. Only if a proxy server is required to connect
       to the Webex Teams cloud, e.g. ``https://[ip address]:port``.

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


.. |create-webex-teams-service-new| image:: /src/images/create-webex-teams-service-new.gif