The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes common problems encountered with Agent Login on Cisco Unified Contact Center Express (UCCX) with Cisco Agent Desktop (CAD) or Finesse.
Cisco recommends that you have knowledge of these topics:
Cisco Unified Contact Center Express (UCCX)
Cisco Agent Desktop (CAD) or Cisco Finesse
This document is not restricted to specific software and hardware versions.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
UCCX CAD or Finesse login failure with the error message below:
CAD: Login failed due to a configuration error with your phone and jtapi or unified CM
Version 11.5 and below: The device associated with that extension or dial number is invalid
Version 11.6: Device not accessible. Contact your system administrator
Step 1. Ensure that the IP Contact Center (IPCC) extension is unique. The Java Telephony Application Programming Interface (JTAPI) component of UCCX does not support shared lines. Log in to Cisco Unified Communications Manager (CUCM) and check the IPCC Directory Number (DN) under Call Routing->Route Plan Report.
While unsupported, if you have an IPCC extension shared on multiple devices and only one of them is associated to the Resource Manager Contact Manager (RMCM) user, you typically won't experience agent login issues. If you have more than one devices associated to the RMCM user, you can experience login problems, and you must follow this procedure to eliminate this
Remove the shared device from the RMCM user
Remove the instance of the shared line from the other device
If you still experience problems, remove the actual agent phone from RMCM user, reset the phone and add the device back into the RMCM user
If problem persists, restart the Cisco Unified Contact Center Express (CCX) Engine service in a maintenance window
Note: The RMCM user is created as a part of the UCCX post-installation process with CUCM. UCCX automatically creates this user on CUCM and all agent phones are associated to this user manually from CUCM. Any updates or changes to this user from CUCM is not supported and can lead to problems with the Cisco Unified CCX Engine Service.
Step 2. Ensure that there is only one line instance for the IPCC extension. The IPCC extension must not be a part of line group or shared
Note: Shared line definition from CUCM perspective means that a line with the same DN can exist in different partitions. The constraints for UCCX Agent Extension is strict where the IPCC extension is not allowed on different partitions. The limitation comes from JTAPI component of UCCX and can lead to intermittent agent login issues if the extension is shared.
Step 3. Check if agents use physical phones or Extension Mobility (EM) to login to CAD or Finesse. If you use EM, then ensure that the IPCC extension is associated with the EM User Device Profile (UDP) and not to the physical phone. The EM profile needs to be associated with the RMCM user.
Step 4. Ensure that the phone or UDP contains the Common Device Configuration (CDC) set to IPV4 only. If not, create a new CDC configuration for UCCX Agents with IPV4 only and associate that with the Agent phones. Go to Device -> Device Settings -> Common Device Configuration. Click Add New.
Step 5. Ensure that IPCC extension is configured on the first four lines of the phone or UDP.
Note: Cisco Unified CCX (UCCX)/JTAPI monitors the first four configured lines on the phone or the UDP. For example, if you have line 1 and line 2 configured and the IPCC extension exists on line 6, the login would work since JTAPI monitors the first four configured lines and in this example lines 3-5 are not configured.
Step 6. Ensure that the phone models are supported with CAD and Finesse. The Compatibility Matrix can be found here
Step 7. Ensure that Standard CTI Enabled, Standard CTI Allow Control of Phones supporting Connected Xfer and conf and Standard CTI Allow Control of All Devices is present in the RMCM user roles. For Finesse, there will be additional roles added for Monitoring and Recording - Standard CTI Allow Call Monitoring and Standard CTI Allow Call Recording.
Note: The groups and roles for the RMCM user are automatically configured by the system when the RMCM user is created initially. This step is only to ensure that these roles are present on the user.
Step 8. Ensure that the Max number of Calls and Busy Trigger on the phone or UDP is set to 2 and 1, respectively.
Step 9. Ensure that we follow the Supported and Unsupported Configurations for Agent Phones and CUCM from the release notes here.
Step 10. Ensure that CTI control is enabled on CUCM under:
Phone Configuration page - Allow Control of Device from CTI
End User Configuration page - Allow Control of Device from CTI
Directory Number Configuration page for IPCC extension - Allow Control of Device from CTI