排除UCCX代理登录问题

简介

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

先决条件

要求

Cisco 建议您了解以下主题：

• 思科统一联系中心快捷版(UCCX) 
• Cisco Agent Desktop(CAD)或Cisco Finesse

使用的组件

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

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

问题：UCCX CAD登录失败，消息为“Login failed due to a configuration error with your phone or jtapi or 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)，并在Call Routing -> Route Plan Report（呼叫路由 — >路由计划报告）下检查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代理扩展的限制是严格的，在不同分区上不允许IPCC扩展。限制来自UCCX的JTAPI组件，如果分机共享，可能会导致间歇性的座席登录问题。

步骤 3：检查座席是否使用物理电话或分机移动(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上前四条已配置线路。例如，如果您配置了行1和行2，并且IPCC分机位于行6上，则登录将起作用，因为JTAPI会监控前四行配置，并且在本示例中未配置行3-5。

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

步骤 7：确保RMCM用户角色中已启用标准CTI、标准CTI允许控制支持已连接Xfer和conf的电话和标准CTI允许控制所有设备。对于Finesse，为监控和录制添加了其他角色：标准CTI允许呼叫监控和标准CTI允许呼叫记录。

注意：最初创建RMCM用户时，系统会自动配置RMCM用户的组和角色。此步骤仅用于确保这些角色存在于用户上。

步骤 8::确保电话或UDP上的Max number of Calls和Busy Trigger分别设置为2和1。

步骤 9：请确保遵循版本说明中的Supported and Unsupported Configurations for Agent Phones and CUCM(代理电话和CUCM支持和不支持配置)

步骤 10：确保在CUCM上启用CTI控制，如下所示：

• Phone Configuration页面 — Allow Control of Device from CTI
• “最终用户配置”(End User Configuration)页面 — 允许从CTI控制设备
• IPCC扩展的“目录号配置”页 — 允许从CTI控制设备

步骤 11：缺陷Cisco Bug ID CSCvb94130 — “UCCX:座席在交换电话后无法登录Finesse”可能适用于间歇性问题。

相关信息

• 思科统一联系中心的兼容性信息
• 技术支持和文档 - Cisco Systems