本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在使用 Amazon Connect Streams API 時升級您的聯絡人控制台 (CCP)。
<a name="upgrade-ccp-streams-api"></a>

**注意**  
Amazon Connect Streams API 在早期版本和最新版本的 CCP 之間保持不變。我們建議您在升級版本時驗證使用 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()` 的相關資訊，請參閱 GitHub 上 Amazon Connect Streams API 文件中的 [connect.core.initCCP()](https://github.com/aws/amazon-connect-streams#initialization)。

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_tw/connect/latest/adminguide/images/tutorial1-lex-custom-bot18.png)

   1. 選擇**應用程式整合**，然後選擇**新增來源**。  
![\[左側導覽窗格、應用程式整合選項、新增來源。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/upgradeccp-application-integration.png)

   1. 輸入您的網域 URL。針對要明確新增的特定執行個體內嵌 CCP 的所有網域。如需詳細資訊，請參閱 GitHub 上的[這篇文章](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#allowlisting)。

      如果您使用 Salesforce，則需要將 Salesforce 域新增至允許清單，以避免 CTI 轉接器 CCP 功能發生任何問題。如需詳細指示，請參閱 [Amazon Connect CTI Adapter for Salesforce Lightning installation guide](https://amazon-connect.github.io/amazon-connect-salesforce-cti/docs/lightning/notices/) 或 [Amazon Connect CTI Adapter for Salesforce Classic installation guide](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)