Create a contact center in Salesforce Service Cloud

Prerequisites

Create a contact center in Salesforce Service Cloud with Genesys Cloud as the telephony provider.

To create a contact center:

  1. Launch the Lightning app with the CX Cloud Genesys Settings tab in Salesforce.

    The Package Listings page displays.

  2. In the Package Listings page, click Configure in the CX Cloud, Voice for Salesforce Service Cloud section.
  3. Click Create a Contact Center.

Follow the steps to complete the creation of a contact center.

To generate an XML file for the contact center configuration in Salesforce:

  1. Click the Expand icon for the Generate and Upload Contact Center XML step.
  2. Under the Contact Center Settings section, enter the following details that are mandatory:
    • Display name for the contact center
    • Genesys Cloud region
    • Long distance prefix
    • Public key
  3. (Optional) Under the SSO Settings section, enter the SSO Provider Name and the Organization Name.

    By using a single sign-on (SSO) identity provider, an agent can sign in to one application such as Salesforce and then is automatically logged in to the client. For information about the single sign-on providers that Genesys Cloud supports, see About single sign-on (SSO). If you enter an SSO Provider Name and the Organization Name, all the agents in your organization use the single sign-on identity provider that you input. For agents that do not use this single sign-on identity provider, create a separate Contact Center and assign those agents.

    1. In the SSO Identity Provider Name box, enter the name of the single sign-on identity provider that you want to use. For a list of valid provider parameter values, see Additional Authorization Parameters in the Genesys Cloud Developer Center.
    2. In the Genesys Cloud Organization Name box, enter the name of the Genesys Cloud organization that uses this single sign-on identity provider.
      Note: Make sure that the capitalization of the organization name matches the capitalization of the short name of your organization. For more information, see Modify organization settings.
  4. Click Generate Contact Center Configuration.

    An XML file is created and downloaded to your local machine.

Use the downloaded XML file to create a contact center.

To create a contact center in Salesforce:

  1. Click Create a Contact Center in Salesforce.
  2. In the Partner Telephony Contact Centers page, click New.
  3. Select the telephony provider as Genesys Cloud in the appropriate region and click Next.
  4. Click Upload XML file and select the XML contact center definition file that you have already generated.
  5. Check for the newly created contact center in the list and verify that the certificate displays for the contact center from the XML file.

The contact centers that you create in Salesforce are listed. Select the contact center from the list to proceed with the setup process.

To set up the integration in Genesys Cloud from Salesforce:

  1. Click the Expand icon for the Set up integration settings in Genesys Cloud step.
  2. Select the OAuth client from the list for the integration.
  3. In the Integration Name field, enter a unique name for the integration in Genesys Cloud.
  4. In the Genesys Cloud Group Filtering, enter the name of the Genesys group whose members use the integration.
  5. Click Upload Files and select the private key file or you can drop the private key file. 
  6. Click Create Integration.

If you are setting up the integration from Genesys Cloud, then expand the Manual integration setting information option and copy the details from the Salesforce Organization Id and Salesforce Contact Center Name fields. To open the Genesys Cloud browser app, click Configure Genesys Cloud Integration Settings.

To set up the integration in Genesys Cloud:

  1. Click Admin.
  2. Under Integrations, click Integrations.
  3. Click Integrations in the upper right corner.
  4. Search for the CX Cloud from Genesys and Salesforce integration and click Install.
  5. (Optional) Genesys Cloud provides a default name. If you modify the name, ensure that the name is unique.
  6. Click the Configuration tab.
  7. On the Properties tab, click Add Property and fill in the following mandatory details about the contact center in Salesforce:
    • Salesforce Organization Id
    • Salesforce Contact Center Name
    • Group Filtering
  8. On the Credentials tab, click Configure. The Configure Credentials window opens.
  9. Enter the private key for the integration.
  10. Click OK and then Save.
  11. To activate your new integration, set the Status switch to Active.
  12. Click Yes.

Configure contact center settings, including logging, status mapping, and call attributes.

Enable server-side logging

Enables logging that the Customer Care can access. When you encounter issues and contact the Customer Care, they request for these log files. Server-side logging allows Customer Support to access these logs directly. 

Status mapping

Keep your agents’ statuses in sync between Genesys Cloud and Omni-Channel. Create a presence status named Available for Voice that includes service channels for voice calls. When agents are signed in to that presence status, they receive the incoming voice calls. For more information, see Create a presence status and give users access to presence status. The status mapping allows you to control how agents receive voice calls in Salesforce Service Cloud Voice and Genesys Cloud. 

The following table shows an example of status mapping between Genesys Cloud and Omni-Channel statuses. When an agent’s status is set to on queue in Genesys Cloud, the agent is available in Salesforce to receive voice calls. Similarly, when the agent goes off queue in Genesys Cloud, the Omni-Channel status is set to Available and the agent can receive other interactions apart from voice calls, such as chats and emails.

Omni-Channel status Genesys Cloud status
Available for Voice On Queue
Upon leaving “Available for Voice” status Available
Busy

Upon leaving “On Queue” status

Available Off Queue or Direct Calls Only

Default phone status

Notes:
  • To follow the example status mapping, you have to create the Busy and Available Off Queue or Direct Calls Only presence statuses in Salesforce and ensure that users have access to these statuses.
  • The contact center agent profile must include a default presence status assigned to it. The default presence status acts as a backup when an agent receives a call while in a non-phone status. The default presence status enables the agent to switch to phone enabled status when a call comes in.Call modal of incoming call in Service Cloud Voice

Enhanced status sync

You can create an extension class in Salesforce that details the status mapping between Salesforce and Genesys Cloud. Enter the extension class name in the search box and select the class from the list.

For more information about how to create the extension class, see the Genesys Cloud Developer blueprint.

Note: The status mapping between Genesys Cloud and Omni-Channel statuses is mandatory. If an error occurs during enhanced status sync, the status mapping is used as a fallback approach.

Genesys Cloud conversation field mapping

Salesforce Service Cloud Voice provides voice call records for which you can map the fields to your interaction attributes. The Salesforce Fields represent the call in Service Cloud Voice. For more information, see Synchronize call attributes with Salesforce VoiceCall records.

Also, see Voice Call Fields in the Salesforce documentation.

To make and receive voice calls, add users to the contact center. You can associate a user with only one contact center at a time.

To add users to the contact center in Salesforce:

  1. Click Add Contact Center Users.
  2. Under the Contact Center Users section, click Add.
  3. In the Add Contact Users window, all the users with the Contact Center Admin or Contact Center Agent permission sets are listed. Select the users from the list and click Done.