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

2 分的閱讀內容

我收到 Amazon Connect 聯絡控制面板 (CCP) 的軟體電話錯誤，表示其無法連線至端點。

簡短說明

Amazon Connect CCP 端點錯誤共有三種類型：

這些錯誤會在 Amazon Connect CCP 日誌中顯示為軟體電話錯誤，與下列範例類似。

**注意：**您可以使用 CCP 日誌剖析器將原始 CCP 日誌轉換為更容易讀取的格式。如需詳細資訊，請參閱 GitHub 上的 CCP 日誌剖析器。

範例 Amazon Connect CCP 軟體電話錯誤


訊號端點錯誤	媒體端點錯誤	API 端點錯誤
「軟體電話 ERROR {your contact ID} SESSION 失敗連線至訊號伺服器逾時」「軟體電話 ERROR 發生軟體電話錯誤：signalling_connection_failure 無法連線至網址 {signaling endpoint URL}。」	「軟體電話 WARN {your contact ID} SESSION ICE 集合逾時」「軟體電話 ERROR {your contact ID} SESSION 沒有候選 ICE」「軟體電話 INFO {your contact ID} SESSION ConnectSignalingAndIceCollectionState => FailedState」「軟體電話 ERROR 發生軟體電話錯誤：ice_collection_timeout ICE 集合逾時。」	「ccp ERROR 'acceptContact' API 請求失敗：[object Object]」「ccp TRACE AWSClient: < 操作 'acceptContact' 失敗：{"message":"Network Failure","code":"NetworkingError","time":"...."」

當您的 Amazon Connect CCP 無法與下列一或多個必要端點通訊時，即會發生軟體電話錯誤。

必要的 Amazon Connect CCP 端點


端點類型	網域/網址允許清單	連接埠
訊號	對於 CCP v1： rtc.connect-telecom.{region}.amazonaws.com 對於 CCP v2：* *.transport.connect.{region}.amazonaws.com 如需詳細資訊，請參閱升級至最新的 CCP。	443(TCP)
媒體	TurnNlb-*.elb.{region}.amazonaws.com	3478(UDP)
API	.telemetry.connect.{region}.amazonaws.com 新增：其他要新增至允許清單的網域* {myInstanceName}.my.connect.aws/ccp-v2 {myInstanceName}.my.connect.aws/api .static.connect.aws 先前的必要項目：{myInstanceName}.awsapps.com/connect/ccp-v2 {myInstanceName}.awsapps.com/connect/api .cloudfront.net	443(TCP)

**重要事項：**請確認將每個網域中的 {region} 取代為 Amazon Connect 執行個體的位置。如需詳細資訊，請參閱設定您的網路。

確認錯誤訊息中列出的端點網域流量並未被封鎖。如需詳細資訊，請參閱將 Amazon EC2 和 CloudFront IP 範圍需求取代為網域允許清單。
確認在您的網路防火牆上，錯誤訊息中列出的端點網域已開啟必要連接埠。如需詳細資訊，請參閱將 Amazon EC2 和 CloudFront IP 範圍需求取代為網域允許清單。
如果您允許 IP 地址範圍，請確認 Amazon Connect 使用的所有 IP 地址都在必要允許清單上。如需詳細資訊，請參閱允許 IP 地址範圍。
確認您的網路連線具有足夠的穩定性，以允許 Amazon Connect CCP 維持與必要端點的連線。