Documentation:HTCC:IWWDep:GplusServiceClientAPI:9.0.0DRAFT

Gplus Adapter support for Service Client API

Gplus Adapter supports the Genesys Service Client API, which you can use for custom features.

Support for Service Client API in Salesforce Lightning

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 Lightning:

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 GplusChannel.messageChannel with the following contents:

      <?xml version="1.0" encoding="UTF-8"?>
      <LightningMessageChannel xmlns="http://soap.sforce.com/2006/04/metadata">
          <masterLabel>GplusChannel</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 here and add it to your static resources in Salesforce.
4. Download the SCAPI example from here.
5. 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.
6. Add the Visualforce page to your dashboard.

7. Set the salesforce.message-channel.name option to the name of the message channel you created in step 2-b — for example, GplusChannel__c.

   The value of the salesforce.message-channel.name option must be specified using one of the following formats:

   • NameSpacePrefix_ChannelName__c
   • ChannelName__c

   You must use this format to confirm to the Salesforce Naming Conventions for Custom Fields.

8. In the interaction-workspace section of the Workspace configuration object, configure the following options:

   • service-client-api.accepted-web-content-origins — Set the value to *
   • service-client-api.allow-full-api — Set the value to true

Support for Service Client API in Salesforce Classic

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 Classic:

1. Download the SCAPI script from here.

2. Download the SCAPI example from here.

3. Add service-client-api-classic.js to your static resources in Salesforce.

4. Create a Visualforce page with SCAPI (according to the SCAPI example) or a custom console component.

5. Add the Visualforce page to your dashboard.