The Genesys computer telephony integration (CTI) software routes calls and chats from customers through a computer. It enables contact center agents to handle conversations in multiple channels. It also gives the agent context that helps them address customer interaction in a personal and efficient way.

AgentAssist leverages generative AI and LLM capabilities to enhance agent productivity and elevate customer satisfaction. It uses features like the AI Genie, real-time coaching, and seamless integration with popular CCaaS software and offers automated task streamlining, smart replies, sentiment tracking, automated guidance, summarized conversations, and deep integration with enterprise systems. To ensure consistency and accuracy, it has features like the Playbooks and Kore.ai’s advanced information retrieval system.

This document instructs Salesforce administrators on the setup and configuration of the Genesys CTI solution, enabling agents to access the CTI functionality.

Prerequisites

Before integrating AgentAssist with Salesforce Genesys CTI, the following prerequisites must be met:

• In Salesforce
  • Install Genesys Open CTI Salesforce package
  • Install Kore AgentAssist Salesforce package
• In Genesys
  • Install Genesys AudioHook from Appfoundry
• In Kore Contact Center (legacy bot accounts only)
  • Accounts using audiosockets must be migrated to Kore Voice Gateway.

Interaction between Genesys OpenCTI and Kore.ai AgentAssist

Install AgentAssist Package

The installation process of the Kore AgentAssist package is a simple, 4-step process. Follow these steps to install the package:

1. Visit Salesforce AppExchange.
   
   
2. Select one of the three available options–Install for admins only, Install for All Users, or Install for specific Profiles.
3. Click Install.
   Co
   

Configure AgentAssist for Salesforce

This section explains the post-installation steps of AgentAssist integration with Salesforce.

Enable AgentAssist Access to Administrators and Agents

1. lick the Gear icon > Setup.
2. Enter the text Permission Sets in the search box.
3. Click Permission Sets in suggestions, and select the alphabet C.
   
   
4. Assign the permission set:
   • For admins, assign both CTI_Kore Agent Assist Admin Permission Set and CTI_Kore Agent Assist Permission Set.
   • For agents, assign CTI_Kore Agent Assist Permission Set.Note: The admin role has higher permissions including write and delete on KoreAgentAssist Configuration Object, KoreAgentAssist Feature Configuration Object, and view access for AgentAssistApexLCController Apex. Call Summary is unavailable on the CTI_Kore Agent Assist Admin Permission Set.
   • CTI_Kore Agent Assist Admin Permission Set: Provide full access to Kore AgentAssist objects
   • CTI_Kore Agent Assist Permission Set: Provide read/write access to Kore AgentAssist objects
   • Call Summary is unavailable on the CTI_Kore Agent Assist Admin Permission Set.
5. Click the required permission set and then click Manage Assignments.
   
6. Select the agent/users or profiles needing access to this package.
7. Click Next > Assign, and on the next screen, click Done.
   
   
   
   

Enable Kore AgentAssist Package Features

1.  Click the app launcher and type Kore.
2. Click Kore AgentAssistFeature Configuration from the suggestions.
   
   
3. Click the New button on the top-right and select the features in the package you want to use.
   Configuration Name: Provide a name for the configuration you are creating.
   CTI Provider: Select the Genesys CTI – Voice option.
   Active: Only one feature configuration will be Active, and the Active configuration will be considered at runtime.
4. Click Save.
   
   
5. Click the Edit button if you want to edit the existing feature configurations.
   

Configure AgentAssist Package

1. Click the Gear icon > Setup.
2. Click Object Manager and search with Kore.
3. Select KoreAgentAssistConfig or KAA__KoreAgentAssistConfig.
   
   
4. Click Buttons, Links, and Actions.
5. Select New and from its dropdown list, click Edit.
   
   
6. Select Lightning Experience Override.
7. Select the Lightning Component radio button and in the dropdown select KAA:CTI_OverridingAgentAssistConfigNewButton.
8. Click Save.
9. Select Edit and repeat the above steps except selecting KAA:CTI_OverridingAgentAssistConfigEditButton from the dropdown list.
10. Click Save.
    
    After overriding the buttons, the following screenshot appears:
    
    

Set up Widget Configuration

1. Click the App Launcher on the left to search for the object.
   
   
2. Type KoreAgentAssistConfiguration in the search bar and click KoreAgentAssistConfiguration shown in the suggestions section.
   
   
3. Click the New button for providing configurations.
   
   
4. Provide all the details in the text boxes, and click Save.
   
   Note: In the AgentAssist URL field: 
   1. AgentAssist V2 widget: URL is https://agentassist.kore.ai or an equivalent URL of your dedicated installed instance.
   2. AgentAssist V3 widget URL: Use the URL from Configuration > System Setup > Channels > Chat of your AgentAssist instance.
      
      
