Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

CloudCX's integration with Salesforce allows you to easily access enables seamless access to customer information in within the CloudCX Agent Console and synchronize facilitates the convenient synchronization of data conveniently from CloudCX to Salesforce. The This integration delivers ensures a consistent uniform customer information management experience and improves enhances agent efficiencyproductivity.

Table of Contents

...

This platform offers two methods for a Tenant to connect to Salesforce:

  • Connect to Salesforce

...

  • through the default CRM application configured by the provider.

  • Connect to Salesforce

...

Connect CloudCX to Salesforce CRM

  1. Go to your CloudCX system CloudCX installation domain, and log in with the admin account.

  2. From the left navigation menu, go to App & Integrations.

  3. Select the Salesforce card, and click on “Settings”.

...

...

Table of Contents

...

Connect to Salesforce CRM

Prerequisites

To connect with Salesforce, your CloudCX system administrator needs to complete the integration in the CloudCX admin system > Connector Hub Settings > Salesforce. You can find more details about Integrate with SalesforceIntegrate with CRM Application-Salesforce.

Step by Step Instructions

  1. Click on “Connect with Salesforce” and then login with your Salesforce account.

Note: You need to have particular sets of permissions in your Salesforce account for the integration to work. It is recommended that you use an Admin SF account.

...

  1. Click on “Allow” to approve the permission requests from your CloudCX system, the Salesforce connect page will be closed automatically.

...

  1. The connected Salesforce account will be showed on the App & Integrations > Settings. Now, CloudCX will be able to save or update visitor’s information to the connected Salesforce account.

Connect to Salesforce with custom configuration

Create A Salesforce App

To integrate with Salesforce, you have to create a Salesforce app in your Salesforce.

Prerequisites

  1. A valid Salesforce Account.

  2. An account that has the Administrator role.

Create A Salesforce App

  1. Go to your Salesforce portal and click on “Setup”.

...

  1. Go to PLATFORM TOOLS > Apps > App Manager, click on “ New Connected App”.

...

  1. In the Basic Information, enter basic details like the Connected App Name, API Name and Contact Email.

...

  1. In the API(Enable OAuth Settings), select Enable OAuth Settings and add the Authorized Redirect URL https://your_cx_domain/api/v2.0/integration/app/callback/api/salesforce to the Callback URL.

...

  1. Select and add OAuth Scopes to the Selected OAuth Scopes.

...

  1. Select the required permissions mentioned below for your Salesforce App, then click on “Save” to create the App.

...

Require Secret for Web Server Flow

Require Secret for Refresh Token Flow

Enable Client Credentials Flow

Enable Authorization Code and Credentials Flow

Require user credentials in the POST body for Authorization Code and Credentials Flow

Note: Please do not select the ”Require proof key for Code Exchange (PKCE) Extension for Supported Authorization Flows” permission, otherwise your CloudCX will not be able to connect Salesforce properly.

...

  1. Re-enter App Manager, find the newly created connected app in the list on the left, click on “View” to go to Manage Connected Apps.

...

  1. In the Manage Connected Apps, click on “Manage Consumer Details

...

In the Consumer Details, you will have to obtain the Consumer Key and Consumer Secret. These values will be required while setting up in the Salesforce custom configuration.

...

Configure Salesforce Integration in CloudCX

  1. Click on “custom configuration” enter the custom configuration page.

...

  1. Enter the below requested values, then click on “Next”. The Salesforce custom configuration page will be closed automatically.

...

  1. Go to your CloudCX system CloudCX installation domain, and log in with the admin account.

  2. From the left navigation menu, go to App & Integrations.

  3. Select the Salesforce card, and click on “Settings”.

...

  1. Click on “Connect with Salesforce” and then login with your Salesforce account.

Note: You need to have particular sets of permissions in your Salesforce account for the integration to work. It is recommended that you use an Admin SF account.

...

  1. Click on “Allow” to approve the permission requests from your CloudCX system, the Salesforce connect page will be closed automatically.

