CX 协同 Salesforce 插件

使用 外部事件 时， UiPath CX 配套 SF 插件 支持 CX 配套与 Salesforce 的开箱即用集成。请阅读以下部分，了解如何安装和配置该插件。

先决条件

开始之前，请确保：

• 您拥有系统管理员配置文件访问权限。

  备注：

  您可以使用当前的 Salesforce 组织，也可以在开发组织中进行测试。

• 您的 Salesforce 版本为Enterprise 、 Unlimited或Developer 。

安装托管包

1. 访问 AppExchange 列表。

请按照以下步骤安装UiPath-CX-Companion-SF-Plugin托管包：

1. 打开网页浏览器并转到Salesforce AgentExchange 。

2. 在搜索栏中，键入： UiPath CX Companion SF Plugin 。

3. 单击应用程序列表，然后选择“立即获取” 。

4. 使用您的 Salesforce 凭据登录。

5. 选择安装位置和对象。

   1. 选择要将安装程序设置到的环境：
      • 生产- 如果您准备在实时 Salesforce 环境中使用该应用程序，请选择此项。
      • 沙盒- 如果要在投入生产环境之前对其进行测试，请选择此项。
      备注：

      如果您使用的是插件的预览版，则此步骤不可用。

   2. 选择“为特定用户安装” 。

   您可以选择将此托管包提供给部分或所有用户。3. 选择“我确认正在安装非 Salesforce 应用程序，该应用程序未获授权作为 Salesforce 的 AppExchange 合作伙伴计划的一部分进行分发。”。 4. 单击“安装” 。 5. 批准https://*.uipath.com第三方访问权限，这将启用对 uipath.com 上托管的 CX 配套应用程序的受信任访问。6.安装完成后，单击“完成” 。

   安装完成后，新安装的托管包UiPath CX 配套 SF 插件将显示在“已安装的包”列表中。

   

分配权限和平台缓存

1. 分配权限集请按照以下步骤操作，以确保已为其安装托管软件包的用户获得所需的权限。

   1. 导航至“设置” > “用户” > “权限集” ，然后找到“UiPath CX 助理” 。
   2. 选择“管理分配” > “添加分配” 。
   3. 选择所需用户。
   4. 单击“下一步” ，然后单击“分配” 。

2. 分配平台缓存我们需要将平台缓存配置为该应用程序的可重用内存，以存储活动 Salesforce 记录 ID 的数据。确保平台缓存按如下方式分配：

   1. 导航至“设置” > “平台缓存” 。
   2. 找到“Cx 配套缓存” ，然后单击“编辑” 。
   3. 指定以下容量 (MB)
      • 会话缓存分配-组织或试用（以可用者为准）： 2
      • 组织缓存分配-组织或试用（以可用者为准）： 1
      备注：

      对于 Salesforce Developer Edition (DE)，如果试用容量不可用，您可以通过单击请求试用容量来请求试用容量。

   4. 单击“保存”。

   

将 CX 协同应用连接到插件

1. 识别托管 CX 协同的 URL。有关获取应用程序 URL 的信息，请参阅配置 CX 助理应用程序>嵌入应用程序。

2. 设置受信任 URL。

   要允许 CX 合作伙伴的 iframe 在 Lightning 网页组件 (LWC) 中呈现，必须将 Salesforce 实例配置为信任托管 CX 合作伙伴的站点。

   1. 导航至“设置” > “受信任的 URL” 。
   2. 在列表中找到CXCompanion_Iframe ，然后单击“编辑” 。
   3. 将“CSP 上下文”选择为“全部” 。
   4. 选择“connect-src”和“frame-src”选项，然后单击“保存”

3. 修改自定义元数据类型。

   LWC 需要为 CX 协作者配置自定义元数据，才能将内容传递到 CX 协作者 iframe 应用程序中。

   1. 导航至“设置” > “自定义元数据类型” 。
   2. 对于CX 附带设置标签，选择“管理记录” 。安装受管理包时，系统会自动创建此标签。

   3. 对于“默认”标签，请单击“编辑” 。 4. 将 CX 助理的应用程序 URL 粘贴到“应用程序 URL”字段中。 5. 在目标源中提供目标源作为 CX 助理 URL 的主机名，例如https://cloud.uipath.com 。6.如果通过 SF 记录页面中的操作按钮启动 CX 合作伙伴，则以下字段定义调用窗口的尺寸。您可以根据需要更改这些设置。默认值为：

   • 记录操作组件宽度：1200
   • 记录操作组件高度：800
   备注：

   仅当 CX 助手配置为对象“记录页面”上的操作按钮时，这些维度和标题才适用。

   7. 单击“保存” 、

   

