我收到了来自我的 Amazon Connect 联系人控制面板(CCP)的软电话错误,表示其无法连接到端点。
简短描述
有三种类型的 Amazon Connect CCP 端点错误。所有这些错误会以软电话错误出现在 Amazon Connect CCP 日志中,类似于以下示例:
信令端点错误
这些错误包括以下示例:
- “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.”
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 日志解析器。
解决方法
查看 Amazon Connect 与端点之间的通信情况。
当您的 Amazon Connect CCP 无法与以下一个或多个所需的端点通信时,就会出现软电话错误:
**注意:**将 INSTANCE_NAME 替换为您的实例名称。将 REGION 替换为您的 Amazon Connect 实例的位置。有关详细信息,请参阅设置您的网络。
信令端点
要与信令端点通信,请通过**端口 443(TCP)**将以下 URL 添加到您的允许列表中:
- **对于 CCP v1:**rtc*.connect-telecom.REGION.amazonaws.com
- 对于 CCP v2:*.transport.connect.REGION.amazonaws.com
有关详细信息,请参阅升级到最新的 CCP。
媒体端点
要与媒体端点通信,请通过**端口 3478(UDP)**将以下 URL 添加到您的允许列表中:
- TurnNlb-*.elb.REGION.amazonaws.com
API 端点
要与 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
其他注意事项
- 确认没有什么阻止流量流向错误消息中列出的端点域。有关详细信息,请参阅将 Amazon EC2 和 CloudFront IP 范围要求替换为域允许列表。
- 确认在您的网络防火墙上已经打开了错误消息中列出的端点域所需的端口。有关详细信息,请参阅将 Amazon EC2 和 CloudFront IP 范围要求替换为域允许列表。
- 如果您允许 IP 地址范围,请确认 Amazon Connect 使用的所有 IP 地址都在所需的允许列表中。有关详细信息,请参阅允许 IP 地址范围。
- 确认您的网络连接足够稳定,以允许 Amazon Connect CCP 与所需端点保持连接。
相关信息
对联系人控制面板(CCP)问题进行故障排除
设置您的网络