如何对 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 Endpoint Test Utility 检查出现问题的代理的连接是否稳定。
• 检查 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) 将以下 URL 添加到您的允许列表中：

• 对于 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 URL 添加到您的允许列表中。

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 Log Parser（CCP 日志解析器）。

要与 API 端点通信，请通过端口 443 (TCP) 将以下 URL 添加到您的允许列表中：

• *.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) 问题