Description
Prerequisites
- Access to Salesforce Service Cloud.
- Created endpoint compatible with Salesforce.
Configuration on the handover provider side
Configure Salesforce service cloud
Configure Salesforce service cloud
- Log in to Salesforce.
- If no chat deployment is available in Salesforce, use the following guides:
-
On the Salesforce home page, navigate to Feature Settings > Service > Chat > Chat Settings. On the Chat Settings page, go to the API Information > Chat API Endpoint. Copy the Chat API Endpoint value without the
/chat/restpart, for example,https://x.xxx-xx-xxx.salesforceliveagent.com. Save it for future use. -
Navigate to Feature Settings > Service > Embedded Service > Embedded Service Deployments. In the row with the deployment you want to use, click
, then select View. -
In the Embedded Service Code Snippets section, click Get Code. Copy and save the values from the following parameters without the single quotes
'':deploymentIdbuttonIdorganizationId
Configuration on the Cognigy side
1. Create a handover provider
1. Create a handover provider
- Go to Deploy > Handover Providers and click + Create handover provider.
- In the Create handover provider dialog, select Salesforce and click Create handover provider. The handover provider editor opens.
- In the handover provider editor, configure the following:
- Click Save changes.
2. Add a handover to human agent node
2. Add a handover to human agent node
In the Handover to Human Agent node, select the provider you created in the Handover provider field, then configure the fields below it:
- Send transcript as first message — the setting allows Salesforce to receive the conversation transcript as the first message. This setting is turned off by default.
- Button ID — the ID of the Button you created in the Salesforce installation. This setting overrides the Button ID defined in the handover provider settings. You can use different Button IDs for individual Handover to Human Agent nodes.
- Pre-chat entities and Pre-chat details — the additional context sent in a custom JSON structure, providing the information before engaging with the human agent.
2.1 Configure pre-chat entities and details
2.1 Configure pre-chat entities and details
By default, Cognigy doesn’t send a conversation transcript from the chat with the agent to the chat with the human agent. If you activate the Send transcript as first message setting, Cognigy sends the conversation transcript to the chat with the human agent as the first message. The conversation transcript includes the entire chat between the user and the agent.The conversation transcript is displayed when the human agent receives the first message from the user and can be found in the Salesforce Service Console, under the Transcripts tab, in the Transcript > Details > Transcript > Body section.Moreover, Cognigy allows users to send Pre-chat Details and Pre-chat Entities arrays as a custom JSON structure. This feature allows users to include additional context or relevant information before initiating the chat with the human agent. This information can then be used for further processing or personalizing the conversation based on the provided details.Pre-chat entitiesCognigy allows the creation of fields
and linking User details obtained through Pre-Chat Details to Salesforce Entities like Contact or Case.To do this, you must send the Pre-Chat Entities array to the live chat session on Salesforce.The JSON example shows how to connect the conversation to a Case and use Pre-Chat Details:Pre-chat detailsCognigy allows sending conversation information to Salesforce Live Agent using Pre-chat Details.By using the entityMaps field, this information can be mapped to specific Pre-Chat Entity fields.CognigyScript can fetch values from Cognigy input, profile, and context objects before sending the data.For more information about the Pre-Chat Entities and Pre-Chat Details fields and their usage, read the Salesforce API documentation.To check the handover, go to the installation that your server administrator has deployed.
Additional configuration
Agent Copilot workspace
Agent Copilot workspace
To integrate Agent Copilot directly into Salesforce Service Cloud, refer to the Salesforce Integrations documentation on GitHub.