5. Close the current Salesforce tab and the records are shown.
   Note: Only one configuration is active and that configuration is used at runtime.
6. Select one of the displayed records and click Edit, if any updates are required.
   
   

Configure Softphone Layout

1. In the search box, type Softphone Layouts and click Softphone Layouts in suggestions.
2. Click New (if Softphone Layouts does not exist).
   
   
3. Enter a name for the layout and select the checkbox Is Default Layout.
4. Select Inbound for the Select Call Type field.
5. Select the objects you want to match with the incoming payload (for example, Incoming Mobile Number) in the Display these salesforce.com objects section.
6. In the Screen Pop Settings section, select the behavior when a match record is found, when no match record is found, and when multiple records are found for the selected objects.
   
   

Create Agent Presence Status

1. Click the Gear icon > Setup.
2. Type Presence Statuses in the quick search box and then click Presence Statuses in suggestions.
3. Click the New button.
   
   
4. Enter the Status Name and select Status Options.
5. Select the Service Channels and click Save.
   
   

Place the Widget in the Record Detail page

1. Open any record of the selected object in step-2 of Softphone layout configurations, and click the Gear icon.
2. Click Edit Page.
   
   
3. In the search box, search for  GenesysCTI_AgentAssistVoice and Kore_AgentAssist_Conversation_Summaries. Under the Custom-Managed section, components are visible.
4. Drag both the components to the screen at the required location and adjust height and width as required.
    
5. Click Save.
6. Click the Activate button next to the Save button.
   
   
7. Click the Activate button on the pop-up window.
   
   
8. Select APP, RECORD TYPE, AND PROFILE, and click Assign to Apps, Record Types, and Profiles.
   
   
9. Select the apps for which you want the component to be visible and click the Next button.
   
   
10. Select the Form Factor and click the Next button.
    
    
11. Select the Record Types and click the Next button.
    
    
12. Select the profiles, and click the Next button.
    
    
13. Review all the configurations that you have selected and click the Save button.
    
    
14. Click Save.

Configure Genesys CTI

Create and Configure Genesys Extension Class

1. Click the Gear icon and then click Developer Console.
   
   
2. Click File > New > Apex Class.
   
   
3. Create an apex class with the name CustomCTIExtensions and save it.
   
   
4. Copy and paste this code in the Apex Class, and save it.

Configuring the Extension Class in Genesys

1. Click the Gear icon and enter the text Installed Packages in the search box.
2. Click Installed Packages in suggestions.
3. Select Genesys Cloud for Salesforce and click Configure.
   
   
4. Click Client Settings and from the Call Centers dropdown list.
5. Select Genesys Cloud for Salesforce Lightning.
   
   
6. Scroll down to the bottom of the page, click the dropdown list, and select the class that you created in step-3 of Create an Extension Class for Genesys and save it.
   
   

Add Users to Call Centers for Genesys

1. Click the Gear icon and enter the text Call Centers in the search box.
2. Click Call Centers in suggestion, and then click Continue.
   
   
3. Select the required option–If CTI was used for lightning, select Genesys Cloud for Salesforce Lightning.
   
   
4. Click Manage Call Center Users and assign users.
   
   Note: To make the CTI visible, assigning users is mandatory in the Utility bar.
5. Click Add More Users.
   
   
6. Set criteria for searching users.
7. Click Find. A list of users will be displayed.
8. Select the checkbox for the required users, and click Add to Call Center.
   
   

Add Genesys CTI to the Utility bar

1. Click the Gear icon and enter the text App Manager in the search box.
2. Click APP Manager in suggestions.
3. Search for Service Console and click the dropdown list against it.
4. Click the Edit button.
   
   
5. Click Utility Items (Desktop Only) > Add Utility Item.
6. Search for Open CTI Softphone and click Open CTI Softphone.
   
   
7. Rename the label, if required, and then click Save.
   
   
8. Check if CTI is added to the Utility Bar.
9. Click the App Launcher (colored dots), enter the text Service Console in the search box, and click Service Console in suggestions.
   
   
10. At the bottom of the page, you can find the CTI phone label name you gave in step-4 of Adding Users to Call Centers for Genesys.
11. Click the label. A pop-up window appears asking for the Genesys Cloud credentials.
    

Generate Genesys oAuth Credentials

