设置您的网络以使用 Connect 客户联系人控制面板 (CCP)

传统 VoiP 解决方案需要您允许特定 UDP 端口范围和 IP 的入站和出站流量，例如 80 和 443。这些解决方案也适用于 TCP。与之相比，使用联系人控制面板 (CCP) 和软电话的网络要求干扰性较小。您可以通过 Web 浏览器建立持久的出站 send/receive 连接。因此，您无需打开客户端端口来侦听入站流量。

下图显示了每个端口的用途。

如果您的联络中心使用是电子邮件渠道，请参阅《Amazon SES 开发人员指南》了解相关信息。如果您的企业发送大量电子邮件，则可能需要租用专用 IP 地址。有关更多信息，请参阅 Amazon SES 专用 IP 地址。

以下部分介绍了使用 CCP 时的两种主要连接选项。

内容

选项 1（推荐）：将 Amazon EC2 和 CloudFront IP 范围要求替换为域许可名单

使用第一个选项，您可以显著缩小爆炸半径。

建议您尝试选项 1，并使用 200 个以上的呼叫来测试它。测试软件电话错误、掉线和 conference/transfer 功能。如果您的错误率大于 2%，则座席解析可能有问题。在这种情况下，请考虑使用选项 2。

要允许 Amazon EC2 端点的流量，请允许对 URL 和端口的访问，如下表中第一行所示。您应该这样做，而不是允许 ip-ranges.json 文件中列出的 IP 地址范围。您可以获得与使用 CloudFront 的域相同的好处，如下表中第二行所示。

Domain/URL 允许名单	AWS 区域	端口	方向	交通
rtc*.connect-telecom。`region`.amazonaws.com 由 ccp# (v1) 使用。请参阅此表后面的注释。	`region`替换为您的 Connect 客户实例所在的区域	443（TCP）	出站	SEND/RECEIVE
以下是 .my.connect.aws 的最小允许列表： `myInstanceName`.my.connect。aws/ccp-v2 `myInstanceName`.my.connect。aws/api `myInstanceName`.my.connect。aws/auth/授权 `myInstanceName`.my.connect。aws/awas/api .cloudfront.net 以下是 .awsapps.com 的最小允许列表：重要 .awsapps.com* 是一个即将消失的旧域。有关将域更新为 my.connect.aws 的说明，请参阅更新您的 Connect 客户域名。 `myInstanceName`.awsapps。com/connect/ccp-v2 `myInstanceName`.awsapps。com/connect/api `myInstanceName`.awsapps。com/connect/auth/authorize `myInstanceName`.awsapps。com/connect/awas/api *.cloudfront.net	替换`myInstanceName`为 Connect Customer 实例的别名	443（TCP）	出站	SEND/RECEIVE
*.telemetry.connect。`region`.amazonaws.com	`region`替换为您的 Connect Customer 实例的位置	443（TCP）	出站	SEND/RECEIVE
参与者连接。`region`.amazonaws.com	`region`替换为您的 Connect Customer 实例的位置	443（TCP）	出站	SEND/RECEIVE
*.transport.Connect。`region`.amazonaws.com 由 ccp-v2 使用。	`region`替换为您的 Connect Customer 实例的位置	443（TCP）	出站	SEND/RECEIVE
`Amazon S3 bucket name`.s3。`region`.amazonaws.com	`Amazon S3 bucket name`替换为存储附件的位置的名称。`region`替换为您的 Connect Customer 实例的位置	443（TCP）	出站	SEND/RECEIVE
*.s3.dualstack。`Region`.amazonaws.com 非 SAML 实例的新登录页面使用此终端节点。	`Region`替换为 us-east-1、us-west-2 和您的 Connect Customer 实例的位置。	443（TCP）	出站	SEND/RECEIVE
TurnNlb-*.elb。`region`.amazonaws.com 要将特定端点添加到基于区域的允许列表，请参阅 NLB 端点。	`region`替换为您的 Connect Customer 实例的位置	3478（UDP）	出站	SEND/RECEIVE
`instance-id.source-region`.sign-in.connect.aws 仅当您已加入 “连接客户全球灵活性” 时才可使用此功能。	`instance-id`替换为您的实例 ID `source-region` 和源实例的 AWS 区域。有关更多信息，请参阅将您的身份提供商 (IdP) 与 Connect Customer 全球弹性 SAML 登录端点集成。	443（HTTPS）	出站	SEND/RECEIVE
*。`source-region`.region-discovery.connect.a 只有在您加入 “连接客户全球灵活性” 时才需要这样做。	`source-region`替换为您的源实例的 AWS 区域。有关如何查找源区域的说明，请参阅如何查找 Connect 客户实例的源区域。	443（HTTPS）	出站	SEND/RECEIVE