定位 CX 伙伴

在 Salesforce 用户界面中定位 CX 协作者启动按钮的位置有两个选项：

• 作为对所有对象可见的实用程序栏项目。
• 作为“对象记录”页面上的操作按钮。

作为实用程序栏项目的位置

对要在其中启用 CX 协作模式的每个应用程序执行以下步骤销售控制台）。这将确保当用户在该应用程序中时，CX 助理在实用程序托盘中可见。

在以下说明中，CX 助手将作为实用程序栏项目添加到服务控制台中。

1. 导航至“设置” > “应用程序管理器” 。

2. 对于“服务控制台”选择“编辑” 。

3. 在左侧面板的“实用程序项目（仅限桌面版）”下，单击“添加实用程序项目” 。

   • 在弹出窗口中搜索 Lightning 网页组件cxCompanion ，并将其选中。
   • 输入将在“实用程序栏”中显示的标签（例如CX 伙伴），然后选择适当的图标。
   • 指定“面板宽度” （建议1000像素）和“面板高度”（建议520像素）。
   • 选择“启用刷新按钮” ，该按钮将显示在 LWC 中，并允许使用活动 SF 对象中的数据刷新 CX 合作伙伴。
   • 单击“保存”。

   

4. 对于实用程序栏对齐方式，选择所需的对齐方式，然后单击“保存” 。

   • 如果选择“默认” ，则实用程序栏会显示在屏幕的左下方。
   • 如果选择“镜像” ，则实用程序栏会显示在屏幕的右下角。

作为对象“记录页面”上操作按钮的位置

对于要为“对象记录”页面创建新操作按钮的每个对象，请按照以下步骤操作。以下说明将指导您将 CX 助手添加为“案例记录”页面上的操作按钮。

1. 导航至“设置” > “对象管理器” ，为对象创建新操作。

2. 搜索要为其添加快速操作的对象（例如案例) 并打开它。

3. 在左侧面板上选择“按钮”、“链接” 和“操作” ，然后单击“新建操作” 。

4. 对于“操作类型” ，选择“ Lightning 网页组件 ” 。

5. 对于Lightning 网页组件（使用 语法），请选择uipathsf:cxCompanionRecordAction 。

6. 在“标签”框中，输入将显示在按钮上的标签（例如CX Companion ），然后选择适当的图标。系统将自动填充“名称”字段。

7. 单击“保存”。

   

8. 导航到“设置” > “对象管理器” ，以将此操作添加到 Lightning 记录页面。

9. 搜索要为其添加快速操作的对象（例如案例) 并打开它。

10. 单击左侧面板上的“闪电记录页面” 。

11. 转到任何 Salesforce 记录页面，然后单击“编辑” 。

12. 选择记录页面上的高亮面板，然后在右侧面板上单击“添加操作”以添加动态操作。

13. 搜索CX Companion ，然后单击“完成” 。

14. 单击“保存”。

    

15. 将在案例记录页面上添加一个按钮，用于在新的弹出窗口中启动 CX 助手。

    备注：

    “CX 联合窗口”的维度和标题将由在前面的步骤“修改自定义元数据类型”中指定的内容决定。

将 SF 对象字段传递到 CX 伙伴

请按照以下步骤配置 CX 助理设置应用中的对象字段。

1. 单击“应用启动器” ，搜索并选择应用程序“CX 助手设置” 。

2. 选择“CX 附带对象配置”选项卡。

3. 在“对象”下拉列表中，选择您先前通过 CX 协作启用的任何对象（例如帐户对象）。

   如果“对象”下拉列表中没有要添加的对象：

   1. 选择“其他”选项。
   2. 在文本框中指定对象的 Salesforce 记录 ID（15 或 18 位数字），然后单击“检索元数据” 。例如，要添加联系人对象，请输入任何有效联系人的 SF 记录 ID，例如在文本框中输入 0030x0000eUIKSIA4。
   3. 现在将显示对象的字段。继续执行步骤 4。

4. 在“字段”部分中，选择必须发送给 CX 助理的字段。确保最终用户有权访问所选字段。

   

5. 从“标头”部分中选择最多两个字段，这些字段将显示为 CX 合作伙伴的标头。

6. 单击“保存”以保存配置。可能需要一些时间来保存值，并将更改反映在 CX 业务合作伙伴中。