Salesforce Chat 集成

此聊天集成使用 Salesforce Lightning Web 组件 (LWC) 与 Agent Assist 界面模块集成，以进行聊天对话。

下面简要介绍了聊天集成：

Agent Assist 聊天与 Salesforce 集成的架构

准备工作

如需将 Agent Assist 界面模块与 Salesforce 集成，您需要能够访问以下资源：

Node.js：请按照建议的安装说明操作，以便在您的操作系统上安装 Node.js。
Salesforce CLI：按照建议的安装说明针对您的操作系统进行安装。
Google Cloud CLI：按照说明安装 gcloud 命令，并使用 gcloud auth login 进行身份验证。
Salesforce：在您的实例网址或 Salesforce 登录页面中登录，并注意以下事项：
- 您的 Salesforce “我的网域”网址。请按以下步骤查找我的网域网址：
  1. 前往菜单栏 > 设置菜单。
  2. 点击 Setup（设置）。
  3. 在快速查找框中，输入我的网域。域名采用以下格式：MY-DOMAIN-NAME.develop.my.salesforce.com。
- 您的 Salesforce 组织 ID。请按以下步骤查找组织 ID：
  1. 前往菜单栏 > 设置菜单。
  2. 点击 Setup（设置）。
  3. 在 Quick Find（快速查找）框中，输入公司信息。
注意：这些集成步骤仅在 Salesforce Developer Edition 中经过测试。如果您使用其他版本，功能许可和 Salesforce 界面可能会有所不同。
Agent Assist 集成后端：
1. 按照说明设置集成。
2. 在运行部署脚本之前，请使用 deploy.sh 或在项目根目录的 .env 文件中配置以下环境变量：
  - AUTH_OPTION：将此项设置为 SalesforceLWC。
  - SALESFORCE_DOMAIN：与 YOUR_SUBDOMAIN.develop.lightning.force.com 类似的域名。您已在 Salesforce 前提条件中记下此值。请注意，您不应添加 https://。
  - SALESFORCE_ORGANIZATION_ID：您在 Salesforce 前提条件中记下了此值。

第 1 步：设置 Salesforce 开发项目

如需开始集成 Agent Assist 界面模块，请按以下步骤操作。

运行以下代码以克隆 Agent Assist 集成代码库并打开您的项目：

git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
cd salesforce/aa-lwc

运行以下命令，下载您稍后将部署为静态资源的 UI 模块 JavaScript 文件。Salesforce 要求静态资源加载第三方 JavaScript。它还对静态资源文件强制执行 5 MB 的限制，因此 JavaScript 文件以 ZIP 文件形式上传。
```
npm run generate-static-resources
npm install
```

第 2 步：设置 Salesforce 环境

您可以在特定环境（例如生产环境或开发环境）中集成 Agent Assist 界面模块。Salesforce 将这些环境称为组织 (org)。

在 Salesforce 控制台中配置组织

在 Salesforce 控制台中，按照以下步骤配置组织以集成 Agent Assist。

依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入全渠道设置，然后点击全渠道设置。
1. 选择启用全渠道。
2. 在新窗口或标签页中，选择自动将客服登录到全渠道。
3. 点击保存。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入社区，然后依次点击数字体验 > 设置。
1. 选择启用体验工作区。
2. 点击保存。

使用 Salesforce CLI 配置组织

按照以下步骤操作，使用 Salesforce CLI 为 Agent Assist 集成配置组织。

运行以下代码，并使用您通常使用的 Salesforce 登录详细信息对 CLI 进行身份验证。
```
npm run login
```
运行以下代码，将 LWC 部署到组织。
```
npm run deploy
```

第 3 步：创建外部客户端应用

Salesforce LWC 使用客户端凭据 OAuth 2.0 流程对您进行身份验证。外部客户端应用可启用客户端凭据流。使用应用的使用方密钥和使用方密钥来配置 Salesforce LWC，以便通过 Salesforce 对用户进行身份验证。

依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入外部客户端应用管理器。
1. 依次点击外部客户端应用管理器 > 新建外部客户端应用 > 创建，然后输入以下信息。
  - 外部客户端应用名称：lwc auth
  - API 名称：lwc_auth
  - 联系电子邮件地址：your_email@example.com
  - API (Enable OAuth Settings) > Enable OAuth：已选中
  - API (Enable OAuth Settings) > Callback 网址： https://login.salesforce.com/services/oauth2/callback
  - API (Enable OAuth Settings) > Selected OAuth Scopes：访问身份网址服务
  - API (Enable OAuth Settings) > Enable Client Credentials Flow：已选择
2. 点击创建。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入外部客户端应用管理器。
1. 依次点击外部客户端应用的名称 > 修改。
2. 依次前往 OAuth 政策 > OAuth 流程和外部客户端应用增强。
3. 确保已选中启用客户端凭证流程。
4. 在以此身份运行字段中，输入您的登录用户名。
5. 点击保存。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入外部客户端应用管理器。
1. 依次点击外部客户端应用的名称 > 修改。
2. 依次前往 OAuth 设置 > 应用设置 > Consumer Key and Secret。
3. 输入发送到您电子邮件地址的验证码。
4. 将使用方密钥和使用方密钥复制到安全的地方。您将在后续步骤中用到这些信息。

建立 CORS 和内容安全政策

