在统一服务台上使用一般侦听器

 

发布日期: 2016年11月

适用于: Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2013,Dynamics CRM 2015,Dynamics CRM 2016

Unified Service Desk 提供通用侦听器适配器,该适配器可以用作集成 Unified Service Desk 和 计算机电话服务集成 (CTI) 中间件应用程序的测试工具,其能够打开用户计算机上的 URL,此时CTI 事件发生。 通用侦听器适配器会侦听 HTTP 请求,该请求位于已知的端口(5000)上:https://localhost:5000/

本主题内容

通用侦听器如何工作

配置通用侦听器适配器的 CTI 桌面管理器托管控件

更改通用侦听器端口

通用侦听器如何工作

通用侦听器适配器会从 URL 中提取查询字符串,使用该字符串内的值作为参数,将它们评估为 CTI 事件,然后引发 Unified Service Desk内的CTI 屏幕弹窗。 一旦适配器开始在指定端口上进行侦听,它将等待 CTI 中间件打开 URL,例如:

https://localhost:5000/?ani=1234&dnis=4355&type=phonecall&customerid=49383433

在 URL 示例中,查询字符串会涌出并传递到 Global Manager 托管控件(位于 Unified Service Desk 内),用作以下参数。

参数

说明

示例 URL 中的值

ANI

代表 自动电话号码识别。 这是来电的电话号码。

ani=1234

DNIS

代表已拨电话号码识别服务。 这是客户拨打的电话号码。

dnis=4355

Type

这相应于您的窗口导航规则内的启动活动,以路由呼叫,并采取适当行动。 常见值包括 phonecallchat。详细信息:CTI 搜索

type=phonecall

Key=value pairs

可使 Global Manager 托管控件引发 CTILookUpRequest,以搜索客户记录的键值对集合。

customerid=49383433

对于 CTI 搜索,每个参数皆可用作替换参数。 一旦会话开始,可以使用 cti 前缀存取这些参数,例如:

[[cti.ani]]

要查看演示处理 CTI 事件的通用侦听器适配器用法的演练,请参阅 演练:为 CTI 事件路由使用通用侦听器适配器

配置通用侦听器适配器的 CTI 桌面管理器托管控件

使用通用侦听器适配器时,您仅需配置 CTI Desktop Manager 组件;不需要 CTI 连接器和 CTI 控件。CTI Desktop Manager 托管控件可配置为放到 HiddenPanel 上,以下标准值适用于 Unified Service Desk 内托管控件配置页的通用侦听器适配器:

  • 程序集 URI: Microsoft.Crm.UnifiedServiceDesk.GenericListener

  • 程序集类型: Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

配置 CTI 桌面管理器托管控件

有关配置 CTI Desktop Manager 托管控件(位于 Unified Service Desk 内)的详细信息,请参阅 在 Unified Service Desk 中配置 CTI 桌面管理器托管控件

更改通用侦听器端口

默认情况下,通用侦听器适配器会侦听 HTTP 请求,该请求位于端口 5000 上:https://localhost:5000/。

如果需要,您可以使用 Unified Service Desk 中的“选项”设置定义通用侦听器的其他端口。 为此:

  1. 登录到 Microsoft Dynamics 365。

  2. 转到“设置”>“Unified Service Desk”。

  3. 单击“选项”。

  4. 单击“新建”添加新选项。

  5. 在字段中键入以下值:

    字段

    客户

    GenericListener

    为侦听器指定新 URL。 例如:https://localhost:5001/

    为通用监听程序定义端口

  6. 单击“保存并关闭”。

另请参阅

构建适用于统一服务台的自定义 CTI 适配器
创建适用于统一服务台的 CTI 适配器的注意事项
UII 计算机电话服务集成 (CTI) 框架

Unified Service Desk 2.0

© 2017 Microsoft。 保留所有权利。 版权