如何排查 Amazon Connect CCP 软电话错误？

2 分钟阅读

我收到来自 Amazon Connect 联系控制面板（CCP）的软电话错误，告诉我无法连接到某个终端节点。

简短描述

有三种类型的 Amazon Connect CCP 终端节点错误：

这些错误在 Amazon Connect CCP 日志中显示为软电话错误，与下面这些示例类似。

**注意：**您可以使用 CCP 日志解析器将原始 CCP 日志转换为更易读的格式。有关更多信息，请参阅 GitHub 上的 CCP 日志解析器。

示例 Amazon Connect CCP 软电话错误


信令终端节点错误	媒介终端节点错误	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.”	“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.”	“ccp ERROR 'acceptContact' API request failed: [object Object]” “ccp TRACE AWSClient: < Operation 'acceptContact' failed: {"message":"Network Failure","code":"NetworkingError","time":"...."”

如果您的 Amazon Connect CCP 无法与以下一个或多个必要的终端节点通信，则会发生软电话错误。

所需的 Amazon Connect CCP 终端节点


终端节点类型	域/URL 允许列表	端口
信令	对于 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 保持与所需终端节点之间的连接。