在 Microsoft Dynamics CIF v1 中安装 Agent Embedded

这些说明适用于 Microsoft Dynamics 渠道集成框架 (CIF) 版本 1。 如果您使用 CIF 版本 2，请了解如何在 Microsoft DynamicsCIF v2 中安装 Agent Embedded。

本页介绍如何在 CXone Mpower 中安装 Agent Embedded Microsoft Dynamics。 安装后，坐席即可使用它直接处理 Microsoft Dynamics 内部的交互。

此安装过程是在 Microsoft Dynamics 中进行的。 如果您无权访问这些步骤中提到的 Microsoft Dynamics 部分，请联系您组织的 Microsoft Dynamics 管理员，以确保您拥有正确的权限。

安装“渠道集成框架应用程序”

如果尚未安装“渠道集成框架”，请按照以下步骤操作。

1. 打开 Microsoft Dynamics365。

2. 单击顶部菜单中的应用程序。

3. 搜索渠道集成框架。

4. 单击 Dynamics 365 渠道集成框架卡底部的立即获取。

5. 查看概述信息，然后再次单击立即获取。

6. 同意条款和条件。 安装自动开始。

为 Agent Embedded 创建渠道提供程序

1. 在 Microsoft Dynamics365 中，打开“渠道集成框架”。

2. 在“活动渠道提供程序”菜单中，单击新建。

3. 填写“新渠道提供程序”表单中的字段。

   1. 为渠道提供程序指定名称。

   2. 输入标签。 这将显示为 Agent Embedded 的标题。

   3. 对于 Channel URL，输入您的 Agent Embedded URL，然后输入 _msd&base=，然后输入 Microsoft Dynamics 实例URL。 您的 Agent Embedded URL 是以下之一：

      • 如果您未使用 FedRAMP：https://cxagent.nicecxone.com/login?app=cxa

      • 如果您使用的是 FedRAMP：https://cxagent.nicecxone-gov.com/login?app=cxa

      例如，如果您未使用 FedRAMP，并且您的 Microsoft Dynamics 实例URL为 https://my.dynamics.com，则您的 Channel URL将为 https://cxagent.nicecxone.com/login?app=cxa_msd&base=https://my.dynamics.com。

   4. 对于启用呼出通信，请选择是。

   5. 在 渠道订单 字段中，输入 1。

   6. 在自定义参数字段中，输入width=420&version=1。

   7. 在沙盒配置字段中，输入allow-top-navigation。

   在此步骤中了解有关字段的更多信息

   字段	详细信息
   名称	Agent Embedded 的渠道提供程序的名称。
   标签	坐席将看到的 Agent Embedded 的标题。
   渠道 URL	您的 Agent Embedded URL。
   启用呼出通信	启用单击拨入 Microsoft Dynamics 的 Agent Embedded中的电话号码。
   渠道顺序	确定渠道提供程序的优先级。 如果设为 1，则该渠道提供程序将在其他渠道提供程序之前使用。 例如，如果将 Agent Embedded 设为 1，将另一个 坐席应用程序 设为 2，则会在交互时优先使用 Agent Embedded。
   API 版本	与渠道集成框架版本一致。 该值应为 1。
   受信任域	用于附加域的空间。 将此字段留空。 Agent Embedded始终使用通道URL字段中的域。
   自定义参数	用于其他设置的空间，例如宽度、高度和版本。 务必指定 version=1；如果未指定版本，系统会假定您拥有 Channel Integration Framework 版本 2 (CIF v2)。
   沙盒配置	通道提供程序的沙盒属性列表的空间。 输入以下选项之一： allow-top-navigation：允许Agent Embedded控制Microsoft Dynamics中的重定向。 allow-top-navigation-by-user-activation：允许Agent Embedded在用户执行作（例如接受呼叫）后Microsoft Dynamics 仅控制重定向。 这允许屏幕弹出和超链接工作。 如果输入任何其他属性，请用逗号分隔。

4. 在选择渠道的统一界面应用程序下，选择您希望 Agent Embedded 显示在其中的 Microsoft Dynamics 应用程序。

5. 在为渠道选择角色下，选择将使用 Agent Embedded 的坐席的角色。

6. 单击保存。