Skip to main content
Salesforce handover provider logo

Description

Salesforce announced the removal date for LiveAgent, Salesforce Chat, Embedded Chat, and Service Chat. The removal date is February 14, 2026. This handover provider connector will remain active until the removal date. Before this date, migrate to a new connector for the Salesforce provider that supports Messaging for In-App and Web. If you configured the embedded Agent Copilot workspace, make sure that you update its configuration during the migration.The Salesforce handover provider bridges Cognigy and Salesforce Service Cloud, enabling end users to connect with human agents working in a contact center that uses Salesforce Service Cloud.

Prerequisites

Configuration on the handover provider side

  1. Log in to Salesforce.
  2. If no chat deployment is available in Salesforce, use the following guides:
  3. 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/rest part, for example, https://x.xxx-xx-xxx.salesforceliveagent.com. Save it for future use.
  4. Navigate to Feature Settings > Service > Embedded Service > Embedded Service Deployments. In the row with the deployment you want to use, click menu, then select View.
  5. In the Embedded Service Code Snippets section, click Get Code. Copy and save the values from the following parameters without the single quotes '':
    • deploymentId
    • buttonId
    • organizationId

Configuration on the Cognigy side

  1. Go to Deploy > Handover Providers and click + Create handover provider.
  2. In the Create handover provider dialog, select Salesforce and click Create handover provider. The handover provider editor opens.
  3. In the handover provider editor, configure the following:
  1. Click Save changes.
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.
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

To integrate Agent Copilot directly into Salesforce Service Cloud, refer to the Salesforce Integrations documentation on GitHub.

More information

Last modified on November 11, 2026