Introduction

As a result of Webex's move to a new API stack, and the retirement of Webex’s ‘Events Classic’ product, Vuture will be migrating to the new REST API, and integrating with their new Webex Webinars product.

 

Version Upgrade

When you migrate, we will need to redeploy your instance to the new Webex API version. At this point, your current integration will stop working until the steps below are completed. You will also no longer be able to use webinars that were created in the Webex Events Classic product in your Vuture integration. We advise you to have no live webinars active in a campaign when you begin the migration. 

When you are ready to migrate over to the new version, please contact your CSM and ask them to deploy your instance for the new version of the Webex API. Once that is completed, you can continue with the process as described below. 

 

Deadline

The deadline for this migration is 1st April 2023; after which any currently existing integrations will no longer work. Please ensure you have completed the migration process prior to this date. 

 

Migration details

The new API stack from Webex will no longer allow webinars to be created in the old Events Classic product. It will also require you to reauthorise the app with the new API stack, so clients will need to get a technical team member with developer privileges to follow the steps below. If you are migrating, this would probably be the same person that set up the original integration. 

 

Requirements

• Your Vuture instance deployed with the new version of the Webex integration (contact your CSM to complete this step) 
• A Webex Webinar licence 
• A Webex account with developer access. More info here - https://developer.webex.com/docs/getting-started 
• Access to the webinar support tool in Vuture 

 

Restrictions

Please note that we do not currently support the new webinar series functionality provided by Webex. However you can still create single webinars and add them to a form in a series using Vuture’s multi webinar functionality. Please see this article for more details - Adding Webinars to Forms - Single Webinars plus Multi Webinars or a Webinar Series

 

Step by Step Guide - create a new integration and authenticate

 

Navigate to https://developer.webex.com/ and sign in with the developer level Webex account.

 

Click on Start Building Apps in the bottom left of the screen.

 

 

Select Create an Integration option from the menu.

Now follow the guidelines below for these options and fill in the following information:

 

• Mobile SDK: Should be set to No as this will not be a mobile app
• Integration name (required): can be anything, but we suggest ‘Vuture Integration’ for clarity. 
• Icon (required): Either choose from one of the Webex defaults, or upload your own if required. 

 

 

• App Hub Description (required): App Hub Description is for Webex’s app hub. However, as this app will not be published on the app hub, this can be anything.  Again, we recommend ‘Vuture Integration’ for clarity.
• Redirect URL: Just like the previous integration, you will need to add your redirect URL. This will be your Vuture instance URL with mvc/webinar/oauth added at the end (e.g. https://example.vuture.net/mvc/webinar/oauth). Important:  Please ensure this URL is all in lowercase and in the correct format as the integration will not work without it.

Scopes

Scopes define the functionality and the access the app will have to your firm’s system, so you should ensure that you pick only the ones listed below. 

 

 

Important: Please ensure that you have added only the scopes listed. If these are added incorrectly the integration will not work. 

 

• Meeting:participants_read - Allows Vuture to pull back the details of the webinar attendees to write back to your CRM
• Meeting:schedules_read - Allows Vuture to pull back your webinar details
• Meeting:schedules_write - Allows Vuture to manage your webinars

You can now select Add Integration.

 

Authorising the Integration

 

Your credentials will now be displayed. Take a screenshot, copy and paste into Notes or otherwise record these details for yourself securely. You will need these credentials to add to the webinar support tool as described here. This step will need to be completed by the same technical contact that set up the app in Webex.

 

You will only need the Client ID and Secret from this page. Please ignore the ‘Oauth Authorization URL’.

 

Other Considerations

With the new Webex API’s, the process for getting your meeting ID’s will also change. When adding a webinar to your Vuture forms you will now need to take the meeting ID from the URL for that meeting in Webex. 

 

To access this, log into Webex and navigate to the desired webinar. Once you have the webinar open you will see the required meeting ID in the URL as shown below. 

Please enter this ID into the ‘Webinar ID’ field on the form editor as described here.