Configuring and Using General Features

Gplus Adapter integrates Genesys interaction handling capabilities into Salesforce. The Adapter window is accessed through the Adapter button in the Salesforce Utility Bar. The Adapter window displays agent status at all times. The Adapter window can be docked, undocked, moved, resized, minimized, and maximized. Some Genesys interactions events cause the Adapter window to be maximized automatically.

Related documentation:

• How Gplus Adapter for Salesforce works

Agent Status Display in Gplus Adapter

Gplus Adapter displays agent status in the Utility Bar whether the Adapter window is minimized or maximized. Agent status is obtained from Workspace Agent Desktop. This feature enables agents to monitor their status even when the Adapter window is minimized.

Dock, undock, move, and resize Adapter

By default, the Adapter window launches in the bottom-left corner in the Salesforce Utility Bar.

Agents can undock the Adapter window then move it to a different location. To undock (pop out) the window, they click the icon in the top-right corner of the Adapter window and drag it where they want to place it. Once the window is undocked, agents can move or resize the window as needed.

Agents can dock (restore) the window back to its original position by clicking the icon.

Interaction Events causing the Adapter window to Maximize

If an agent has minimized Adapter to handle other tasks in Salesforce, the Adapter window is automatically maximized by the following events:

• Receiving voice, chat, email, or workitem interactions
• Releasing interactions
• Marking Done interactions
• Receiving connections error notifications
• Receiving confirmation that an interaction has been added to the Genesys Universal Contact Server (UCS) database

Configuring Gplus to run Salesforce Apex

If you want to customize Salesforce by running Salesforce Apex on Genesys interaction events, you can configure Gplus Adapter to create and execute Salesforce Apex. See the Salesforce Apex Developer Guide. Apex can be initiated by the following Genesys interaction events: DIALING, RINGING, ESTABLISHED, and RELEASED.

Your Apex class should have one method and accept the following two string parameters: eventName and eventUserDataContent.

For example:

public class TestApex {public void eventCollector (

string eventName, string eventData) { …

…… }

Examples of how to use the Run Salesforce Apex on interaction events functionality include:

• Create Salesforce Case with user data from an interaction.
• Provide Salesforce Alert to Agent for reminders on how to handle a workflow in Salesforce.

Configure which events you want to trigger runApex code by using the Run Salesforce Apex on Interaction Events option in Agent Setup.

Configure the name of the custom Apex Class to execute by using the Apex Class Name option in Agent Setup.

Localization in Gplus Adapter

Gplus Adapter automatically selects the same language that Salesforce is configured to display in, if the language is supported by Workspace Agent Desktop; otherwise, Gplus Adapter displays in English. For example, if Salesforce is configured to display in French, then Adapter displays in French.

Refer to Edit Your Language and Locale Settings for information about setting the display language in Salesforce Lightning.

Support for Genesys Interaction Recording

The Gplus Adapter console supports Genesys Interaction Recording (GIR). For an overview of Genesys Interaction Recording, see About Genesys Interaction Recording.

Genesys Interaction Recording is only supported for Voice channel and is not supported when Gplus Adapter is popped out of the Salesforce window.

To configure Genesys Interaction Recording for the Gplus Adapter, see Enable Screen Recording in the Genesys Interaction Recording Solution Guide. In this procedure, refer to the Integrating with Workspace Web Edition section.

To manage the call recording features of an agent, see Recording setup.

Support for Service Client API

Gplus Adapter supports the Service Client API, which you can use for custom features such as invoking click-to-email, starting or stopping a recording when a sensitive field is on the screen, and attaching data from Salesforce to Genesys key/value pairs. Complete the following steps in Salesforce:

1. Deploy your Salesforce domain.
2. Create and deploy a message channel using Salesforce CLI or a third-party tool such as Workbench. For example, here's a breakdown of the steps you must complete using Workbench:
   1. Create a folder called messagedeploy and add a new file called package.xml with the following contents:

      <?xml version="1.0" encoding="UTF-8"?>
      <Package xmlns="http://soap.sforce.com/2006/04/metadata">
          <types>
              <members>*</members>
              <name>LightningMessageChannel</name>
          </types>
          <version>47.0</version>
      </Package>

   2. In your messagedeploy folder, create a new folder called messageChannels and add a new file called GplusChanel.messageChannel with the following contents:

      <?xml version="1.0" encoding="UTF-8"?>
      <LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
          <masterLabel>GplusChanel</masterLabel>
          <isExposed>true</isExposed>
          <description>This Lightning Message Channel sends information from VF to LWC and back.</description>
      </LightningMessageChannel>

   3. Zip (compress) the messagedeploy folder.
   4. Navigate to https://workbench.developerforce.com/login.php and log in to Salesforce with the account you will use for the Service Client API.
   5. Open the migration menu, click Deploy and attach the zip you previously created.
   6. Open the info menu, click Metadata Types & Components and choose LightningMessageChannel - you created this in step 2-a.
3. Download gplus-service-client-api.js from https://[YOUR_HOST]/ui/crm-workspace/build/service-client-api/gplus-service-client-api.js and add it to your static resources in Salesforce.
4. Create a Visualforce page in Salesforce that uses your new message channel (from step 2-b) and the Service Client API to implement your custom functionality.
5. Add the Visualforce page to your dashboard.
6. In Agent Setup, configure Gplus Adapter to use your message channel with the Salesforce Message Channel Name for Service Client API option.

Support for browser-based WebRTC calling

Gplus Adapter supports browser-based WebRTC voice calling. **NOTE: Refer to WebRTC docs from Bill Mitchell** Enable this feature by configuring the WebRTC options in the Voice section in Agent Setup.