Skip to main content
Virtual Office for Salesforce Integration: v 2.x Full Installation
8x8 Support

Virtual Office for Salesforce Integration: v 2.x Full Installation


These instructions will guide you through installing the most recent version of the 8x8 Virtual Office for Salesforce integration.

This process bypasses the need to install the integration from the Salesforce AppExchange.

There are four primary steps in this process:

  • Install the 8x8 Virtual Office for Salesforce Integration Package
  • Import the Latest Call Center
  • Add Salesforce Users to the New Call Center
  • Optional: Configure Salesforce Lightning
Note: The 8x8 Virtual Office for Salesforce integration is not a softphone, and so provides no audio services. It is effectively a control panel and is required to work in conjunction with 8x8 Virtual Office Desktop, Virtual Office Mobile, or a hardphone.

Install the 8x8 VO for Salesforce Integration Package

  1. Log in to Salesforce as an administrator.
  2. Click the following link to open a new browser tab, or right-click and copy the link location, then paste the URL into the address line of your preferred web browser.
  3. Select Install for All Users and click Install.
  4. Click Done to complete the package installation.
  5. Salesforce should automatically display the installed package. If not, in Salesforce click Setup, then search for and click Installed Packages.
  6. Verify that version 2.8 of the 8x8 Virtual Office for Salesforce integration is installed, and proceed to the next step.

Import the Latest Call Center

With the installation of the v 2.8 package, your call center should already be imported for you, and appears as below:

In that case, please skip to the next section, Add Salesforce Users to the New Call Center.


However, if you have a need to re-import your call center, you can refer to the following instructions.

  1. To begin, right-click on the following link and select Save As or Save File As, and save the XML file to a known location:
Note: If you've installed version 2.8 of the Virtual Office for Salesforce integration, the correct call center is already installed for you. Proceed to the next section: Add Salesforce Users to the New Call Center
  1. In Salesforce, click Setup, then search for and click Call Centers. In All Call Centers you'll see the call center which you are replacing.
  2. Click Import.
  3. Click Choose File, select the 8x8VirtualOfficeSalesforceIntegrationLightning.xml file you downloaded previously, and click Open.
  4. Click Import again to complete the call center import process.
  5. You'll be shown the configuration of the newly-imported call center 8x8 Virtual Office Integration - Next Generation_Lightning.
  6. Now you'll delete the original call center. Click All Call Centers to see the call center list.
  7. You can safely delete any extra 8x8 call centers, if there are any. Click Del next to the call center you don't want.
  8. Click OK when prompted for confirmation.
  9. You should now see only the call center named 8x8 Virtual Office Integration - Next Generation_Lightning.
  10. Proceed to the next step to add your Salesforce users to the new call center.

Add Salesforce Users to the New Call Center

Your Salesforce users must be added to the 8x8 call center for them to see the integration communication panel.

Note:The following two call centers are the same, though labeled slightly differently:
  •  8x8 Virtual Office Integration - Next Generation_Lightning (imported manually)
  •  8x8 Virtual Office Integration - Next Generation With Lightning (installed with v2.8)
  1. To begin, navigate to Setup > Call Centers and click on the name of the 8x8 Virtual Office Integration call center (do not click Edit).
  2. Scroll down and click Manage Call Center Users.
  3. Click Add More Users.
  4. In Search for More Users, click Find to see a list of all available/unassigned users. You can also use filters to narrow your search as needed.
  5. Select the users who will have access to the 8x8 Virtual Office integration, then click Add to Call Center.
  6. Your Salesforce users can now click on their Home tab to log into and use the 8x8 Virtual Office for Salesforce Integration.
  7. If your Salesforce users require use of the integration in Lightning mode, continue on with the next step. Otherwise, this basic installation process is complete.

Optional: Configure for Salesforce Lightning

Configuring the Salesforce integration for Lightning mode requires a few extra steps.

Note: The 8x8 VO integration supports Salesforce Console for Lightning and the Service Console for Lightning, which are features that must be purchased from Salesforce.

  1. In Classic or Lightning mode, navigate to Setup > Call Centers, and click 8x8 Virtual Office Integration - Next Generation_Lightning.
  2. Confirm that Salesforce Compatibility Mode is set to either Lightning or Classic_and_Lightning, depending on your needs. This setting controls which mode the 8x8 integration communication panel will appear in for your users. The default setting is Classic_and_Lightning.
  3. Now from Classic mode (if needed) click Switch to Lightning Experience.
  4. At the top-right, click the Setup Salesforce_Lightning_Setup_Gear.jpg icon and select Setup Salesforce_Lightning_Setup2.jpg
  5. Search for and click App Manager.
  6. The 8x8 Virtual Office integration supports all of the following Salesforce Lightning applications. Repeat the following steps to add any of these applications, as needed:
    • Sales
    • Sales Console
    • Service Console
  7. Click the drop-down arrow in the row of the Lightning app you're adding the 8x8 integration to, and select Edit.
  8. In the Lightning App Builder, click Utility Items.
  9. Click Add Utility Item and select Open CTI Softphone.
  10. Click Save at the bottom of the screen.
    salesforce app utility.PNG
  11. At the top-right of the screen, click the Back Salesforce_Lightning_AppBuilder_BACK2.jpg button. This will return you to the Setup Home tab.
  12. At the top-left of the screen, click the App Launcher Salesforce_Lightning_AppLauncher_Grid.jpg icon.
  13. Click to launch the Lightning app you've added the 8x8 Virtual Office integration to.
  14. The Phone button Salesforce_Lightning_UtilityBar_Phone3.jpg should appear in the Utility Bar at the bottom-left of the screen.
Note: If the Phone button does not appear for a user, verify that they've been added to the 8x8 call center, and refresh their browser tab for good measure. Clearing of the browser cache and cookies might also be needed.
  1. Click the Phone button to bring the 8x8 communication panel into view. All users assigned in the 8x8 Virtual Office call center can now log in to their 8x8 extension.

Online Documentation

The following comprehensive online documentation is available, here:

How can we help you?