本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在使用 Amazon Connect Streams API 时升级联系人控制面板 (CCP)
<a name="upgrade-ccp-streams-api"></a>

**注意**  
在 CCP 的早期版本和最新版本之间，Amazon Connect Streams API 保持不变。建议在升级版本时验证使用 Amazon Connect Streams API 构建的自定义实现，以确保行为的一致性。

按照以下步骤升级到最新的 CCP。

1. 建议使用最新的 [Amazon Connect Streams API](https://github.com/amazon-connect/amazon-connect-streams)。

1. 将与 `initCCP()` 关联的 URL 从 **/ccp\$1** 更新为 **/ccp-v2**。有关信息`initCCP()`，请参阅 Amazon C [onnect Streams API 文档中的 connect.core.init](https://github.com/aws/amazon-connect-streams#initialization) ccp ()。 GitHub

1. 将您的域 URL 添加到已批准的源列表中：

   1. 使用您的 AWS 帐户登录[AWS 管理控制台](https://console.aws.amazon.com/console) (https://console.aws.amazon.com/console)。

   1. 导航到 Amazon Connect 控制台。

   1. 检查您的 Amazon Connect 实例是否处于正确区域。选择您的实例。  
![\[“Amazon Connect 虚拟联络中心实例”页面，实例的别名。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/tutorial1-lex-custom-bot18.png)

   1. 选择**应用程序集成**，然后选择**添加来源**。  
![\[左侧导航窗格，“应用程序集成”选项，添加来源。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/upgradeccp-application-integration.png)

   1. 输入您的域 URL。为要明确添加的特定实例嵌入 CCP 的所有域。有关更多信息，请参阅[这篇文章](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#allowlisting) GitHub。

      如果您使用 Salesforce，则需要将 Salesforce 域添加到允许列表中，以防止 CTI Adapter CCP 功能出现任何问题。有关详细说明，请参阅[适用于 Salesforce Lightning 的 Amazon Connect CTI Adapter 安装指南](https://amazon-connect.github.io/amazon-connect-salesforce-cti/docs/lightning/notices/)或[适用于 Salesforce Classic 的 Amazon Connect CTI Adapter 安装指南](https://amazon-connect.github.io/amazon-connect-salesforce-cti/docs/classic/notices/)。

## 验证网络设置
<a name="upgrade-verify-network-settings"></a>

我们强烈建议您将网络设置为使用 [选项 1（推荐）：将 Amazon EC2 和 CloudFront IP 范围要求替换为域名许可名单](ccp-networking.md#option1)。

使用此选项帮助 Amazon Connect 支持人员快速解决您遇到的任何问题。具体来说，使用 **\$1.telemetry.connect.\$1region\$1.amazonaws.com** 将更多指标传递给我们的支持团队，帮助进行故障排除。

## 将您的 SAML URL 更新为 ccp-v2
<a name="update-saml-url"></a>

如果您使用 SAML 2.0 作为身份管理系统，请务必将中继状态 URL 中的目标更新为 **ccp-v2**。

将 `destination=/connect/ccp` 更改为 `destination=/connect/ccp-v2`。

有关更多信息，请参阅 [在中继状态 URL 中使用目的地](configure-saml.md#destination-relay)。