在 Dynamics 365 渠道集成框架 2.0 中启用出站通信 (ClickToAct)

重要

  • 在不进行任何自定义的情况下使用此功能所需的最低版本是:
    • 平台版本:9.1.0000.15343
    • Dynamics 365 渠道集成框架 2.0:9.2.1.690
  • Dynamics 365 Sales 的聚焦视图中不支持 ClickToAct 事件。

启用出站通信时可以自定义或不自定义,如下所示:

  • 要使用电话控件上的自定义功能启用出站通信,请按照步骤 1 到 4 操作。
  • 要启用出站通信而不进行任何自定义,请执行步骤 1、3 和 4。

要为您的渠道启用出站通信,您必须执行以下操作:

  1. 使用 Copilot Service 管理中心,为特定渠道提供程序启用出站通信。 详细信息:为出站通信配置渠道提供程序

  2. 在统一界面窗体中,将渠道通信控件添加到要启用出站通信 (ClickToAct) 的电话字段中,然后发布自定义。 详细信息:将渠道通信控件添加到统一界面窗体

  3. 使用 Microsoft.CIFramework.addHandler 方法在 JavaScript 代码中注册事件处理程序。 详细信息:使用 onclicktoact 事件在 JavaScript 代码中注册事件处理程序

  4. 选择移动电话图标可触发 onclicktoact 事件。 详细信息:触发 onclicktoact 事件

为出站通信配置渠道提供程序

使用 Copilot Service 管理中心执行以下操作:

  1. 在站点地图中,选择代理体验中的工作区。 将打开工作区页。

  2. 第三方语音渠道提供程序选择管理

  3. 可用渠道提供程序列表中选择一个提供程序,然后选择编辑

  4. 常规选项卡中,将启用出站字段设置为

将渠道通信控件添加到统一界面窗体

您可以根据您的组织和业务要求添加渠道通信控件。 以下步骤描述了如何在联系人实体下为主要类型的联系人窗体添加渠道通信控件。

  1. 登录到 Dynamics 365。

  2. 转到设置>自定义

  3. 展开实体>联系人,选择窗体
    展开联系人实体并选择窗体。

  4. 从列表中选择主要类型的联系人窗体。
    选择主要类型的联系人窗体。

  5. 选择要为其添加控件的电话字段。 双击商务电话移动电话字段。
    将显示字段属性对话框。

  6. 字段属性对话中,选择控件选项卡,然后选择添加控件... 选项。
    选择电话,选择“控件”选项卡,然后选择“添加控件”选项。

  7. 添加控件对话中,选择渠道通信控件,然后选择添加
    选择渠道通信控件并选择添加。

  8. 字段属性对话中,选择 Web电话平板电脑单选按钮,然后选择确定
    选择 web、电话和平板电脑单选按钮。

  9. 选择保存,然后选择发布发布所有自定义。

使用 onclicktoact 事件在 JavaScript 代码中注册事件处理程序

在函数初始化期间,注册 onlicktoact 事件的处理程序。

function initCTI() {
    Microsoft.CIFramework.setClickToAct(true);
    Microsoft.CIFramework.addHandler("onclicktoact", clickToActHandler);
    log("Added clickToActhandler to the panel");
}

确保在您自己的初始化代码中添加 initCTI(软件电话示例代码中的初始化方法)。

触发 onclicktoact 事件

选择移动电话图标可触发 onclicktoact 事件,如下所示。

有自定义的移动电话 没有自定义的移动电话图标
选择移动电话图标可触发 onclicktoact 事件 选择移动电话图标可触发 onclicktoact 事件

注释

仅当您在渠道提供程序配置中以编程方式将 setClickToAct API 设置为 true 或将启用出站通信配置为时,Dynamics 365 渠道集成框架才会调用 onclicktoact 事件。

添加 Dynamics 365 渠道集成框架 2.0 解决方案作为依赖解决方案
实体引用
setClickToAct
getClickToAct
onclicktoact