...

  1. The connected Salesforce account will be showed on the App & Integrations > Settings. Now, CloudCX will be able to save or update visitor’s information to the connected Salesforce account.

Configure Salesforce in CloudCX

After connecting CloudCX with your Salesforce, you need to choose whether you want CloudCX to record Web Chat / Inbox data as Lead details, Contact details, or create a Case in your Salesforce account.

Automatically Create Lead/Contact/Case/Task in Web Chat/Inbox

  1. Select “Automatically”, then specify in each section what data the CloudCX will automatically create into the Salesforce.

...

  1. Click on “Save“ to save the Salesforce configuration.

...

For Sales: Record Visitors as Leads and Chats/Conversations as Tasks

A lead will be automatically created for each visitor who cannot be found from the existing leads in the Salesforce account, and a task is automatically created for each chat/conversation of the visitor.

...

When creating a new lead, the chat/conversation of the lead is attached as a task under the lead. For an existing leads, each chat/conversation from the lead will be automatically added as a task.

...

For Support: Record Visitors as Contacts and Chats/Conversations as Cases

Contact will be automatically created for each visitor who cannot be found from the existing contacts in your Salesforce account, and a case is automatically created for each chat/conversation of the visitor.

...

When creating a new contact, the chat/conversation of the contact is attached as a case under the contact. For an existing contact, each chat/conversation from the contact is attached as a case.

...

Update Contact Information

If a visitor can be found from the existing contacts in your Salesforce account, options are available to decide whether the contact information will be overwritten:

  • Do not update the contact information.

  • Update the contact with information from WebChat/Inbox

  • Only add new information (Do not overwrite existing information)

Manually Create Lead/Contact/Case/Task in Web Chat/Inbox

If you don’t want to create Lead/Contact/Case/Task automatically, you can create them manually in prefer not to automatically generate Lead, Contact, Case, or Task entries, you have the option to create them manually within your CloudCX Agent Console. Manually click on Simply select the desired action you want to perform, and the corresponding relevant data will be recorded logged in your Salesforce account.

...

  1. Click on “Save“ to save the Salesforce configuration.

...

Web Chat/Inbox Data You Can Get in Salesforce

Contact/Lead Details

CloudCX Fields in Web Chat

CloudCX Fields in Inbox

Salesforce Contact Fields

Salesforce Lead Fields

Agent who chatted with the contact/lead

Agent who conversated with the contact/lead

Contact Owner

Lead Owner

Name

Last Name

Last Name

Last Name

Email

Email

Email

Email

Phone

Cell Phone

Business Phone

Phone

Company

Company Name

Company in Case Details

Company

Case/Task Details

CloudCX Fields in Web Chat

CloudCX Fields in Inbox

Salesforce Case Fields

Salesforce Task Fields

Agent who chatted with the contact/lead

Agent who conversated with the contact/lead

Case Owner

Task Owner

Name

Last Name

Name

Subject

Email

Email

Email Address

Subject

Phone

Cell Phone

Phone

Business Phone in Contact Fields

Company

Company Name

Company

/

Tenant ID

Tenant ID

Subject

Subject

Chat Channel

Chat Channel

Subject

Subject

Chat Content

Conversation Content

Description

Comments

Chat ID

Conversation ID

Description

Comments

Note

Note

Description

Comments

Agent Wrap-up

/

Description

Comments

Start Time

Start Time

Description

Comments

End Time

End Time

Description

Comments

Custom Fields and Custom Variables

/

Description

Comments

Attachments

Attachments

Attachment section in Case Details

Attachment section in Comments Details

Note: While creating a new contact, CloudCX will set your existing Salesforce user who has the same email address as the chatting agent as the Contact Owner. If no such user is found, the user whose account connects CloudCX with Salesforce will be set as the owner. The same rule is applied to the Lead Owner, Case Owner, and Task Owner.

Disconnect

...

Salesforce CRM

Click on the “disconnect” Disconnect” icon to open a confirmation window for disonnect to disconnect the Salesforce account.
Click on “Disconnect” button to disonnect disconnect the Salesforce account, or click on “Cancel” to cancel the disconnection.

...