完全限定域名 (FQDN) 不能根据每个客户进行更改或自定义，而是使用选项 2-允许 IP 地址范围。

提示

在某些代理应用程序中使用rtc*.connect-telecom.region.amazonaws.com*.transport.connect.region.amazonaws.com.rproxy.goskope.comhttps://myInstanceName.awsapps.com、和时，Web 套接字处理可能会影响功能。请确保先执行测试进行验证，然后再部署到生产环境中。

下表列出了如果您想将 CloudFront 域名而不是 IP 范围添加到允许列表中时用于静态资产的域：

Region	CloudFront 域
us-east-1	https://dd401jc05x2yk.cloudfront.net/ https://d1f0uslncy85vb.cloudfront.net/
us-west-2	https://d38fzyjx9jg8fj.cloudfront.net/ https://d366s8lxuwna4d.cloudfront.net/
ap-northeast-1	https://d3h58onr8hrozw.cloudfront.net/ https://d13ljas036gz6c.cloudfront.net/
ap-northeast-2	https://d11ouwvqpq1ads.cloudfront.net/
ap-southeast-1	https://d2g7up6vqvaq2o.cloudfront.net/ https://d12o1dl1h4w0xc.cloudfront.net/
ap-southeast-2	https://d2190hliw27bb8.cloudfront.net/ https://d3mgrlqzmisce5.cloudfront.net/
eu-central-1	https://d1n9s7btyr4f0n.cloudfront.net/ https://d3tqoc05lsydd3.cloudfront.net/
eu-west-2	https://dl32tyuy2mmv6.cloudfront.net/ https://d2p8ibh10q5exz.cloudfront.net/

注意

ca-central 未包含在表中，因为我们在域 *.my.connect.aws 后面托管了静态内容。

如果您的企业不使用 SAML，并且有防火墙限制，则可以为每个区域添加以下条目：

Region	CloudFront 域
us-east-1	https://d32i4gd7pg4909.cloudfront.net/
us-west-2	https://d18af777lco7lp.cloudfront.net/
eu-west-2	https://d16q6638mh01s7.cloudfront.net/
ap-northeast-1	https://d2c2t8mxjhq5z1.cloudfront.net/
ap-northeast-2	https://d9j3u8qaxidxi.cloudfront.net/
ap-southeast-1	https://d3qzmd7y07pz0i.cloudfront.net/
ap-southeast-2	https://dwcpoxuuza83q.cloudfront.net/
eu-central-1	https://d1whcm49570jjw.cloudfront.net/
ca-central-1	https://d2wfbsypmqjmog.cloudfront.net/
us-gov-east-1:	https://s3-us-gov-east-1.amazonaws.com/warp-drive-console-static-content-prod-osu/
us-gov-west-1:	https://s3-us-gov-west-1.amazonaws.com/warp-drive-console-static-content-prod-pdt/

NLB 端点

下表列出了连接客户实例所在区域的特定终端节点。如果你不想使用 TurnNlb-*.elb.region.amazonaws.com 通配符，你可以改为将这些终端节点添加到许可名单中。

