本產品的文件集力求使用無偏見用語。針對本文件集的目的,無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言,或引用第三方產品的語言,因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。
思科已使用電腦和人工技術翻譯本文件,讓全世界的使用者能夠以自己的語言理解支援內容。請注意,即使是最佳機器翻譯,也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責,並建議一律查看原始英文文件(提供連結)。
當思科互動式呼叫分配(ICD)代理嘗試登入到Cisco Agent Desktop時,在思科電腦電話整合(CTI)環境中登入失敗,並出現錯誤消息。本檔案將討論各種錯誤訊息、可能的原因和建議的動作。
繼續操作之前,請驗證以下專案:
代理的使用者ID和密碼區分大小寫,因此請確保正確輸入這些專案。
User > Global Directory下的User Information頁面中的Enable CTI Application Use覈取方塊將被選中。
CTI管理器服務在CTI伺服器上運行。
CRS引擎在適用性實用程式中啟用。
思科客戶響應解決方案(CRS)伺服器必須安裝並配置用於ICD以及Cisco CallManager。
本文檔中的資訊基於CRS 3.0.2版和Cisco Unified Contact Center Express 7.x/8.x。
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路正在作用,請確保您已瞭解任何指令可能造成的影響。
無法登入到Cisco Agent Desktop的代理收到以下錯誤消息:
Failed to login into CTI Manager Server! Please talk to your administrator.
是否會影響所有使用者或單個使用者?如果它影響所有使用者,請繼續編輯DSBrowser.exe部分。
如果此問題影響單個使用者,請驗證該使用者是否可以通過主機名ping CTI Manager伺服器。如果失敗,則問題可能是由於DNS錯誤。編輯Hosts檔案以新增CTI Manager的主機名和IP地址,從而解決該問題。
此問題的解決方案將在這些部分中詳細介紹。
完成以下步驟以啟用調試跟蹤:
在檔案c:\Program Files\Cisco\Desktop\config\fastcalllocal.ini中將跟蹤級別設定為等於204。
將跟蹤大小設定為3000000(預設值為300000)。
[Program Log] Path=..\log\agent.log Size=300000 [Debug Log] Path=..\log\agent.dbg Size=300000000 Level=204
這些更改在Agent Desktop重新登入時生效。
可以在c:\Program Files\Cisco\Desktop\log資料夾中找到跟蹤檔案。如果超過最大檔案大小,舊日誌檔案將複製到c:\Program Files\Cisco\Desktop\log\old\資料夾。
開啟代理日誌檔案並滾動到頁面底部。
您會看到CTI Manager的IP地址,而不是主機名。如果看到CTI Manager的主機名,請完成該過程的其餘部分以將其更改為IP地址。以下是示例日誌檔案:
074906 02/24/2003 MAJOR FCCTI_1000 splkJtapiServerstartServerSession jtapi provider login return false 074906 02/24/2003 MAJOR FCCTI_1000 Error Return (21error in invoking Java Method) startServerSession 074906 02/24/2003 MAJOR PhoneDev PD2377 CTIServerLogin Failed to establish connection to CTI Manager Host A (CS-PUB) 074906 02/24/2003 MAJOR FCCTI_1000 splkJtapiServerstartServerSession jtapi provider login return false 074906 02/24/2003 MAJOR FCCTI_1000 Error Return (21error in invoking Java Method) startServerSession 074906 02/24/2003 MAJOR PhoneDev PD2384 CTIServerLogin Failed to establish connection to CTI Manager Host B (CS-SUB) 074906 02/24/2003 INFO PhoneDev PD1787 PhoneDevShutDown CTI Shutdown 075206 02/24/2003 INFO FastCall FC0376 Releasing license... 075206 02/24/2003 INFO FastCall FC0405 FastCall Shutting Down 075206 02/24/2003 INFO PhoneDev PD1787 PhoneDevShutDown CTI Shutdown
完成以下步驟,即可在CTI管理器伺服器上編輯DSBrowser.exe:
選擇開始>運行> cmd。
鍵入命令c:\program files\cisco\desktop_config\util\dsbrowser /editable。
輸入目錄伺服器的密碼,然後按一下OK。
選擇Server Data > (server name)-LCC > App Data > CTI Manager List。
根據您擁有的CTI管理器數量,對所有裝置執行相同的操作。在右側,按兩下每個地址,配置IP地址(如果設定為主機名),然後按一下確定。
如果完成此更改後繼續收到相同的錯誤,請捕獲代理調試日誌,並將其提交給思科技術支援。
座席無法登入到Cisco Agent Desktop並收到以下錯誤消息:
Login attempt failed due to Peripheral Offline
當Resource Manager-Contact Manager(RMCM)子系統由於RM JTAPI使用者的無效登入/密碼而無法啟動時,可能會發生此錯誤。換句話說,這可能是由於RM JTAPI使用者和JTAPI使用者之間的密碼不匹配。
為了解決此問題,請同步JTAPI使用者和RM JTAPI使用者密碼並重新啟動CTI Manager服務。
注意:確保RM JTAPI使用者的密碼設定為永不過期。如果密碼過期,可能會導緻密碼不匹配,從而導致此錯誤。
當代理登入到Cisco Agent Desktop時,代理會收到Error Reading File\\server\DESKTOP_CFG\config\ag_default\DataFields.ini錯誤消息。
可能的原因包括:
Cisco Agent Desktop(CAD)使用者無法讀取/寫入DESKTOP_CFG配置檔案。
與思科客戶響應應用(CRA)伺服器的IP連線丟失。
完成以下步驟即可解決此問題:
確保為DESKTOP_CFG配置檔案正確建立了共用位置和讀/寫檔案訪問。如果共用已正確開啟,請從客戶端PC驗證您是否可以在Customer Response Solutions(CRS)伺服器上的Desktop_cfg\Desktop\License資料夾中建立檔案(具有讀/寫訪問許可權)。
有關詳細資訊,請參閱在Cisco Agent Desktop for IPCC Express中自動執行DESKTOP_CFG共用驅動器對映。
確保已建立與CRA伺服器的IP連線。
在嘗試登入到Cisco Agent Desktop的過程中,代理收到此錯誤消息,並且RMCM子系統停滯在初始化中:
The ID you entered was not found
或
Specified ID is invalid
此問題也記錄在Cisco錯誤ID CSCsv98008中。
完成以下步驟即可解決此問題:
確保正確鍵入使用者ID。使用者ID區分大小寫。
確認您使用了正確的Cisco CallManager密碼。
確保RM JTAPI使用者ID已配置為支援標準CTI的使用者組的成員。
如果問題仍然存在,請嘗試停止並重新啟動Cisco Desktop Sync Server服務。
註:如果座席收到錯誤資訊「電話停止服務時不能更改到就緒狀態」。其他座席狀態在登入後可用,或者如果座席多次註銷,請重新啟動CTI管理器服務以解決問題。
註:如果代理無法登入,並且MIVR日誌將db_cra標籤為可疑,則問題是由資料庫損壞造成的。在這種情況下,您需要重新安裝CRS以替換不啟動的損壞的資料庫。
Cisco Agent Desktop登入成功並進入ready,但隨後出現Resources off the agent ext is out of service錯誤消息。當您按一下「確定」時,它將變為「未就緒」,然後轉到電話。您聽到撥號音並掛機,Cisco Agent Desktop因此可以正常工作。
當您嘗試將IPCC Express與Cisco CallManager Express連結時,會出現此問題。
出現此問題的原因是傳入的線上狀態請求(預設情況下被阻止)。
在Cisco CallManager Express上輸入以下命令以解決此問題。
這些命令允許路由器接受來自內部觀察器和SIP中繼的傳入線上狀態請求(SUBSCRIBE消息)。它不影響傳出線上狀態請求。
Router(config)# sip-ua
Router(config-sip-ua)# presence enable
當您嘗試從電話登入座席時,收到以下錯誤消息:
Agent has no workgroup specified.
重新啟動CRS節點管理器以解決問題。
將Cisco Unified Communications Manager從6.x升級到7.x後,無法登入到Cisco Agent Desktop。收到以下錯誤消息:
You cannot login because the phone is JAL-enabled. JAL-enabled phones are not compatible with CAD.
CCX 7.0 SR4發行說明將此描述為CUCM 7.1.3在兩個案例中的預期行為。
"如果在使用Unified CCM 7.1(3)的座席電話上啟用了JAL或DTAL,則阻止座席登入;如果在使用Unified CM 7.1(3)或更高版本的座席電話上啟用了JAL(跨線路加入)或DTAL(跨線路直接傳輸),則座席無法登入到CAD/CAD-BE/IPPA服務。"
根本原因是UCCX 7當前不支援JAL電話。您需要關閉Cisco Unified Communications Manager中的JAL引數,以使代理重新工作。請完成以下步驟:
從Cisco Unified Communications Manager Administration頁中選擇Device > Phone,即可導航到Phone Configuration視窗。
對於Join Across Lines選項(也位於視窗的Device Information部分),選擇Off。
嘗試登入到Cisco Agent Desktop時,收到以下錯誤消息:
密碼無效
此錯誤的原因可能是SQL代理服務已關閉。要重新啟動服務,請完成以下步驟:
轉至開始>運行,然後鍵入Services.msc。
按一下「OK」(確定)。
在服務視窗中,找到SQL Server代理服務。
確保SQL Server代理服務的「狀態」列的值為Running。如果未運行,請啟動它。
Cisco Agent Desktop登入失敗,並顯示You cannot log in because your phone is ipv6 enabled或Unsupported IP Addressing Mode錯誤消息。
從Cisco Unified Communications Manager Administration頁面,轉到Device > Device Settings > Common Device Config,按一下Find,然後按一下電話所屬的配置檔案。然後,將IP編址模式從IPv4和IPv6更改為僅IPv4。
有關詳細資訊,請參閱CSCtz07348。
嘗試登入CAD的代理會收到以下錯誤:由於Cisco Agent Desktop不支援IPV6,CAD無法登入使用者。
注意:當CAD在全新安裝或W1升級後登入時會發生這種情況。
此問題的解決方法是重新啟動UCCX引擎。此錯誤記錄在Cisco錯誤ID CSCtk00173中。
此解決方法相當於將電話重新關聯到RmCm使用者。為此,您需要確保以下各項:
訪問CUCM終端使用者配置頁面。
確保在受控裝置下,IP電話的MAC地址與最終用戶關聯。
確保將終端使用者新增到啟用標準CTI的使用者組,並將電話新增到rmcm使用者。
完成以下步驟即可解決問題:
選擇CUCM Administration > Device > Phone,然後按一下出現問題的IP電話。
選擇Device > Device Settings > Common Device Configuration。
在通用裝置配置下,將IP Addressing Mode更改為IPv4。
在CUCM電話配置頁面中,重置IP電話。
重置TFTP和CTIManager服務。
在CUCM 8.6和UCCX 8.5中,代理註銷Extension Mobility並在以後重新登入,當代理嘗試登入到Cisco Agent Desktop時,登入失敗,出現以下錯誤之一:
An extension on the agent phone is shared with one or more other devices. This configuration is not supported.
或
Login failed due to a configuration error with your phone and JTAPI or Unified CM. Contact your administrator.
在使用Extension Mobility的CAD代理上會出現此問題,其中「使用者裝置配置檔案」(User Device Profile)具有啟用「自動呼叫記錄」(Automatic Call Recording)選項的電話號碼。
作為解決方法,請在登入到Extension Mobility後重置電話裝置。如需可能的修正程式,請參閱Cisco錯誤ID CSCty63105。