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

上次更新时间:2021 年 10 月 20 日

我收到来自 Amazon Connect 联系控制面板(CCP)的软电话错误,告诉我无法连接到某个终端节点。如何解决此错误?

简短描述

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

  • 信令终端节点错误
  • 媒介终端节点错误
  • API 终端节点错误

这些错误在 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 实例位置。有关更多信息,请参阅设置网络

解决方法

  1. 确认没有任何因素阻止流量传输到错误消息中所列的终端节点域。有关更多信息,请参阅将 Amazon EC2 和 CloudFront IP 范围要求替换为域允许列表
  2. 确认网络防火墙中已经打开了错误消息中所列终端节点域需要的端口。有关更多信息,请参阅将 Amazon EC2 和 CloudFront IP 范围要求替换为域允许列表
  3. 如果您要允许某些 IP 地址范围,请确认 Amazon Connect 使用的所有 IP 地址都在所需的允许列表中。有关更多信息,请参阅允许 IP 地址范围
  4. 确认您的网络连接足够稳定,以允许 Amazon Connect CCP 保持与所需终端节点之间的连接。

这篇文章对您有帮助吗?


您是否需要账单或技术支持?