依次前往菜单栏 > 设置菜单，然后点击设置。
在快速查找框中，输入 CORS，然后点击修改。
1. 选择为 OAuth 端点启用 CORS。
2. 点击保存。
依次前往菜单栏 > 设置菜单，然后点击设置。
在 Quick Find（快速查找）框中，输入 Trusted 网址s（可信网址），然后点击 New Trusted 网址（新建可信网址）。
请输入以下信息：
- API 名称：ui_connector
- 网址：输入您通过 Agent Assist 集成后端部署的界面连接器 Cloud Run 服务端点的网址。您可以在 Cloud Run 控制台中找到此网址。例如：https://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app。
- CSP 指令：选中所有复选框。
- 点击保存并新建。
请输入以下信息：
- API 名称：ui_connector_wss
- 网址：输入界面连接器服务端点的安全 WebSocket 网址：wss://UI_CONNECTOR_SUBDOMAIN.GCP_REGION.run.app。
- CSP 指令：选中所有复选框。
- 点击保存并新建。
请输入以下信息：
- API 名称：salesforce_domain
- 网址：输入您的 Salesforce 网域的网址，格式如下：https://YOUR_SUBDOMAIN.my.salesforce.com。
- CSP 指令：选中所有复选框。
- 点击保存。

第 4 步：配置聊天客户端

如需将 Agent Assist 界面模块与 Salesforce 搭配使用，您需要在客服桌面上安装聊天客户端。

配置增强版 Chat

请按照以下步骤配置即时通讯工具。

依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找中搜索队列，然后点击新建。
1. 请输入以下信息：
  - 标签：Messaging Queue
  - 队列名称：Messaging_Queue
  - 路由配置：Messaging_Routing_Configuration
2. 点击 Supported Objects，然后添加 Messaging User 和 Messaging Session。
3. 点击 Queue Members，然后添加 User: Your Login User。
4. 点击保存。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入权限集。
1. 点击消息传递代理权限集。
2. 依次点击服务状态访问权限 > 修改。
3. 选择状态忙碌和在线 - 即时通讯。
4. 依次点击添加 > 保存。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入用户，然后点击用户。
1. 点击您的用户名，然后验证服务云用户是否已启用。
2. 在页面上找到权限集许可分配。
3. 点击修改分配关系，然后选择 Enhanced Chat User。
4. 点击保存。
5. 在页面上找到权限集分配。
6. 点击修改分配，然后选择消息代理权限设置。
7. 依次点击添加 > 保存。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入消息传递设置，然后点击新渠道。
1. 选择增强型聊天。
2. 输入名称：Messaging Channel。
3. 点击保存。
4. 将路由类型设置为全渠道队列，并将队列设置为消息队列。
5. 点击保存，然后前往消息设置。
6. 点击相应即时通讯渠道的名称，然后点击启用。
7. 阅读完毕后，接受条款及条件。
依次前往菜单栏 > 设置菜单，然后点击设置。在快速查找框中，输入嵌入式服务部署，然后点击新建部署。
1. 依次点击增强型聊天 > 下一步 > 网页 > 下一步。
2. 填写以下详细信息：
  - 名称：Messaging Embedded Service Deployment
  - 开发者名称：Messaging_Embedded_Service_Deployment
  - 网域：example.com
  - 渠道：消息渠道
3. 点击保存。等待部署完成。
4. 在嵌入式服务部署设置中，点击发布。
5. 依次点击刷新和测试消息。

测试增强型聊天功能

请按照以下步骤测试您的即时通讯工具。

点击测试消息传递。
新标签页加载完毕后，点击对话气泡即可开始新的测试对话。
发送一条消息，例如 Test。
前往 Salesforce 浏览器标签页。
在设置工具栏中，点击应用启动器菜单，然后选择服务控制台。
在实用工具栏中点击全渠道。
将状态设置为在线 - 消息。
接受传入的消息。这会在服务控制台中为对话打开一个新标签页。您无法查看聊天转写内容。
前往菜单栏 > 设置菜单。
点击修改页面。
在 Components 菜单中，将 Enhanced Conversation 组件拖动到 Conversation 窗格中。
依次点击保存 > 启用 > 设为组织默认 > 桌面 > 返回。
刷新页面。
在实用工具栏中点击全渠道。
将状态设置为在线 - 消息。
回复测试消息，以验证消息传递是否正常。

如果您遇到问题并需要更多信息，请参阅全面的 Salesforce 增强型 Chat 设置指南。

第 5 步：安装 Salesforce Lightning Web 组件

按照以下步骤操作，使用 Lightning Experience 编辑器将 Salesforce LWC 添加到消息会话页面中。继续执行第 4 步中的测试对话。

前往菜单栏 > 设置菜单，然后点击修改页面。
在组件侧边栏中，将 agentAssistContainerModule 移入侧边栏。

注意： npm deploy 命令提供了此组件。
点击您在上一步中放置的组件。
填写表单字段，如下所示，以添加配置详细信息。
- 端点：代理集成后端界面连接器的网址，例如 Cloud Run 控制台中的网址，如下所示： https://UI_CONNECTOR_ENDPOINT.GCP_REGION.run.app
- 功能：对话配置文件中启用的 Agent Assist 功能，例如 CONVERSATION_SUMMARIZATION、KNOWLEDGE_ASSIST_V2、SMART_REPLY 和 AGENT_COACHING
- 渠道：表示渠道为 chat。
- 平台：指明平台为 messaging。
- conversationProfile：Agent Assist 对话配置文件资源名称（例如：projects/GCP_PROJECT_ID/locations/GCP_REGION/conversationProfiles/CONVERSATION_PROFILE_ID）
- consumerKey：第 3 步中的外部客户端应用使用方密钥。
- consumerSecret：第 3 步中的外部客户端应用使用方密钥。