Setup guide for CX Cloud, Voice for Salesforce Service Cloud

Before you can create and fully configure a contact center in Salesforce with Genesys as the third-party contact center provider, there are preliminary steps that you must complete. Follow the steps to set up the Salesforce environment for the CX Cloud from Genesys and Salesforce integration.

Create a Lightning app named Contact Center in Salesforce. When creating the app, you can add the Genesys Cloud CX Utility and Omni-Channel widgets. The Genesys Cloud CX Utility provides agents with the ability to manage their phone, queue, callback, and after call work. Apart from this utility, you can also add the following other utilities:

  • Queue Stats
  • Callback state
  • Schedule callback

To create a Lightning app in Salesforce:

  1. On the Setup Home page, search for Apps in the Quick Find box and select App Manager.
  2. To open the New Lightning App wizard, click New Lightning App.
  3. Enter a name for the app; for example, Contact Center, and then click Next.
  4. Select Console navigation as the navigation style and click Next.
  5. Add the Genesys Cloud CX Utility and Omni-Channel utilities. 
    Note: For Genesys Cloud CX Utility, ensure that you select the Start automatically option.
     
  6. Click Next.
  7. Select Voice Calls and move it from the Available Items list to the Selected Items list. Then, click Next.
  8. Select to open the Voice Call record page as workspace tabs or subtabs of a given list of components and click Next.
  9. Select System Administrator and the profile assigned to an agent, and move it from the Available Profiles list to the Selected Profiles list.
    Note: Ensure that the user profiles selected have access to the contact center. For more information, see Assign permissions sets.
  10. Click Save & Finish.

Create a presence status for agents in Salesforce. Ensure that for each presence status includes the phone channel assignment. An agent can have the following presence statuses:

  • Available
  • Available for Voice
  • Busy

Note: To receive the voice calls successfully, the agent must sign in to the Omni-Channel widget in the status mapped to the On Queue status in Genesys Cloud.

To create a presence status in Salesforce:

  1. On the Setup Home page, search for Presence in the Quick Find box and select Presence Statuses.
  2. On the Presence Statuses page, click New.
  3. Under the Basic Information section, enter the status name. For example, Available or Available for Voice.
  4. Under the Status Options section, select Online or Busy accordingly.
  5. Under the Service Channel section, select the service channels from which you want to receive the voice calls and move them to the Selected Channels list.
  6. Click Save.

To make the presence statuses available for agents, assign the status to their profiles.

  1. On the Setup Home page, search for Profiles in the Quick Find box and select Profiles.
  2. Click the name of the user profile to which you want to give access to the presence status.
  3. Select the Available for Voice status and move it to the Enabled Service Presence Statuses section.
  4. Click Save.

The agents assigned with this profile can sign in to Omni-Channel with the Available for Voice presence status.

Salesforce provides Contact Center Admin (Partner Telephony) and Contact Center Agent (Partner Telephony) permission sets. Assign these permission sets accordingly to the administrator and agents. The permission set assignment is essential for you and your agents to access the contact center and start managing the voice calls.

To assign permission set to users in Salesforce:

  1. On the Setup Home page, search for Permission sets in the Quick Find box and select Permission Sets.
  2. From the list of permission sets, click Contact Center Admin (Partner Telephony) or Contact Center Agent (Partner Telephony).
    Note: For secure pause and resume of call recordings, assign the cloned permission sets. For more information, see Pause and resume call recordings.
  3. Click Manage Assignments.
  4. In the Current Assignments page, click Add Assignment.
  5. Select the user from the list and click Next.
  6. Select an expiration option of the permission for the user. 
  7. Click Assign.

Pause and resume call recordings

If your organization records calls for training and quality purposes, then you might prefer not to record any sensitive information. Clone the existing Contact Center Admin (Partner Telephony) and Contact Center Agent (Partner Telephony) permission sets in Salesforce and edit the permission for call recordings. To allow agents to pause and resume call recordings, you must assign the users to a permission set that has the Control Call Headings option enabled for App Permissions. For more information, see Enable secure pause and resume of call recordings.

The Voice Call record page provides the agents with the relevant information during the call and when viewing the completed call records. You can either create a new Voice Call record page with the custom components from Genesys or edit an existing Voice Call record page by adding the custom components from Genesys.

If you are creating a record page, Genesys Cloud recommends using the Header with Three Region template to arrange the components in Salesforce. You can also customize the layout of the page as per your specific business needs.

To enable agents to manage callbacks, it is mandatory that you add the GC for SCV Callback State and GC for SCV Schedule Callback custom components for callback to the Voice Call record page.

To create a custom Voice Call record page in Salesforce:

  1. On the Setup Home page, search for App Builder in the Quick Find box and select Lightning App Builder.
  2. To create a Lightning page wizard, click New.
  3. Select Record Page and click Next.
  4. Enter a name for the page in the Label.
  5. Select Voice Call in the Object list and click Next.
  6. Under Standard list, select Header and Three Regions as the page template and click Done.
  7. In the Lightning App Builder, you can add, edit, or remove components.

    Drag the following standard components and add them to the page:

    • Highlights panel
    • Phone
    • Record Detail

    Drag the following custom components (from Genesys Cloud) and add them to the page:

    You can rearrange the components on the page. For more information, see Create and Configure Lightning Experience Record Pages in the Salesforce documentation.

  8. Click Save and then click Activation.
  9. To make the Voice Call record page as the default page for the contact center app, select APP DEFAULT and click Assign as App Default.
  10. On the Activation window, follow the wizard to assign the record page to other Lightning apps and form factor.

For more information, see Activate Lightning Experience Record Pages in the Salesforce documentation.

The following illustration shows an example of the page layout with the arranged components:This image is a screenshot of the voice call record page in Salesforce.

Note: While creating a voice call record in Salesforce, you may encounter errors. These errors can be caused by some factors due to triggers, flows, required fields, and field validations. Salesforce bypasses the errors, creates the voice call record, and returns an error message. For more information, see Create a Voice Call Record in the Salesforce documentation.

The following screenshot illustrates an example of how a voice call record appears for an agent:

Record view of the agent in Salesforce.

Next, create a contact center in Salesforce Service Cloud.