How to Identify the Webex Account Used to Generate OAuth Authorization Code and Reauthorize the Variphy Application

Applies to:

• Administrators managing Webex accounts for Variphy integration.
• Variphy users responsible for maintaining API connectivity.

Common Causes or Issues

• Difficulty identifying which Webex account used to generate the OAuth Authorization Code in Variphy.
• Need to reauthorize the Variphy app due to:
  • Major updates to the Variphy Webex Calling application.
  • Changing the user linked to the authorization code.
  • Expired Webex user passwords.

Background Information

Variphy uses a Webex account to authorize access to the Webex API to collect call records and other required data. The account is used to generate an OAuth Authorization Code that is entered into the platform configuration menu in Variphy. 

The Webex account used is not stored in Variphy, but you can follow these steps in Control Hub to see which account(s) are connected to the app. 

For Variphy customers on version 16.4 or later, you may need to reauthorize Variphy and generate a new Webex OAuth App Authorization Code.

Video Walkthrough

How to Identify the Webex Account Used to Generate OAuth Authorization Code in Variphy

Follow these steps to determine which Webex account(s) are linked to Variphy:

1. Log into Webex Control Hub (admin.webex.com) using an administrator account.
2. On the left-side menu, under Management, click Apps.

3. In the Apps menu, select the Integrations tab at the top of the page.

4. Search for and click on the integration named “Variphy Call Analytics and Reporting.”

5. In the integration menu, to the right of Integration Access, click the three-dot menu and select Download.

6. A .json file will be downloaded. Open this file in a text editor to view the list of Webex users who have access to the Variphy app.

Reauthorizing the Variphy Application

You might need to reauthorize Variphy and generate a new OAuth Authorization Code for the following reasons:

• Application updates.
• Changing the associated Webex user.
• Expired user credentials.

Requirements for the Webex User

• Full or Read-only Administrator
• Webex Calling Detailed Call History API access.

Best Practice: Set the password to not expire.

How to Reauthorize the Variphy Application for Webex Calling

1. Log into Variphy.
2. Hover over the Setup icon in the top-right corner. Under Platforms, click Webex Organizations. (Note: Administrator access is required in Variphy to see the Setup icon.)

3. In the Setup and Administration menu, edit your Webex organization by clicking the name or the pencil icon.
4. In the Edit Webex Organization menu, click the Authorize Variphy App button in the top-right corner.
   1. A new browser tab will open.
      • If prompted, log into Webex. The email address you input will be used to generate the OAuth token. 
      • Alternatively, if already logged in, the tab will skip directly to the next screen. Tip: To use a different email address, open a new browser window in Incognito mode and log into Variphy.

5. Scroll down and copy the Authorization Code found under “Step 2” to your clipboard.

6. Paste the Authorization Code into the OAuth Authorization Code field in Variphy and save your changes.

7. In the Setup and Administration menu, click the CDR Processing tab. Ensure the Processing Status is set to Enabled. If disabled, edit the settings to enable processing.

Note: If you’re updating the OAuth code and the Variphy collection has been down for more than a couple of hours, you can collect missing data using the Manual CDR Collection feature, which can be found in the CDR Processing menu. 

Still Need Help? 

Email our support team at support@variphy.com or click the button below to access our ticket portal.

Please provide details about your question or issue, including any applicable screenshots, reports, or Variphy application log files.