> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/integrateandcode/human-offloading-live-chat/salesforce-service-cloud.md).

# Salesforce Service Cloud

The Chatlayer.ai Salesforce Service Cloud integration allows you to easily transfer a user from the bot to an agent active in the Salesforce Service Cloud Console.

{% hint style="info" %}
The Salesforce Service Cloud integration is available as an add-on to our Enterprise pack.
{% endhint %}

## Installation & set-up

Install the Chatlayer.ai package in the Salesforce AppExchange, and ask an administrator to follow the Setup Instructions.

![](https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MV0VdzlrIJvU0kBylQQ%2F-MV0X-OmEdBpJ4I51uyA%2Fimage.png?alt=media\&token=07017026-ee79-440a-b2a7-3ba744c5cd77)

In the final step, you will be requested to fill in the bot id, access token and version of the bot into the "Create New Configuration" window.

![](https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MV0VdzlrIJvU0kBylQQ%2F-MV0XIE90aeYEctfjqq-%2Fimage.png?alt=media\&token=e179ecc2-b8d0-4c26-b308-c2abea3ce8f4)

### Bot id

To find the bot id, navigate to the bot you want to connect into Salesforce. You can find your bot id in the URL of your bot.

`https://app.chatlayer.ai/bots/`**`thisIsYourBotId`**`/analytics/dashboard`

Copy paste your bot id into the Salesforce new configuration window.

### Access token

Create a new access token by navigating to the My bots page, navigating to Settings, Credentials and selecting "Access tokens" in the menu.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F3Eh1oTYM4HbcYsoOGCBZ%2Fimage.png?alt=media&amp;token=808665bf-2796-4b67-9fb4-54f5b8304a20" alt=""><figcaption></figcaption></figure>

Click "Generate token" to generate a new token. You can give it any name you like.

Copy paste your Access Token into the Salesforce new configuration window.

Attention: you won't be able to see this token again

### Version

You can choose to connect the Draft or Live version of your bot to Salesforce. Typically, the Draft version is used for testing, and the Live version is used by your actual customers. Learn more about bot versions here:

{% content-ref url="/pages/-LLTwJAD3Y7OKXxwVOpw" %}
[Publish your bot](/publish/publishing-your-bot.md)
{% endcontent-ref %}

### Configuring your bot to go to hand over the conversation

After filling in all required information into the "Create new configuration" window, and connecting to Chatlayer, Salesforce will be activated for your bot under Settings > Offloading

![](https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MV0YnUzTk6wpI7XRFvS%2F-MV0ZW6hHMaweXR5DeZn%2Fimage.png?alt=media\&token=73e4d8ec-5835-4785-8aec-52da1bb65bfe)

Now you can add an action to your bot that will transfer the user towards Salesforce Service Cloud. Add a go to to a new Action block.

{% hint style="info" %}
Read more about best practices on when your bot should hand over to an agent [here](/integrateandcode/human-offloading-live-chat.md).
{% endhint %}

![](https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MV0YnUzTk6wpI7XRFvS%2F-MV0ZvnuqtZH89WXCYqP%2Fimage.png?alt=media\&token=5c5bb3d6-e181-435c-a0ce-480926379424)

In this action, add a new plugin "Send to offload provider". Select "Salesforce" in the dropdown.

![](https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-MV0YnUzTk6wpI7XRFvS%2F-MV0_R8Cue_g_ArxWZQs%2Fimage.png?alt=media\&token=868d1713-6956-4003-85af-57ff5ba43b09)

When a user reaches that part of the flow, they will be transferred to a Salesforce agent.

Your Salesforce integration is ready to go!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.chatlayer.ai/integrateandcode/human-offloading-live-chat/salesforce-service-cloud.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
