Integrating Gplus Adapter in Lightning

From Genesys Documentation
Jump to: navigation, search

The steps to setup and access Gplus Adapter in Salesforce Lightning.

If you are migrating from Adapter 8.5, you must first follow the migration procedure in this article.
For information about integrating Gplus Adapter in Classic, go here.

How to create a Gplus Adapter URL

  1. Ensure that Agent Desktop release 9 has been enabled in your environment by confirming that the Agent Desktop 9 application icon is displayed in your Genesys Portal.

  2. In the Portal, click the Agent Desktop icon to launch Agent Desktop and then copy the domain name from the Agent Desktop URL to build Gplus Adapter URL. For example, copy gwa-<region> from the Agent Desktop URL. The domain in the Agent Desktop URL should be used in Gplus Adapter URL.

  3. The Adapter URL will look like this:

Steps to setup and access Gplus Adapter in Salesforce

  1. Enable Lightning in your Salesforce environment.
  2. Integrate Gplus Adapter in Salesforce Lightning.
  3. Add users to your Call Center.
  4. Configure the Utility bar for Gplus Adapter for the agents to easily access the application.
  5. Configure Gplus Adapter SSO.

Integrating Gplus Adapter in Salesforce Lightning

Follow these steps:


  1. Click the gear icon in the top right corner and then click Setup.
  2. Using the Quick Find field, search for and access the Call Centers setup page.
  3. Using the Import functionality, import the lightning-callcenter.xml file from your computer. If you have not already downloaded the file, download it from here.
  4. From the All Call Centers list, click the Call Center you just imported. For example, GPlus9Lightning.
  5. Take the Adapter URL that you built at the beginning of this article and enter it in the CTI Adapter URL field.
  6. Save the changes.

Adding users to Call Center

The next step after you setup your Adapter is to add users to your call center. You must add at least one user to your call center.

  1. In the Call Centers setup page, click Manage Call Center Users.
  2. Click Add More Users.
  3. Search the interface to find the users you want to add to Gplus Adapter.
  4. Select the users you want to add and click Add to Call Center.
From the Manage Users page, select the users you want to remove from a call center and click Remove Users.

Configuring the Utility bar

  1. In the setup page, using the Quick Find field, search for and access the App Manager settings page.
  2. Create a new application by clicking New Lightning App. Follow the steps in New Lightning App creation procedure in Salesforce documentation.
  3. When creating a new Lightning app, follow the additional steps below to configure the utility items for your Gplus Adapter.
    • In the App Options step, ensure that you select Console Navigation. Gplus Adapter does not support Standard Navigation.
    • In the Utility Items step, add Open CTI Softphone by clicking Add Utility Item.
    • For the soft phone, you can modify the display properties such as Label, Panel Width and Panel Height.
    • Select Start automatically to start loading the data when the Gplus Adapter first opens to ensure that it initializes immediately; otherwise, Gplus Adapter does not load until an agent first opens it from the Utility Bar. If Gplus Adapter is not initialized immediately, then agents do not receive voice calls until they first open the application.
  4. Specify Navigation Items and User Profiles for the new Lightning app by referring to Salesforce documentation.
  5. Save the application.

Multi-region and multiple Salesforce Call Centers configuration

Your Genesys Multicloud CX deployment may have multiple regions. For multiple regions you must create a unique Salesforce Call Center for each region and use the CTI Adapter URL specific to each region. Agents may only be assigned to a single Salesforce Call Center. Agents assigned to one region may not access other regions unless their Salesforce account is moved from one Salesforce Call Center to another Call Center. Follow these steps to create a Salesforce Call Center for a second region:

  1. Clone your existing Salesforce Call Center.
  2. In the new Salesforce Call Center replace the CTI Adapter URL with the second region URL. For example https://gwa-<region2>
  3. Add agents for the second region to the created Call Center. Note: Agents must be assigned to one Salesforce Call Center only.
The same Genesys Contact Center field mapping configuration is shared by the two Salesforce Call Centers.

Accessing Gplus Adapter

You can access the Gplus Adapter application by following the procedure below.

  1. In the top-left corner, click the App Launcher icon GPlus adp Lightning applaunchericon.png.
  2. Select the app that you created when setting up the Gplus Adapter application.
  3. Click the phone icon from the bar at the bottom-left corner to open the Gplus Adapter application.
  4. Log in to the application to start using the Genesys contact center functionalities.