Region	转 Domain/URL
us-west-2	TurnNlb-8d79b4466d82ad0e.elb.us-west-2.amazonaws.com TurnNlb-dbc4ebb71307fda2.elb.us-west-2.amazonaws.com TurnNlb-13c884fe3673ed9f.elb.us-west-2.amazonaws.com TurnNlb-6bb66ee54ee32710.elb.us-west-2.amazonaws.com TurnNlb-ecc67f8fbd7a29f6.elb.us-west-2.amazonaws.com
us-east-1	TurnNlb-d76454ac48d20c1e.elb.us-east-1.amazonaws.com TurnNlb-31a7fe8a79c27929.elb.us-east-1.amazonaws.com TurnNlb-7a9b8e750cec315a.elb.us-east-1.amazonaws.com TurnNlb-d40f7ff9cdd63758.elb.us-east-1.amazonaws.com TurnNlb-7675623c965365c2.elb.us-east-1.amazonaws.com
af-south-1	TurnNlb-29b8f2824c2958b8.elb.af-south-1.amazonaws.com
ap-northeast-1	TurnNlb-3c6ddabcbeb821d8.elb.ap-northeast-1.amazonaws.com
ap-northeast-2	TurnNlb-a2d59ac3f246f09a.elb.ap-northeast-2.amazonaws.com
ap-northeast-3	TurnNlb-fba2afb642c525c3.elb.ap-northeast-3.amazonaws.com
ap-southeast-1	TurnNlb-261982506d86d300.elb.ap-southeast-1.amazonaws.com
ap-southeast-2	TurnNlb-93f2de0c97c4316b.elb.ap-southeast-2.amazonaws.com
ca-central-1	TurnNlb-b019de6142240b9f.elb.ca-central-1.amazonaws.com
eu-central-1	TurnNlb-ea5316ebe2759cbc.elb.eu-central-1.amazonaws.com TurnNlb-cce94fede9926d70.elb.eu-central-1.amazonaws.com
eu-west-2	TurnNlb-1dc64a459ead57ea.elb.eu-west-2.amazonaws.com TurnNlb-0c39b6a52bcdd446.elb.eu-west-2.amazonaws.com
us-gov-west-1	TurnNlb-d7c623c23f628042.elb.us-gov-west-1.amazonaws.com

选项 2（不推荐）：允许 IP 地址范围

第二个选项依赖于使用许可清单来定义 Connect Customer 可以使用的 IP 地址和端口。您可以使用 AWS ip-ranges.json 文件中的 IP 地址创建此允许列表。

如果您使用连接客户所在的区域未出现在 AWS ip-ranges.json 文件中，则仅使用全局值。

有关此文件的更多信息，请参阅关于 Connect 客户 IP 地址范围。

IP-Ranges 条目	AWS 区域	Ports/Protocols	方向	交通
AMAZON_CONNECT	全球和您的 Connect Customer 实例所在的区域（将 GLOBAL 和任何特定区域的条目添加到您的许可列表中）	3478（UDP）	出站	SEND/RECEIVE
EC2	全球和您的 Connect Customer 实例所在的区域（仅当不存在特定区域条目时才是全球）	443（TCP）	出站	SEND/RECEIVE
CLOUDFRONT	全球*	443（TCP）	出站	SEND/RECEIVE
S3	us-east-1、us-west-2 以及您的 Connect 客户实例所在的区域（不需要 GLOBAL）	443（TCP）	出站	SEND/RECEIVE

* 从与代理所在位置相比延迟最低的边缘位置CloudFront 提供静态内容，例如图像或 javascript。的 IP 范围允许列表 CloudFront 是全球性的，要求所有 IP 范围都在 ip-ranges.json 文件中与 “服务”: “CLOUDFRONT” 关联的 IP 范围。

关于 Connect 客户 IP 地址范围

在 AWS ip-ranges.json 文件中，整个 /19 IP 地址范围归 Connect Customer 所有。所有进出/19范围的流量都来自和来自Connect客户。

/19 IP 地址范围不与其他服务共享。它专用于连接全球客户。

