如何對 Amazon Connect CCP 軟體電話錯誤進行疑難排解？

簡短描述

當您的 Amazon Connect CCP 無法與以下其中一個必要端點通訊時，就會發生軟體電話錯誤：

• 訊號端點
• 媒體端點
• API 端點

解決方法

若要解決 Amazon CCP 中的軟體電話錯誤，請執行下列操作：

• 檢查錯誤訊息中提及之端點網域的流量是否遭到封鎖。如果流量遭到封鎖，則將 Amazon Elastic Compute Cloud (Amazon EC2) 和 Amazon CloudFront IP 範圍要求替換為網域允許清單。
• 檢查錯誤訊息中端點網域所需的連接埠是否在網路防火牆中開啟。
• 如果您允許 IP 位址範圍，請檢查 Amazon Connect 使用的所有 IP 位址是否都在必要的允許清單中。
• 檢查您的網路連線是否允許 Amazon Connect CCP 與必要端點保持連線。
• 使用 Amazon Connect 端點測試公用程式，檢查出現問題的代理程式是否具有穩定的連線。
• 檢查 Amazon Connect 與訊號端點、媒體端點和 API 端點之間的通訊。

訊號端點

以下錯誤訊息是您可能收到的訊號端點錯誤的範例：

• "softphone ERROR {your contact ID} SESSION Failed connecting to signaling server Timeout"
• "softphone ERROR Softphone error occurred : signalling_connection_failure URL {signaling endpoint URL} cannot be reached"

若要與訊號端點通訊，請透過連接埠 443 (TCP) 將以下網址新增至您的允許清單：

• 對於 CCP v1：rtc*.connect-telecom.REGION.amazonaws.com
• 對於 CCP v2：*.transport.connect.REGION.amazonaws.com

如需詳細資訊，請參閱升級到最新的 Amazon Connect 聯絡人控制面板 (CCP)。

媒體端點

以下錯誤訊息是您可能會收到的媒體端點錯誤的範例：

• "softphone WARN {your contact ID} SESSION ICE collection timed out"
• "softphone ERROR {your contact ID} SESSION No ICE candidate"
• "softphone INFO {your contact ID} SESSION ConnectSignalingAndIceCollectionState => FailedState"
• "softphone ERROR Softphone error occurred : ice_collection_timeout Ice collection timedout"

若要與媒體端點通訊，請透過連接埠 3478 (UDP)，將 TurnNlb-*.elb.REGION.amazonaws.com 網址新增至您的允許名單。

API 端點

以下錯誤訊息是您可能會收到的 API 端點錯誤的範例：

• "ccp ERROR 'acceptContact' API request failed: [object Object]"
• "ccp TRACE AWSClient: < Operation 'acceptContact' failed: {"message":"Network Failure","code":"NetworkingError","time":"....""

**注意：**若要將原始 CCP 日誌轉換為易於閱讀的格式，請使用 CCP 日誌剖析器。如需詳細資訊，請參閱 GitHub 網站上的 CCP 日誌剖析器。

若要與 API 端點通訊，請透過連接埠 443 (TCP) 將以下網址新增至您的允許清單：

• *.telemetry.connect.REGION.amazonaws.com
• INSTANCE_NAME.my.connect.aws/ccp-v2
• INSTANCE_NAME.my.connect.aws/api
• *.static.connect.aws
• INSTANCE_NAME.awsapps.com/connect/ccp-v2
• INSTANCE_NAME.awsapps.com/connect/api
• *.cloudfront.net

**注意：**將 INSTANCE_NAME 替換為您的執行個體名稱。將 REGION 替換為您的 Amazon Connect 執行個體所在的 AWS 區域。如需詳細資訊，請參閱設定您的網路，以使用 Amazon Connect 聯絡人控制台 (CCP)。

相關資訊

對聯絡人控制台 (CCP) 問題進行疑難排解