解决代理登录问题

简介

本文档介绍如何使用Cisco Agent Desktop(CAD)或Finesse解决Unified Contact Center Express(UCCX)上的座席登录故障。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科统一联系中心快捷版(UCCX) 
• 思科座席桌面(CAD)或Cisco Finesse

使用的组件

本文档不限于特定的软件和硬件版本。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

问题：UCCX CAD登录失败并显示消息“由于您的电话或jtapi或unified CM的配置错误而导致登录失败”。

参见解决方案。

问题：UCCX Finesse登录失败并显示消息“与该分机号或拨号号码关联的设备无效”。

注意：此消息适用于Finesse版本11.5及更低版本。

参见解决方案。

问题：UCCX Finesse登录失败并显示消息“Device not accessible（设备不可访问）”。请与您的系统管理员联系。”

注：此消息适用于Finesse版本11.6。

参见解决方案。

解决方案

第1步：确保IP联系中心(IPCC)分机是唯一的。UCCX的Java电话应用编程接口(JTAPI)组件不支持共享线路。登录到Cisco Unified Communications Manager(CUCM)，并在呼叫路由 — >路由计划报告下检查IPCC目录号码(DN)。

虽然不受支持，但如果在多个设备上共享一个IPCC分机且仅其中一个与资源管理器联系人管理器(RMCM)用户关联，则通常不会遇到代理登录问题。如果您有多个设备与RMCM用户关联，则可能会遇到登录问题，您必须执行此过程才能消除此问题。

• 从RMCM用户中删除共享设备。
• 从其他设备删除共享线路的实例。
• 如果仍然遇到问题，请从RMCM用户中删除实际的座席电话，重置电话并将设备重新添加到RMCM用户。
• 如果问题仍然存在，请在维护窗口中重新启动Cisco Unified Contact Center Express(CCX)引擎服务。

注意：RMCM用户是作为CUCM的UCCX安装后流程的一部分创建的。UCCX在CUCM上自动创建此用户，并且所有座席电话都从CUCM手动关联到此用户。不支持从CUCM对此用户进行任何更新或更改，这会导致Cisco Unified CCX引擎服务出现问题。

第2步：确保IPCC分机仅有一个行实例。IPCC分机号不能是线路组的一部分或共享的。

注意：从CUCM角度进行的共享线路定义意味着具有相同DN的线路可以存在于不同的分区。UCCX Agent Extension的限制是严格的，不同分区上不允许使用IPCC扩展。此限制来自UCCX的JTAPI组件，如果分机是共享的，则可能导致间歇性的代理登录问题。

第3步：检查座席是否使用物理电话或Extension Mobility(EM)登录CAD或Finesse。如果使用EM，请确保IPCC分机与EM用户设备配置文件(UDP)相关联，而不是与物理电话相关联。EM配置文件需要与RMCM用户关联。

第4步：确保电话或UDP包含仅设置为IPV4的通用设备配置(CDC)。否则，请为仅使用IPV4的UCCX代理创建新的CDC配置，并将其与代理电话关联。转至Device -> Device Settings -> Common Device Configuration。单击新增。

第5步：确保在电话或UDP的前四行上配置IPCC分机。

注意：Cisco Unified CCX(UCCX)/JTAPI监控电话或UDP上配置的前4条线路。例如，如果您配置了行1和行2，并且行6上存在IPCC分机，则登录将起作用，因为JTAPI监控前四行配置，并且在本示例中未配置行3-5。

第6步：确保CAD和Finesse支持电话模型。请参阅Cisco Unified Contact Center兼容性信息。

第7步：确保RMCM用户角色中存在Standard CTI Enabled、Standard CTI Allow Control of Phones supporting Connected Xfer and conf和Standard CTI Allow Control of All Devices。对于Finesse，还为监控和录制添加其他角色：标准CTI允许呼叫监控和标准CTI允许呼叫录制。

注:RMCM用户的组和角色在最初创建RMCM用户时由系统自动配置。此步骤只是为了确保这些角色存在于用户上。

第8步：确保电话或UDP上的“最大呼叫数”和“忙时触发器”分别设置为2和1。

第9步：确保使用版本说明中支持的和不支持的座席电话和CUCM配置。

第10步：确保在以下情况下在CUCM上启用CTI控制：

• “电话配置”页 — 允许从CTI控制设备
• “最终用户配置”页 — 允许从CTI控制设备
• IPCC分机的“目录号码配置”页 — 允许从CTI控制设备

第11步：缺陷Cisco Bug ID CSCvb94130 — “UCCX: Agent unable to login to Finesse after switching phones（UCCX：代理在切换电话后无法登录到Finesse）”可能适用于间歇性问题。

注意：只有思科注册用户才能访问思科内部工具和信息。

相关信息

• Cisco Unified Contact Center兼容性信息
• 思科技术支持和下载