在 AWS ip-ranges.json 文件中，你可以看到两次列出的相同范围。例如：


            
                { "ip_prefix": "15.193.0.0/19", 
                "region": "GLOBAL", 
                "service": "AMAZON" 
                }, 
                {
                "ip_prefix": "15.193.0.0/19", 
                "region": "GLOBAL", 
                "service": "AMAZON_CONNECT" 
                },

AWS 始终将任何 IP 范围发布两次：一个用于特定服务，一个用于 “亚马逊” 服务。甚至可能为某项服务中更具体的应用场景发布第三次。

当Connect客户支持新的IP地址范围时，它们将被添加到公开的ip-ranges.json文件中。在服务使用它们之前，它们至少要保存 30 天。30 天后，通过新的 IP 地址范围的软电话流量会在后续的两周内增加。两周后，流量会通过相当于所有可用范围的新范围进行路由。

有关此文件和 IP 地址范围的更多信息 AWS，请参阅 AWS IP 地址范围。

无状态防火墙

如果这两种选项都使用无状态防火墙，则使用前一部份中所述的要求。然后，您必须将浏览器使用的临时端口范围添加到允许列表中，如下表所示。

IP-Range 条目	端口：	方向	交通
AMAZON_CONNECT	Windows 环境：49152-65535 (UDP) Linux 环境：32768 - 61000	入站	SEND/RECEIVE

IP-Range 条目

端口：

方向

交通

AMAZON_CONNECT

Windows 环境：49152-65535 (UDP)

Linux 环境：32768 - 61000

入站

SEND/RECEIVE

允许上传休假余额和津贴 Connect Customer 调度

要允许在 Connect Customer 计划中上传休假余额和津贴，请将以下上传终端节点添加到您的代理例外列表中：

https://bm-prod-region-cell-1-uploadservice-staging.s3。region.amazonaws.com
https://bm-prod-region-cell-2-uploadservice-staging.s3。region.amazonaws.com

有关这些端点支持的活动的更多信息，请参阅以下主题：

允许软电话使用 DNS 解析

如果您已经将 Connect 客户 IP 范围添加到许可名单，并且对 DNS 名称解析没有任何限制，则无需添加 TurnNlb-*.elb。region.amazonaws.com 加入您的许可名单。

要检查 DNS 名称解析是否有限制，请使用 nslookup 命令。例如：

nslookup TurnNlb-d76454ac48d20c1e.elb.us-east-1.amazonaws.com

如果您无法解析 DNS，则必须添加上面列出的 TurnNLB 终端节点或 TurnNlb-*.elb。region.amazonaws.com 加入您的许可名单。

如果您不允许此域，您的座席在接听呼叫时，会在联系人控制面板 (CCP) 中收到以下错误：

无法建立软电话连接。重试或通过以下方式联系您的管理员:浏览器无法通过 turn 建立媒体频道:TurnNlb-xxxxxxxxxxxxx.elb.region.amazonaws.com: 3478？transport=udp

端口和协议注意事项

在为 Connect 客户实施网络配置更改时，请考虑以下几点：

您需要允许创建 Connect Customer 实例所在区域的所有地址和范围的流量。
如果您在 CCP 和 Connect 客户之间使用代理或防火墙，请延长 SSL 证书缓存超时时间，以覆盖代理的整个轮班时间，这样做是为了避免在预定工作时间内续订证书时出现连接问题。例如，如果您的座席工作为 8 小时轮班制（包括休息时间），则应将间隔延长到 8 小时（外加休息和午餐时间）。
打开端口时，Amazon EC2 和 Connect 客户仅需要与您的实例位于同一区域的终端节点的端口。但是 CloudFront，亚马逊从边缘站点提供静态内容，该位置的延迟与您的代理所在位置相比最低。的 IP 范围许可名单 CloudFront 是全球性的，要求所有 IP 范围与 ip-ranges.json 中的 “服务”: “CLOUDFRONT” 关联的 IP 范围。
更新ip-ranges.json后，关联 AWS 服务将在30天后开始使用更新后的IP范围。为避免服务开始将流量路由到新 IP 范围时出现间歇性连接问题，请确保在将新 IP 范围添加到 ip-ranges.json 的 30 天内，将其添加到允许列表中。
如果您将自定义 CCP 与 Connect Customer Streams API 结合使用，则可以创建无媒体 CCP，它不需要为与 Connect Customer 的通信打开端口，但仍需要打开端口才能与 Amazon EC2 和. CloudFront