1. Sign in to Genesys Cloud.
2. Go to Admin > Integrations > OAuth.
   
   
3. Click Add Client.
   
   
4. Enter the app name, description, and token duration in the App Name, Description, and Token Duration fields.
5. Select Token Implicit Grant (Browser) in the Grant Types fields.
6. Add https://agentassist.kore.ai/koreaiaa-genesys/ in the Authorized redirect URIs (one per line) section.
7. Add the following list of scopes in the Scope section:
   • architect
   • conversations
   • conversations:readonly
   • integrations
   • integrations:readonly
   • messaging
   • messaging-platform
   • messaging-platform:readonly
   • messaging:readonly
   • notifications
   • user-basic-info
   • web-chat
   • web-chat:readonly
     
     After saving the configuration, you will get the Client ID of the created OAuth client.
8. Save the Client ID and Client Secret to be used in Step-5 of Configure Genesys CTI Package section.

Configure Genesys CTI Package

1. Click the Gear icon and search for Installed packages.
2. Click Installed Packages in suggestions.
3. Search for the Genesys package, and click Configure.
   
   
4. Click Shared Settings. The Provided status is No. Click Modify.
   
   
5. On the pop-up window, enter Genesys Client ID and Client Secret and then click Save.
   
   
6. The Test button gets enabled. Click the Test button. A success message is displayed, and the Provided status turns to Yes.
   
   

Configure Audiohook

If you are using Kore-managed Transcriptions, the final step is to install Audiohook for voice streaming. The Audiohook integration requires specific configuration values to support AgentAssist configuration.

1. Sign in to Genesys Cloud.
2. Go to Admin > Integrations > Integrations.
3. Enter “audiohook” in the search box to check for any existing instances of audiohooks.
   
   
4. Click the Integrations button on the top-right corner to install a new audiohook app.
   
   
5. Enter “audio” in the search box.
   
   
6. Install Audiohook Monitor, and go to the Configuration tab.
   
   1. Channel value should be both.
   2. The Connection URI format should be similar to the following:
      wss://savg-webserver.kore.ai/audiosocket/genesys/?sipuri=xxx&token=xxx&botId=xxx&accountId=xxx&agentassist=true
      1. Get sipuri=sip:<sip-string> from the AgentAssist Voice channel.
         
         
      2. Use the following references from AgentAssist.kore.ai, Bot Channel configuration page to fetch Bot ID, Account ID, Client ID, and Client Secret (for token generation).
         
      3. Follow the steps of Using XO Platform APIs, Kore.ai Documentation, to generate the token (token= <token>.)
7. Add credentials in the Credentials tab.
   
   
   1. Refer to Step-6 and use Bot Client ID and Client Secret as API Key and Client Secret respectively. These credentials are used to validate the audiostream signature by Kore.
   2. Click OK.
8. Click Save.

Post-installation Validation

As an agent having CTI and AgentAssist permission enabled:

1. Click App Launcher and type Service Console in the search bar.
2. Select Service Console in the suggestions.
3. At the bottom of the page, in the Utility Bar, you can find the CTI name you entered in step-7 of Adding the Genesys CTI to Utility bar. Click it and then sign in to Genesys.
   
   
4. A pop-up window prompts; allow it and make sure that microphone access is also given.
5. In the Genesys window, click the dropdown list symbol and select OnQueue.
   
   
6. When a user calls the agent, based on the Softphone layout settings a screen pops up automatically. The agent should receive the call by clicking the phone symbol, as highlighted in the following image:
   
   
7. The conversation between the agent and the user appears as transcripts in AgentAssist. If any of the user’s words matches with the libraries, automations are displayed in AgentAssist. Based on user response, AgentAssist displays the next automations.
    
8. Once the conversation is complete, disconnect the call, and in the wrap-up dropdown list, select Solved and click Done.
   
   
9. A pop-up window shows the conversation summary. To save it in Salesforce, click the Submit button.
   
   

Appendix

Widget V2 Sample

Widget V3 Sample

Custom Objects Installed

• Agent_Assist_Package__c – Used for checking if proper licensces are available
• KoreAgentAssistConfigObj__c – Used to store Kore AgentAssist credentials
• KoreAgentSupportedPackage__mdt – Used to check supported integrations
• GenesysCX_Data__c – Intermediate for tracking conversation status
• KoreAgentAI_Conversation_Summary__c – For saving the conversation summary
• OnSaveLogEvent__e – For publishing end-conversation events.

Troubleshooting

• If you have installed a package that is a beta or an alpha release, go through this doc for updating.
• Ensure you have gone through the Prerequisites section and followed all the steps.

FAQ

Q: Why is the widget loading but appearing empty?

A: Ensure the correct assignment of the permission sets based on steps 4.1 and 4.2 of Enable Administrators and Agents access to AgentAssist and you have added the Apex Class for CustomCTIExtensions in Configuring the Extension Class in Genesys.