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 凭据登录。
   重要提示：

   CX 配套 SF 插件当前处于预览阶段，正在等待 Salesforce 的批准。您可以通过以下方式之一获取预览版：

   • 使用托管包 URL 下载: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPa000002FWpeIAG
   • 从https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAG下载
     其中<yourSalesforceDomain>是您实际的 Salesforce 组织域。
2. 选择安装位置和对象。
   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 业务合作伙伴中。