区域选择注意事项

Connect 客户区域的选择取决于数据治理要求、用例、每个区域的可用服务以及与您的代理、联系人和外部传输终端节点地理位置相关的延迟。

代理 location/network —CCP 连接穿越公共 WAN，因此工作站必须尽可能降低延迟和跳数，特别是在托管您的资源和 Connect Customer 实例的 AWS 区域。例如，对于需要通过多次跳转才能到达边缘路由器的星型拓扑网络，这会增加延迟并降低体验质量。

在设置实例和座席时，请确保在地理位置上最接近座席的区域创建实例。如果您需要在特定区域设置实例以遵守公司政策或其他法规，请选择能够使代理计算机和 Connect Customer 实例之间的网络跳数最少的配置。
呼叫者的位置 —由于呼叫是锚定到您的 Connect 客户区域终端节点，因此会受到 PSTN 延迟的影响。理想情况下，您的呼叫者和转接端点的地理位置尽可能靠近托管 Connect Customer 实例的 AWS 区域，以实现最低延迟。

为了获得最佳性能，并限制客户致电您的联络中心时的延迟，请在地理位置最接近客户致电的地区创建 Connect Customer 实例。您可以考虑创建多个 Connect Customer 实例，并向客户提供最接近其致电地址的联系信息。
外部转账 —在通话期间，来自Connect客户的外部转账将保持锚定到您的Connect客户区域终端节点。 Per-minute使用量会继续累积，直到转接呼叫的接收方断开通话为止。在座席下线或转接完成后，呼叫不会被记录。在呼叫终止后，会生成转接呼叫的联系记录数据和相关的呼叫记录。尽可能不要将可能转回Connect客户的呼叫（称为循环转接），以避免加剧PSTN延迟。

代理远程使用 “连接客户”

重要

如果您的代理使用 SAML 2.0 登录到 Connect Customer，则需要将终端节点和配额中AWS Sign-In 列出的 AWS SSO 终端节点列入许可名单。

远程代理，即那些从非连接到贵组织主网络的位置使用 Connect Customer 的代理，如果连接不稳定、数据包丢失或延迟过长，可能会遇到与本地网络相关的问题。如果需要 VPN 才能访问资源，这个问题会更为严重。理想情况下，代理位于托管您的 AWS 资源和 Connect Customer 实例的 AWS 区域附近，并且与公共 WAN 有稳定的连接。

重新路由音频

将音频重新路由到现有设备时，请考虑设备与您的 Connect 客户区域相关的位置。由此可以将可能存在的延迟考虑在内。如果要重新路由音频，只要对该座席进行呼叫，就会向所配置的设备发出出站呼叫。座席一旦应答该设备，该座席就会与呼叫方连接。如果座席没有应答其设备，他们就会进入错过联系人状态，直至他们或主管将其状态改回可用。

使用 Direct Connect

联系人控制面板 (CCP) 网络连接问题通常源于您 AWS 使用私有网络 WAN/LAN、互联网服务提供商或两者兼而有之的途径。虽然 Direct Connect 不能解决特定于边缘路由器私有 LAN/WAN 遍历的问题，但它可以帮助解决边缘路由器与资源之间的延迟和 AWS 连接问题。 Direct Connect 提供持久、一致的连接，而不是依靠您的 ISP 将请求动态路由到 AWS 资源。您还可以使用它来配置边缘路由器，使其通过专用光纤重定向 AWS 流量，而不是穿越公共 WAN。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

各地区的合并指标

Connect Customer 中对应用程序、Web 和视频通话的代理工作站要求