Support Portal

Introduction

This article will provide your team with a method of adding Webex Control Hub registered Video Systems to your Synergy SKY Management Suite. It's a streamlined process to add multiple Video Systems to the Suite without the need to create additional accounts on each endpoint.

Note: This should be done from a computer with access to the Suite.

Prerequisites

Configuration Reference

• Release Notes: Synergy SKY Suite 30.01
• Integrations Settings

Step-by-Step Guide

Prepare Integration within Suite

We'll start this journey by preparing some information in the Suite that we'll need later. This should cut down on the time the Webex page is waiting so we don't risk idling out of the creation page. Once this section is completed, keep the Suite open and begin the next section in a new tab, as we will be moving between the two.

1. In your SUITE, navigate to GENERAL SETTINGS > Integrations Settings
   
   
2. Under "Connections", select "ADD CONNECTION"
   
   
3. Select "Cisco Webex" from the "Connection type" drop-down
   
   
4. Name your connection ("Webex Control Hub" or something similar works)
   
   
5. A "Redirect URL" will autopopulate. Copy that address, keep this window open, and move on to the next section
   
   
   
   

Log in & begin creating Webex Integration

Now we will create the integration in Webex that the SUITE uses to connect with the Control Hub.  

1. In your browser, open a new tab and navigate to: https://developer.webex.com/
   
   
2. Log in using your Webex admin account. This user/admin account needs to be in the same environment that your endpoints are registered to. 
   
   
3. From your account menu icon, select "My Webex Apps"
   
   
   
   
   
4. Select "Create an Integration"
   
   
   
   
   
5. The next page will ask for some basic information for your integration. The only one we require is "Will this integration use a mobile SDK?".
   Select No
   
   
6. Give your integration a name, contact email, icon, and description for your reference, per your company guidelines.
   
   
7. Paste the previously copied "Redirect URL" from the Suite into the "Redirect URI(s)" field
   
   
8. Under "Redirect URI(s)", click "Add"
   
   
9. Enter "https://localhost/config/WebexAuthResponse"
   
   
10. You should now have one URI using an IP and one using localhost. Both should end with "/config/WebexAuthResponse"
    
    
11. If you have an FQDN for the Suite, you can add that as well. 
    
    
    
    
    
12. Click the checkboxes next to the following scopes:
    
    
    Listed:
    

    -meeting:schedules_read Retrieve your Webex meeting lists and details

    -meeting:schedules_write Create, manage, or cancel your scheduled Webex meetings

    -meeting:recordings_read Retrieve your Webex meeting recordings for playback

    -meeting:recordings_write Manage or delete your meeting recordings for playback

    -spark:xapi_statuses Retrieve all information from RoomOS-enabled devices.

    -spark:xapi_commands Execute all commands on RoomOS-enabled devices.

    -spark-admin:devices_read See details for any device in your organization

    -spark-admin:devices_write Create, update and delete devices and device configurations in your organization

    -spark-compliance:rooms_read Access to read rooms in your user's organization

    -spark-compliance:team_memberships_read Access to read team memberships in your user's organization

    -spark-compliance:teams_read Access to read teams in your user's organization

    -spark:calls_write Allow users to invoke call commands on themselves

    
    
13. Clicking "Add Integration" at the bottom will complete the creation of the Integration.
    
    
    
    
14. On the following page, copy the OAuth settings provided. These are required for the next steps
    
    
    

Finish Webex Connection & API Integration in Suite

The following steps will move quickly and have a very short time limit to complete. Please pre-read this section so you can be prepared and not risk time-outs.

1. Switch to your Suite tab
   
   
2. The "Add new connection" pop-out should still be up for your Webex connection
   
   
3. Paste the Client ID and Client Secret from the previous steps into the appropriate fields.
   
   
   
   
   
4. Click AUTHORISE
   
   
5. A new tab should open to begin authorisation. Log in quickly if required
   
   
   
   
   
6. On the Authorisation page, click "Accept"
   
   
   
   
7. You should then see the following message
   
   
   
   Note: If you see this message instead, you've not moved quickly enough. This happens to everyone. Return to Step 4 in this section and try again.
   
   
   
   
   
8. Once you have a successful authorisation, the "Refresh Token" field will be populated with an "Authorised" message
   
   
   
   
   
9. Click SAVE
   
   
10. Under "API Integrations" section, click "ADD API INTEGRATION"
    
    
11. Select "Webex" under the "Used for" drop-down
    
    
12. Select your previously created connection under the "Connection" drop-down
    
    
13. Ensure the "Enabled" toggle switches to "ON"
    
    
14. Select "SAVE"
    
    
15. In top-right of the Integrations Settings page, select "SAVE CHANGES"

Next steps:

See "Related articles" 

1. Deploy your configuration
   
   
2. Add your Webex Control Hub registered Video Systems to the Suite
   
   
3. Configure rooms
   
   
4. Test
   
   
5. Treat yourself to something nice

Jump to...

• Add a Meeting Room
• Add Webex Control Hub Integration for Webex Registered Endpoints
• Deploy Configuration Changes
• Configure an Occupancy Sensor