Common CCC softphone error codes related to PBX programming
Problem
When attempting to start the softphone, you get the following error:
Error type: eCommsError
Error code: -1
Operation: RealtimeCallControlClient - WaitOnPendingWorkItem
Detailed message: System.TimeoutException: Softphone proxy server did not respond after 30 seconds
If you look at the Mitai proxy server logs on the server, you find the following error:
eError: … MiTAIEngine - SetExtnMonCallback: Failed to monitor device - DN:[xxxx] ReturnCode:[SXERR_PRIVILEGE_VIOLATION] Hmon:[…]
Cause
The Mitai proxy server fails to set the monitor on the requested extension because it is associated to a class of service on the PBX that has “HCI/CTI/TAPI call control allowed” and “HCI/CTI/TAPI monitor allowed” set to false.
Resolution
Either modify the class of service for the associated extension so that “HCI/CTI/TAPI call control allowed” and “HCI/CTI/TAPI monitor allowed” are set to true, or create a brand new class of service with the mentioned properties set to true.
--------------------
Problem
When attempting to start the softphone, you get the following error:
Error type: eMitaiError
Error code: 1245
Operation: GetForwardFeatureInfo
If you look at the CCC log, you will find the following error:
eError: … SoftphoneConfig::populateForwardingInfo: Operation failed - MessageTag:[3] ReturnCode:[SXERR_FEATURE_NOT_ALLOWED]
Cause
The Mitai proxy server fails to set the monitor on the requested extension because the prime line for that extension is a member of a multicall group that is linked to another extension. This causes the mitai monitor to be set on the group DN, instead of on the requested extension. Then, when trying to get the forwarding info for that extension, Mitai fails because it tries to get forwarding information from the group, which is not possible.
Resolution
Change the prime line of that extension to be a single line. If the multicall group has to remain, simply create it as a secondary line appearance on the extension.
--------------------
Problem
After the CCC softphone is started, when attempting to use the ACD actions menu to log in as an ACD agent, you get the following error:
Failed to login using the specified ACD agent, some of the possible reasons include are
- The specified agent ID is used somewhere else
- There is already an ACD agent logged in to this phone
- This phone is not enabled for ACD login
If you look at the CCC logs, you will find the following error:
eError: … MiniPhoneView::mnuSubACDLogin_Click: Operation failed - MessageTag:[5] ReturnCode:[SXERR_PRIVILEGE_VIOLATION]
Cause
The mitai proxy server fails to login the extension with the specified agent because the extension itself is not enabled for ACD.
Resolution
Make sure the “ACD enabled” feature on the associated extension is turned on.
For tagging purposes:
sxerr privilege violation MiTAI softphone
