本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 設定 Amazon Connect 的全球恢復能力
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
**重要**
Amazon Connect Global Resiliency (ACGR) 是 Amazon Connect 中唯一 AWS支援多區域彈性的解決方案。 AWS 不支援第三方或自訂建置的替代方案，以實現全域彈性。部署不支援的解決方案可能會導致次要執行個體的服務限制遭拒或降低，如果停機時間歸因於不支援的部署，則可能會影響 SLA 涵蓋範圍。
Amazon Connect 全球恢復能力可讓您以最高的可靠性、效能和效率在全球任何地方提供客戶服務。憑藉其分散式電話功能，您的聯絡中心可以滿足國際法規要求。
Amazon Connect 全球恢復能力提供一組 API，您可以用來：
+ 在另一個 中佈建連結的 Amazon Connect 執行個體 AWS 區域。
+ 佈建和管理全球電話號碼，並且可在兩個區域存取。
+ 以 10% 的增量在 Amazon Connect 執行個體和區域中分配電話流量和客服人員，或一次性全部轉移。如此一來，您就可以在不同地區慢慢轉移輸入語音聯絡和客服人員，或同時全部轉移。
例如，您可以將撥入語音聯絡和客服人員分佈 100% 在美國東部 (維吉尼亞北部) 和 0% 在美國西部 (奧勒岡)，或是每個區域分佈 50%。
+ 跨區域存取預留容量。
**Topics**
+ [全球恢復能力的要求](connect-global-resiliency-requirements.md)
+ [開始使用](get-started-connect-global-resiliency.md)
+ [管理流量分佈群組](manage-traffic-distribution-groups.md)
+ [管理跨區域的電話號碼](manage-phone-numbers-across-regions.md)
+ [管理跨區域的聊天](manage-chat-across-regions.md)
+ [跨 ACGR 區域的指標、報告和搜尋](metrics-reports-and-search-across-acgr-regions.md)
# Amazon Connect 全球恢復能力的要求
如果您確定 Amazon Connect 全球恢復能力是適合您的部署，請在加入前滿足下列條件：
+ 將您想設為多區域的所有電話號碼[連接](about-porting.md)到 Amazon Connect。
+ AWS 需要企業支援或 AWS 統一操作才能加入 Amazon Connect Global Resiliency。如需 AWS 支援計劃的詳細資訊，請參閱[AWS 支援計劃。 ](https://aws.amazon.com/premiumsupport/plans/)
+ 您必須在可使用 Amazon Connect 全球恢復能力的區域中，擁有已啟用生產 [SAML 2.0](connect-identity-management.md) 的 Amazon Connect 執行個體。若要確認，請參閱 [全球備援可用性 (按區域)](regions.md#gr_region)。
+ 建議您在加入生產流量前，先在測試環境中加入和測試 Amazon Connect 全球恢復能力服務。
+ 請求複本執行個體中的所有服務配額符合來源執行個體中的服務配額：在 AWS 管理主控台 > 支援中[建立服務配額增加案例](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)。
+ 確保跨 AWS 區域的 Lambda 函數具有相同的名稱。
+ 更新您的流程，以使用 `$.AwsRegion` 或 `$['AwsRegion']` 參數取代任何硬編碼區域。
**注意**
在 [AWS Lambda 函數](invoke-lambda-function-block.md) 區塊中，無法在 flowArn 中使用 `$.AwsRegion`。
若要使用 `$.AwsRegion`，您需要使用 [設定聯絡屬性](set-contact-attributes.md) 區塊來設定流程，例如：
`flowIdKey` : `arn:aws:connect:$.AwsRegion:123456789012:instance/12345678-1234-1234-1234-123456789012/contact-flow/12345678-1234-1234-1234-123456789012`
然後，在 [AWS Lambda 函數](invoke-lambda-function-block.md) 區塊中使用該屬性金鑰作為 `${flowIdKey}`。
`$.AwsRegion` 僅支援 Lambda ARN 和 Lex ARN。
+ 針對 Amazon Lex 機器人，您可以執行下列其一操作：
+ 使用 Amazon Lex Global Resiliency 跨 AWS 區域複寫機器人並保留機器人 ID。
+ 根據執行流程 AWS 的區域，將流程變更為分支。在流程執行時期，這些參數會取代為執行流程的區域，如下範例所示。
![\[「檢查聯絡屬性」區塊的屬性頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/acgr-requirements.png)
# 開始使用 Amazon Connect 全球恢復能力
**重要**
Amazon Connect 在 2021 年 3 月 31 日之前建立的 執行個體，已指派以下格式的網域：
```
https://your-instance-alias.awsapps.com/connect/
```
如果您的網域使用舊格式，您無法正確設定 Amazon Connect 全球恢復能力。若要啟用此功能，您需要[更新網域](update-your-connect-domain.md)至新格式：
```
https://your-instance-alias.my.connect.aws/
```
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
您可以透過在另一個 中建立現有 Amazon Connect 執行個體的複本 AWS 區域，以及建立流量分佈群組，來開始使用 Amazon Connect Global Resiliency。
*流量分佈群組*是一種 Amazon Connect 資源，可讓您連結不同 AWS 區域中的 Amazon Connect 執行個體。電話號碼能夠附加至流量分佈群組。這些號碼的流量，可以分佈在流量通訊群組中的執行個體之間。
## 如何設定 Amazon Connect 全球恢復能力
1. [建立現有 Amazon Connect 執行個體的複本](create-replica-connect-instance.md)。使用 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API。
1. [建立流量分佈群組](setup-traffic-distribution-groups.md)。
1. 使用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API。
1. 使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來判斷流量分佈群組是否已成功建立 (`Status` 必須為 `ACTIVE`)。
1. [取得流量分佈群組的電話號碼](claim-phone-numbers-traffic-distribution-groups.md)。成功建立流量分佈群組 (`Status` 是 `ACTIVE`) 之後，您可以使用 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API 來取得其電話號碼。
**注意**
這些電話號碼的預設流量分佈設為 100%-0%。也就是說，100% 的撥入電話流量都會傳送到用於建立複本的來源 Amazon Connect 執行個體。
此外，執行個體取得電話號碼之後，您可以將它們指派給跨 AWS 區域的多個執行個體。若要這麼做，請使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 將號碼指派至流量分佈群組。
1. [更新您的流量分佈](update-telephony-traffic-distribution.md)。使用 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API，以 10% 的增量在連結的執行個體之間分配流量。
# 建立現有 Amazon Connect 執行個體的複本
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
您可以呼叫 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API，在另一個 中建立 Amazon Connect 執行個體的複本， AWS 區域 並複製 Amazon Connect 資源的組態資訊 AWS 區域。
**Topics**
+ [須知事項](#important-info-automated-config)
+ [複本執行個體的特性](#replica-characteristics)
+ [複本執行個體中會鏡像哪些資源](#mirrored-resources)
+ [建立複本執行個體後該怎麼做](#configure-replica-instance)
+ [何時聯絡 AWS 支援](#replica-cs)
+ [為什麼 ReplicateInstance 呼叫失敗](#why-replicateinstance-fails)
+ [尋找執行個體的來源區域](#how-to-find-source-region-of-instances)
## 須知事項
+ 執行 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 之前：
+ 請確保您具有建立執行個體所需的 IAM 許可。請參閱 [使用自訂 IAM 政策管理 Amazon Connect 主控台存取權的必要許可](security-iam-amazon-connect-permissions.md)。
+ 更新您的流程，以使用 `$.AwsRegion` 或 `$['AwsRegion']` 參數取代任何硬編碼區域。在流程執行期，這些參數會取代為執行流程的區域。
+ 請確保您跨 AWS 區域 的 Lambda 函數具有相同的名稱。
+ 針對 Amazon Lex 機器人，您可以執行下列其一操作：
+ 使用 Amazon Lex 全球恢復能力，跨 AWS 區域複寫機器人並保留機器人 ID。
+ 根據執行流程 AWS 的區域，將流程變更為分支。在流程執行時期，這些參數會取代為執行流程的區域，如下範例所示。
![\[「檢查聯絡屬性」區塊的屬性頁面。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/acgr-requirements.png)
+ 若要在複本執行個體 AWS 受管金鑰 中允許 ，請使用 AWS 主控台，在您計劃建立複本執行個體的區域中建立暫時 Amazon Connect 執行個體。這將建立 Amazon Connect AWS 受管金鑰 的預設值。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 會將 Amazon Connect 組態複製到 AWS 區域 ，作為初始複寫程序的一部分。完成第一個步驟後，稍後對原始資源或[鏡像資源](#mirrored-resources)所做的任何變更都會持續同步。這會雙向發生，從來源到複本，以及從複本到來源。
+ 來源執行個體上尚未與號碼群組相關聯的所有電話號碼，都會自動新增至預設流量分佈群組。此步驟可讓電話號碼在來源區域和複本區域中使用，並可讓電話號碼流程鏡像關聯到 AWS 區域。
+ 針對亞太地區 (東京) 的執行個體，只有明確針對 Amazon Connect 全球恢復能力 (ACGR) 啟用的電話號碼能支援亞太區域 (大阪) 的完整複寫行為。透過亞太區域 (大阪) 轉接時，來電交付時間可能長達 20 秒。
+ 只有在預設轉接設定檔和佇列鏡像到區域之後，才能使用複本執行個體登入緊急存取。
+ 隨著組態的傳播 AWS 區域，您可以在 AWS CloudTrail 日誌中檢視進度。或者，在 Amazon Connect 管理員網站中，您可以導覽至**使用者管理**、**檢視歷史變更**，以檢視使用者變更的稽核線索。稽核記錄也可用於其他組態。
+ 您可能會在 CloudTrail 日誌中看到下列錯誤，但這些錯誤不會影響組態鏡像。
+ Http 409 (衝突) 錯誤：快速連續地處理針對相同聯絡中心資源的多個組態更新時，會因為鏡像衝突發生此錯誤。雖然這些錯誤可能出現在您的日誌中，但不會影響聯絡中心資源的實際鏡像。
+ 如果來源執行個體和複本執行個體中的資源具有相同的名稱，但資源 ID 不同，則會發生資源名稱衝突。例如，如果複本執行個體中的資源是在複寫程序之外手動建立的，就可能會發生這種情況。
在資源名稱衝突的情況下，[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 不會跨區域同步資源。相反，它會發生 `ResourceConflictException` 錯誤。解決名稱衝突後 (例如，刪除複本執行個體中的資源)，您可以再次執行 `ReplicateInstance` 以同步資源。
+ 執行 `ReplicateInstance` 之後，您必須使用 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API，將客服人員與預設流量分佈群組或自訂流量分佈群組建立關聯。
+ 執行 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 不會同步 Lambda 函數或 Amazon Lex 機器人，或您可能擁有的其他第三方/整合。
## 複本執行個體的特性
+ 複本 Amazon Connect 執行個體建立在與您現有的 Amazon Connect 執行個體相同的 AWS 帳戶中。
+ [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 會建立預設流量分佈群組，如果尚未存在。此預設流量分佈群組有三種類型的流量分佈：
+ 登入
+ 客服人員
+ 電話語音
使用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 來建立更多流量分佈群組，但是，這些額外的流量分佈群組並非預設流量分佈群組，因此只支援客服人員和電話分佈。
+ 預設流量分佈群組是唯一可以變更 `SignInConfig` 分佈的流量分佈群組。請參閱 [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 中的 `IsDefault` 參數。
+ 您可以使用 `SignInConfig` 選擇後端登入伺服器，以便客服人員登入其 Amazon Connect 執行個體。例如，如果您使用修改的 `SignInConfig` 和非預設值 `TrafficDistributionGroup` 呼叫 `UpdateTrafficDistribution`，則會傳回 `InvalidRequestException`。
+ 複本執行個體與複寫來源的 Amazon Connect 執行個體具有相同的執行個體 ID。
## 複本執行個體中會鏡像哪些資源
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 會將以下 Amazon Connect 資源鏡像到 AWS 區域。
**重要**
在跨區域鏡像資源 AWS 區域 *之前*，會自動比對這些資源的 Service Quotas。若要增加複本執行個體中的任何其他配額，請提交請求。
+ 客服人員熟練度
+ 流程
+ 流程模組
+ 使用者
+ 轉接設定檔
+ 佇列
+ 安全性設定檔
+ 操作時數
+ 快速連接
+ 預先定義屬性
+ 提示 (不包括存放在 S3 中的提示)
+ 使用者階層 (群組和層級)
+ 客服人員狀態
+ 預先定義屬性
+ 已儲存的報告
+ 檢視
+ 資料表
+ 工作區
+ 流程模組版本
+ 流程模組別名
+ 自訂指標
+ 測試案例
+ 通知
**有關特定資源的重要備註**
**已儲存的報告**：複寫已儲存的報告時，*不會*複寫與已儲存報告相關聯的排程。
**檢視**：只會複寫處於*已發佈*狀態的檢視。*不會*複寫處於草稿狀態的檢視。
**資料表**：包含常值 ARN 參考的資料表值會在複寫時自動將區域碼調整為本機區域。使用表達式建構的 ARNs 可能不會自動調整區域碼。
[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) 也會將下列關聯複寫到 AWS 區域：
+ 流程的電話號碼
+ 佇列至轉接設定檔
+ 使用者至安全性設定檔、轉接設定檔和使用者階層
+ 轉接設定檔
+ 佇列至快速連接
+ 佇列至操作時數
+ 佇列至流程
**注意**
初始複寫後，組態變更會在複寫的執行個體間近乎即時地雙向複寫。如果失敗，Amazon Connect 全球恢復能力會在 30 分鐘內嘗試同步更新。
## 建立複本執行個體後該怎麼做
建立 Amazon Connect 執行個體複本之後，您需要對其進行設定：
1. 確保跨區域的前端和後端整合 (例如 SSO、Lambda、Lex) 的備援。
1. 在連結的執行個體中進行相符的手動更新。
1. 使用 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API，將客服人員與預設流量分佈群組建立關聯。
在您可以將客服人員與流量分佈群組建立關聯之前，它們必須同時存在於來源和複本執行個體上。當使用者新增至來源執行個體，但是尚未在複本中時，您無法將使用者與流量分佈群組建立關聯。
## 聯絡 AWS Support 的時機
如需下列活動的協助，請聯絡 AWS Support：
+ 若要了解鏡射狀態，超出 CloudTrail 日誌中可用的狀態，以及 Amazon Connect 管理員網站中的稽核線索。
## 為什麼 ReplicateInstance 呼叫失敗
在下列情況下，[ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 呼叫失敗，並顯示 `InvalidRequestException`：
1. 您建立複本的區域與現有執行個體的區域相同。
1. 執行個體已經複寫，並作為不同 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 呼叫的一部分。
1. 執行個體沒有別名。
1. 執行個體不處於 `ACTIVE` 狀態。
1. 執行個體並未啟用 SAML。
1. 資源名稱發生衝突。
## 如何找到您的 Amazon Connect 執行個體來源區域
如果您忘記哪個區域是 Amazon Connect 執行個體的來源區域，請執行下列步驟以尋找該區域：
1. 呼叫 [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html) API 和您的 `InstanceId`。
1. 對於回應清單中的任何流量分佈群組，傳回的 `InstanceARN` 包括來源區域。例如，在下列 ARN 中，*來源區域*將是您的 Amazon Connect 執行個體的區域。
`arn:aws:connect:source-region:account-id:traffic-distribution-group/ traffic-distribution-group-id`
# 為您的 Amazon Connect 執行個體建立流量分佈群組
您可以使用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API，為現有的 Amazon Connect 執行個體建立流量分佈群組。
*流量分佈群組*是一種 Amazon Connect 資源，可讓您連結不同 AWS 區域中的 Amazon Connect 執行個體。電話號碼能夠附加至流量分佈群組。這些號碼的流量，可以分佈在流量通訊群組中的執行個體之間。
## 須知事項
+ 建立流量分佈群組時，必須在來源 AWS 區域中建立該群組。*來源區域*是您設定現有 Amazon Connect 執行個體的區域。
+ 將電話號碼與流量分佈群組產生關聯時：
+ 您只能關聯來源區域中取得的電話號碼。
+ 電話號碼必須與建立流量分佈群組所在的區域相同。
+ 您可以向流量分佈群組取得號碼，或者只有在其 `Status` 為 `ACTIVE` 時，才能取得或更新流量分佈群組的流量分佈。使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來判斷其是否已成功建立 (`Status` 必須為 `ACTIVE`)。
+ 當您建立 Amazon Connect 執行個體複本時，系統會為其建立一個預設流量分佈群組。預設流量分佈群組是唯一可以變更 `SignInConfig` 分佈的流量分佈群組。請參閱 [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 中的 `IsDefault` 參數。您可以使用 `SignInConfig` 選擇後端登入伺服器，以便客服人員登入其 Amazon Connect 執行個體。例如，如果您使用修改的 `SignInConfig` 和非預設值 `TrafficDistributionGroup` 呼叫 `UpdateTrafficDistribution`，則會傳回 `InvalidRequestException`。
## 流量分佈群組狀態
以下是流量分佈群組狀態的描述：
+ `CREATION_IN_PROGRESS`：正在建立流量分佈群組。
+ `ACTIVE`：流量分佈群組已建立。
+ `CREATION_FAILED`：流量分佈群組建立失敗。
+ `PENDING_DELETION`：正在刪除流量分佈群組。
+ `DELETION_FAILED`：流量通訊群組刪除失敗。
+ `UPDATE_IN_PROGRESS`：流量通訊群組更新正在進行中。
## 為什麼 CreateTrafficDistributionGroup 呼叫失敗
在下列情況下，[CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 呼叫會失敗，並顯示 `InvalidRequestException`：
+ 為連結的執行個體建立流量分佈群組之前，未呼叫 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API。
+ 當呼叫 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 時，相同區域中 [CreateTrafficDistributionGroup API](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) 沒有被呼叫。呼叫此 API 的區域必須與用來建立複本的執行個體區域相符。
# 透過 Amazon Connect 要求流量分佈群組的電話號碼
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
成功建立流量分佈群組之後 (`Status` 為 `ACTIVE`)，請使用 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API 來搜尋可用的電話號碼，請使用 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 來取得這些號碼。
在向流量分佈群組取得電話號碼之前，我們建議您使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來確認流量分佈群組的狀態是否為 `ACTIVE`。將電話號碼指派至 `ACTIVE` 不會導致 `ResourceNotFoundException` 的流量分佈群組。
您可以在呼叫 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API 時，在 **TargetArn** 參數中提供流量分佈群組 ARN 來取得流量分佈群組的電話號碼。您也可以使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API，將先前取得給執行個體的電話號碼指派給流量分佈群組。
**注意**
若要更新**描述**欄位，您必須使用 Amazon Connect 主控台。
## 範例工作流程
以下是取得電話號碼並跨多個 AWS 區域使用電話號碼的工作流程範例：
1. 在您的執行個體上建立副本。
1. 呼叫 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API。
1. 建立將這些執行個體連結在一起的流量分佈群組：
1. 呼叫 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API。
1. 尋找流量分佈群組可取得的可用電話號碼：
1. 在已建立的流量分佈群組區域中呼叫 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API。為 `TargetArn` 參數提供流量分佈群組 ARN。
1. 在已建立的流量分佈群組區域中，呼叫 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API：
1. 為 `TargetArn` 參數提供您的流量分佈群組 ARN。
1. 在步驟 3 中提供由 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) API 呼叫傳回的 E164 電話號碼值。
`PhoneNumberId` 和 `PhoneNumberArn` 已傳回。您可以使用這些值進行後續作業。
1. 驗證電話號碼狀態為 `CLAIMED`：
1. 呼叫 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html) API。
(DescribePhoneNumber 也可以在與流量分佈群組相關聯的其他區域中呼叫。它將返回相同的電話號碼詳細資訊。)
僅在電話號碼狀態為 `CLAIMED` 才能使用後續操作。
如需有關可能狀態的說明，請參閱 [已定義電話號碼狀態](#claim-phone-number-status)。
1. 針對您需要向流量分佈群組取得的所有電話號碼，重複步驟 3-5。
1. 執行下列步驟，將流程與電話號碼建立關聯。在流量分佈群組運作的兩個區域執行這些動作。
這些步驟可確保您的電話語音流量將正確路由到您的流程，以支援流量分佈組態。
1. 在建立流量分佈群組區域中現有的 Amazon Connect 執行個體中，執行下列步驟：
1. 呼叫 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API。提供與已複製之執行個體對應的 `InstanceId`。
1. 傳回流程 ARN 的清單。使用這些流程 ARN 將流程與電話號碼相關聯；請呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API。
1. 在另一個 AWS 區域的複寫 Amazon Connect 執行個體中，執行下列步驟：
1. 呼叫 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API。提供與已複製之執行個體對應的 `InstanceId`。
1. 傳回流程 ARN 的清單。使用這些流程 ARN 將流程與電話號碼相關聯；請呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API。
## 為什麼 ClaimPhoneNumber 呼叫失敗
在下列情況下，您的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API 呼叫將失敗，並顯示 `ResourceNotFoundException`：
+ 指定的流量分佈群組不存在、流量分佈群組的狀態不是 `ACTIVE`，或者您沒有流量分佈群組的擁有權。
+ 電話號碼不可取得。在某些情況下，從 [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) 找到的電話號碼可能已被其他客戶取得。
下列案例中，您的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 將失敗，並顯示 `InvalidParameterException` 錯誤：
+ 您呼叫的端點不在建立流量分佈群組的相同區域中。
## 已定義電話號碼狀態
以下是電話號碼狀態的描述：
+ `CLAIMED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作成功。
+ `IN_PROGRESS` 表示 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)、[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作仍在進行中，尚未完成。您可以稍後呼叫 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)，以驗證先前的操作是否已完成。
+ `FAILED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作失敗。其中包含指示失敗原因的訊息。
失敗的常見原因是您取得或更新電話號碼的 `TargetArn` 值已達到取得號碼總數的限制。
如果您收到 `ClaimPhoneNumber` API 呼叫的 `FAILED` 狀態，您有一天的時間可以重新取得該電話號碼，然後再將號碼釋出回儲存庫存中，以供其他客戶取得。
# 在 Amazon Connect 中將取得的電話號碼指派給流量分佈群組
+ 您已建立狀態為 `ACTIVE` 的新流量分佈群組。我們建議您使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來驗證狀態。
+ 您已向執行個體或其他流量分佈群組取得電話號碼。
現在，您可以使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 將這些取得的電話號碼分配給新的流量分佈群組。在 `TargetArn` 參數中提供流量分佈群組 ARN。
**注意**
若要更新**描述**欄位，您必須使用 Amazon Connect 主控台。
## 範例工作流程
以下是將已取得的電話號碼指派給流量分佈群組的工作流程範例：
1. 呼叫 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 將電話號碼指派給新 `TargetArn`。
`TargetArn` 可以適用於另一個 Amazon Connect 執行個體，也可以適用於在最初取得電話號碼的相同區域中所建立的流量分佈群組。
1. 執行下列步驟，將流程與電話號碼建立關聯。
這些步驟可確保您的電話語音流量將正確路由到您的流程，以支援流量分佈組態。
1. 在建立流量分佈群組區域中現有的 Amazon Connect 執行個體中，執行下列步驟：
1. 呼叫 [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) API。提供與已複製之執行個體對應的 `InstanceId`。
1. 傳回流程 ARN 的清單。使用這些流程 ARN 將流程與電話號碼相關聯；請呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html) API。
至流程關聯的電話號碼將在跨 AWS 區域的 Amazon Connect 執行個體之間進行鏡像。
## 為什麼 AssociatePhoneNumberContactFlow 呼叫失敗
如果號碼已向流量分佈群組宣告，且您使用建立流量分佈群組 AWS 區域 的 中的執行個體呼叫 [AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)，則您可以使用 `PhoneNumberId` URI 請求參數的完整電話號碼 ARN 或 UUID 值。
不過，如果號碼是向流量分佈群組宣告，而您使用與流量分佈群組 AWS 區域 相關聯的複本中的執行個體呼叫此 API，您必須提供完整的電話號碼 ARN。如果在此案例中提供 UUID，您將會收到 `ResourceNotFoundException`。
## 為什麼 UpdatePhoneNumber 呼叫失敗
在下列情況，您的 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 呼叫將失敗，並顯示 `ResourceNotFoundException`：
+ 指定的流量分佈群組不存在、流量分佈群組的狀態不是 `ACTIVE`，或者您沒有流量分佈群組的擁有權。
在下列情況，您的 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API 呼叫將失敗，並顯示 `InvalidParameterException` 錯誤：
+ 您呼叫的端點不在建立流量分佈群組的相同區域中。
## 已定義電話號碼狀態
以下是電話號碼狀態的描述：
+ `CLAIMED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作成功。
+ `IN_PROGRESS` 表示 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)、[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作仍在進行中，尚未完成。您可以稍後呼叫 [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)，以驗證先前的操作是否已完成。
+ `FAILED` 表示先前的 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) 或 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) 操作失敗。其中包含指示失敗原因的訊息。失敗的常見原因是您取得或更新電話號碼的 `TargetArn` 值已達到取得號碼總數的限制。
# 更新 Amazon Connect 執行個體和 之間的電話流量分佈 AWS 區域
您可以使用 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 跨區域分佈電話流量和[轉移客服人員](update-agents-across-regions.md)。
**注意**
當您轉移電話流量時，請一併轉移客服人員和/或客服人員登入，以確保他們可以處理其他區域的通話。如果您未轉移客服人員，而語音通話將前往已轉移的區域，就沒有客服人員能接聽電話。
在流量分佈群組取得電話號碼之後，您可以使用 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API，以 10% 的增量在指定流量分佈群組中的連結執行個體之間分佈撥入語音聯絡。
如果不符合以下要求，您的 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 呼叫將失敗，並顯示 `InvalidRequestException`：
+ 您必須提供電話流量組態的分佈。
+ 您必須為這兩個連結的執行個體指定流量分佈，且分佈總計必須達到 100%。
+ 您必須以 10% 的增量指定流量分佈。
+ 電話組態中指定的執行個體 ARN 必須與連結執行個體的 ARN 相符。
從來源 AWS 區域呼叫 `UpdateTrafficDistribution` 時，您可以使用流量分佈群組 ID 或 Amazon Resource Name (ARN)。當您在複本區域呼叫 `UpdateTrafficDistribution` 時，您必須使用流量分佈群組 ARN。
# 使用 Amazon Connect 全球恢復能力設定您客服人員的體驗
Amazon Connect 全球恢復能力，可讓您為客服人員透過全域登入、客服人員分佈 API 和客服人員工作區增強，以提供全球體驗。透過這系列功能，您可以：
+ 使您的客服人員一天開始時登入一次，並處理其當前活動區域的聯絡，而無需隨時了解哪個區域處於活動狀態。
+ 將客服人員新增至流量分佈群組，並在 AWS 區域分佈客服人員。
+ 透過簡單的頁面重新整理，將新的傳入語音聯絡人重新導向至目前作用中區域的客服人員工作區。
**Topics**
+ [將您的 IdP 與 Amazon Connect 全球備援 SAML 登入端點整合](integrate-idp.md)
+ [將客服人員與跨多個 AWS 區域的執行個體建立關聯](associate-agents-across-regions.md)
+ [更新不同區域的客服人員分佈](update-agents-across-regions.md)
+ [設定客服人員工作區](setup-agentworkspace-switchover.md)
+ [跨區域轉移客服人員時避免問題的秘訣](possible-issues-shifting-regions.md)
# 將您的身分提供者 (IdP) 與 Amazon Connect 全球備援 SAML 登入端點整合。
若要讓您的客服人員登入一次，並登入兩個 AWS 區域以處理目前作用中區域的聯絡人，您需要設定 IAM 設定以使用 SAML 端點中的全域登入。
## 開始之前
您必須為您的 Amazon Connect 執行個體啟用 SAML，才能使用 Amazon Connect 全球恢復能力。如需有關使用 IAM 聯合的入門資訊，請參閱[啟用 SAML 2.0 聯合身分使用者存取 AWS 管理主控台](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html)。
## 須知事項
+ 只有在使用全域登入端點時，才支援代理程式容錯移轉。
+ 若要執行本主題中的步驟，需要您的執行個體 ID。如需有關如何尋找的說明，請參閱 [尋找您的 Amazon Connect 執行個體 ID 或 ARN](find-instance-arn.md)。
+ 您還需要知道 Amazon Connect 執行個體的來源區域。如需有關如何尋找的說明，請參閱 [如何找到您的 Amazon Connect 執行個體來源區域](create-replica-connect-instance.md#how-to-find-source-region-of-instances)。
+ 如果您要在 iframe 中嵌入 Connect 應用程式，請確保您的網域同時列在來源和複本執行個體的核准來源清單中，以使全域登入正常運作。
若要在執行個體層級設定核准來源，請遵循 [在 Amazon Connect 中使用整合式應用程式的允許清單](app-integration.md) 中的步驟。
+ 必須已在來源和複本*兩者* Amazon Connect 執行個體中建立客服人員，且使用者名稱與身分提供者 (IdP) 的角色工作階段名稱相同。否則，您會收到 `UserNotOnboardedException` 例外狀況，且可能會失去執行個體之間的客服人員備援功能。
+ 在客服人員嘗試登入之前，您必須先將客服人員與流量分佈群組建立關聯。否則，客服人員將登入失敗，並顯示 `ResourceNotFoundException`。如需有關如何設定流量分佈群組並將客服人員與其關聯的相關資訊，請參閱 [將客服人員與跨多個 AWS 區域的 Amazon Connect 執行個體建立關聯](associate-agents-across-regions.md)。
+ 當您的客服人員使用新的 SAML 登入 URL 聯合登入 Amazon Connect 時，無論流量分佈群組中的 `SignInConfig` 如何設定，Amazon Connect 全球恢復能力都會嘗試將客服人員登入您的來源和複本區域/執行個體。您可以通過檢查 CloudTrail 日誌來驗證。
+ 預設流量`SignInConfig`分佈群組中的分佈只會決定 AWS 區域 用於促進登入的分佈。無論您的 `SignInConfig` 分佈設定方式為何，Amazon Connect 一律會嘗試將客服人員登入 Amazon Connect 執行個體的兩個區域。
+ 複寫 Amazon Connect 執行個體後，只會為您的執行個體產生一個 SAML 登入端點。此端點一律包含 URL AWS 區域 中的來源。
+ 將個人化 SAML 登入 URL 與 Amazon Connect 全球恢復能力搭配使用時，您不需要設定轉送狀態。
## 如何整合您的身分提供者
1. 當您使用 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 建立 Amazon Connect 執行個體的複本時，系統會為您的 Amazon Connect 執行個體產生個人化的 SAML 登入 URL。產生的 URL 格式如下：
`https://instance-id.source-region.sign-in.connect.aws/saml`
1. *執行個體 ID* 是執行個體群組中任一執行個體的執行個體 ID。來源區域和複本區域中的執行個體 ID 相同。
1. *source-region* 對應至呼叫 [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html) API 的來源 AWS 區域。
1. 將下列信任政策新增至您的 IAM 聯合角色。使用全域登入 SAML 端點的 URL，如下列範例所示。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Federated":[
"arn:aws:iam::111122223333:saml-provider/MySAMLProvider"
]
},
"Action":"sts:AssumeRoleWithSAML",
"Condition":{
"StringLike":{
"SAML:aud":[
"https://instance-id.source-region.sign-in.connect.aws/saml*"
]
}
}
}
]
}
```
------
**注意**
`saml-provider-arn` 是 IAM 中建立的身分提供者資源。
1. 在 IAM 聯合角色中授予 `InstanceId` 對 `connect:GetFederationToken` 的存取權。例如：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GetFederationTokenAccess",
"Effect": "Allow",
"Action": "connect:GetFederationToken",
"Resource": "*",
"Condition": {
"StringEquals": {
"connect:InstanceId": "your-instance-id"
}
}
}
]
}
```
------
1. 使用下列屬性和值字串，將屬性映射新增至您的身分提供者應用程式。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/integrate-idp.html)
1. 設定身分提供者的聲明消費者服務 (ACS) URL，以指向您的個人化 SAML 登入 URL。將下列範例用於 ACS URL：
```
https://instance-id.source-region.sign-in.connect.aws/saml?&instanceId=instance-id&accountId=your AWS account ID&role=saml-federation-role&idp=your SAML IDP&destination=optional-destination
```
1. 在 URL 參數中設定下列欄位：
+ `instanceId`：您 Amazon Connect 執行個體的識別符。如需有關如何尋找執行個體 ID 的說明，請參閱 [尋找您的 Amazon Connect 執行個體 ID 或 ARN](find-instance-arn.md)。
+ `accountId`：Amazon Connect 執行個體所在的 AWS 帳戶 ID。
+ `role`：設定用於 Amazon Connect 聯合的 SAML 角色名稱或 Amazon Resource Name (ARN)。
+ `idp`：設定 IAM 中 SAML 身分提供者的名稱或 Amazon Resource Name (ARN)。
+ `destination`：設定為客服人員在登入後登陸執行個體的可選路徑 (例如：`/agent-app-v2`)。
# 將客服人員與跨多個 AWS 區域的 Amazon Connect 執行個體建立關聯
若要讓您的客服人員同時登入 AWS 區域 和處理任一區域的聯絡人，您必須先將他們指派給流量分佈群組。
1. 如果您尚未設定流量分佈群組，請立即設定。如需說明，請參閱[為您的 Amazon Connect 執行個體建立流量分佈群組](setup-traffic-distribution-groups.md)。
1. 成功建立流量分佈群組 (`Status` 為 `ACTIVE`) 之後，您可以為其指派客服人員。一律將使用者與來源區域中的流量分佈群組建立關聯。
將客服人員指派給沒有 `ACTIVE` 狀態的流量分佈群組會導致 `ResourceNotFoundException`。使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 來判斷其是否已成功建立 (`Status` 必須為 `ACTIVE`)。
1. 您可以呼叫 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API，將客服人員指派給流量分佈群組。
## 範例
下列`associate-traffic-distribution-group-user`範例命令顯示如何將客服人員與多個 區域建立關聯並跨多個 AWS 區域使用。
```
aws connect associate-traffic-distribution-group-user
--traffic-distribution-group-id UUID
--user-id UUID
--instance-id
```
下列 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) 範例會將客服人員與流量分佈群組建立關聯。
```
PUT /traffic-distribution-group/trafficDistributionGroupId/user HTTP/1.1
Content-type: application/json
{
"UserId": "string"
}
```
下列 `disassociate-traffic-distribution-group-user` 範例命令會取消客服人員與流量分佈群組的關聯。
```
aws connect disassociate-traffic-distribution-group-user
--instance-id your instance ID
--traffic-distribution-group-id UUID
--user-id UUID
```
下列 [DisassociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_DisassociateTrafficDistributionGroupUser.html) 範例會將客服人員與流量分佈群組取消關聯。
```
DELETE /traffic-distribution-group/trafficDistributionGroupId/user/UserId HTTP/1.1
```
## 為什麼 AssociateTrafficDistributionGroupUser 呼叫失敗
在以下情況下，[AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API 呼叫將失敗，並顯示：`ResourceNotFoundException`
1. 指定的流量分佈群組不存在。
1. 流量分佈群組的狀態不是 `ACTIVE`。
1. `user-id UUID` 不是來源 Amazon Connect 執行個體的使用者。
# 在跨 AWS 區域的 Amazon Connect 客服人員工作區中更新客服人員分佈
正如您可以使用 `UpdateTrafficDistribution` API [跨區域分佈電話流量](update-telephony-traffic-distribution.md)一樣，您也可以使用它來將客服人員全部或逐步分佈到各個 AWS 區域，作為常規運營準備測試的一部分。例如，您可以在一個 AWS 區域中保留 40% 的客服人員，以完成作用中的聯絡，並將剩餘的客服人員轉移到複本區域。
**注意**
當您轉移電話流量時，請一併轉移客服人員和/或客服人員登入，以確保他們可以處理其他區域的通話。如果您未轉移客服人員，而語音通話將前往已轉移的區域，就沒有客服人員能接聽電話。
在流量分佈群組新增客服人員之後，您可以使用 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API，以 10% 的增量在指定流量分佈群組中的連結執行個體之間分佈客服人員。您的客服人員將能夠在更換地區之前完成有效的語音聯絡。
**注意**
如果客服人員在轉移區域之前嘗試結束聯絡時收到錯誤，則需要重新整理客服人員工作區頁面。如需詳細資訊，請參閱[設定 Amazon Connect 客服人員工作區，以支援客服人員跨 AWS 區域轉移](setup-agentworkspace-switchover.md)。
**Topics**
+ [要求](#update-agent-traffic-distribution-requirements)
+ [在一般操作期間啟用兩個區域](#change-signin-weights)
+ [如何跨 AWS 區域轉移所有電話流量和客服人員](#shift-all-traffic)
+ [區域切換 UI 橫幅](#regional-switch-ui-banner)
## 要求
如果不符合以下要求，您的 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 呼叫將失敗，並顯示 `InvalidRequestException`：
1. 必須存在指定的流量分佈群組。
1. 流量分佈群組的狀態必須是 `ACTIVE`。
1. 如果您要變更 `SignInConfig` 分佈，則只能針對預設流量分佈群組執行此動作。當 Amazon Connect 執行個體複本已建立時，系統會為其建立一個預設流量分佈群組。請參閱 [TrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_TrafficDistributionGroup.html) 中的 `IsDefault` 參數。
從來源 AWS 區域呼叫 `UpdateTrafficDistribution` 時，您可以使用流量分佈群組 ID 或 Amazon Resource Name (ARN)。當您在複本區域呼叫 `UpdateTrafficDistribution` 時，您必須使用流量分佈群組 ARN。
## 在一般操作 AWS 區域 期間啟用兩者
該 `UpdateTrafficDistribution` API 包含一個名為 `SignInConfig` 的分佈。它可讓您選擇要使用哪些後端登入伺服器來協助客服人員登入其執行個體群組。無論流量分佈群組中的 `SignInConfig` 設定為何，客服人員都會登入流量分佈群組中的這兩個執行個體。
為了獲得最佳體驗，建議您在一般操作期間啟用這兩個 AWS 區域。若要實現將 `true` 傳遞至兩個 `SignInConfig` 分佈。如果您需要將整個電話流量和客服人員轉移到一個 AWS 區域，建議您`false`將流量轉移來源區域的 `SignInConfig` 變更為 。
例如，下列呼叫會導致客服人員有 50% 的機會使用 us-west-2 登入伺服器，而 50% 的機會使用 us-east-1 登入伺服器來自身分提供者的指定登入呼叫。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":true
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
相反，以下登入分佈路由登錄端點上的 100% 流量使用 us-east-1 登入伺服器。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
}
}'
```
此分佈僅控制登入伺服器的哪個區域可用來協助將客服人員記錄至其執行個體群組中的兩個執行個體。它不會影響 `UpdateTrafficDistribution` API `AgentConfig` 部分控制的客服人員分佈。
**重要**
如果登入端點在客服人員登入期間沒有回應，而且您的 `SignInConfig` 分佈會跨區域分割，則您可以將分佈變更為單一 AWS 區域來解決錯誤。或者，如果您對一個區域進行 `SignInConfig` 加權，但沒有響應，則可以嘗試將其轉移到 `SignInConfig` 停用的區域。無論您 `SignInConfig` 的設定方式為何，客服人員仍會從來源區域和複本區域的啟用工作階段中受益，因為他們會嘗試在兩個區域中登入其 Amazon Connect 執行個體。
## 如何跨 AWS 區域轉移所有電話流量和客服人員
若要將所有新的撥入語音聯絡、客服人員登入分佈和客服人員分佈從 us-west-2 轉移到 us-east-1，請使用下列程式碼片段。
```
aws connect update-traffic-distribution \
--id traffic distribution group ID or ARN \
--cli-input-json \
'{
"SignInConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Enabled":false
},
{
"Region":"us-east-1",
"Enabled":true
}
]
},
"AgentConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
},
"TelephonyConfig":{
"Distributions":[
{
"Region":"us-west-2",
"Percentage":0
},
{
"Region":"us-east-1",
"Percentage":100
}
]
}
}
'
```
從來源 AWS 區域呼叫 `UpdateTrafficDistribution` 時，您可以使用流量分佈群組 ID 或 Amazon Resource Name (ARN)。當您在複本區域呼叫 `UpdateTrafficDistribution` 時，您必須使用流量分佈群組 ARN。
## 區域切換 UI 橫幅
客服人員工作區和 CCP 將提供 UI 橫幅反白區域切換。
如果客服人員在其區域因流量分佈群組 (TDG) 調整而變更時**正在聯絡**上，他們將看到類似以下的橫幅。一旦他們完成語音聯絡並關閉 ACW 狀態，客服人員就會自動更新到新的區域，無需採取任何動作。如果客服人員在關閉聯絡人時遇到問題，他們可以在**備份中選取繼續**，此時會出現一個快顯視窗，要求確認以切換到替代區域。
我們建議您調整執行手冊和代理程式訓練指南以反映此內容
![\[客服人員工作區 UI 顯示橫幅，在 TDG 調整期間反白顯示區域容錯移轉。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/acgr-failover-banner.png)
![\[當客服人員在 Backup 中選取繼續時出現的確認快顯視窗。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/acgr-failover-confirmation.png)
# 設定 Amazon Connect 客服人員工作區，以支援客服人員跨 AWS 區域轉移
執行下列步驟，讓 Amazon Connect Agent Workspace 將聯絡人控制面板從複本 AWS 區域內嵌至來源區域，並在客服人員的作用中區域變更時在這些區域之間切換。
如果您尚未建立來源 Amazon Connect 執行個體的複本或設定流量分佈群組，請參閱 [開始使用 Amazon Connect 全球恢復能力](get-started-connect-global-resiliency.md)。
1. 前往 AWS Amazon Connect 主控台以擷取來源執行個體的**存取 URL**。記下 URL。
1. 在複本區域中， AWS Amazon Connect 主控台會擷取複本執行個體的**存取 URL**。記下 URL。
1. 在複本 Amazon Connect 執行個體的同一視窗中，在左側面板中選擇 **已核准的來源**。
1. 為您在步驟 1 中記下的來源執行個體 **存取 URL** 新增網域。
**注意**
請勿在存取 URL 中包含尾隨 **/**。
1. 在來源執行個體上重複上述步驟：前往 **已核准的來源**，新增複本執行個體的存取 URL。
**注意**
客服人員在跨區域切換之後，必須將其狀態設定為 **可用**。
# 在跨區域 Amazon Connect 執行個體中轉移客服人員時避免問題的秘訣
+ 每當您更新客服人員的流量分佈時，請務必同時更新撥入語音聯絡的流量分佈。否則，您最終可能會遇到一個區域需要大量客服人員，而另一個區域需要大量電話流量的情況。
+ 在將使用者與流量分佈群組建立關聯之前，請先確認來源和複本 Amazon Connect 執行個體中具有相同的使用者名稱。否則，當您將使用者與流量分佈群組產生關聯，但複本區域中沒有使用者名稱的使用者時，您將會收到 `InvalidRequestException` 錯誤。
+ 您必須呼叫 [AssociateTrafficDistributionGroupUser](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateTrafficDistributionGroupUser.html) API，將客服人員與來源區域中的流量分佈群組建立關聯。如果您嘗試在複本區域中執行此操作，則會收到 `ResourceNotFoundException` 錯誤。
# 使用 Amazon Connect API 管理流量分佈群組
本節中的主題描述如何使用 Amazon Connect API 管理流量分佈群組。
**Topics**
+ [列出流量分佈群組](list-traffic-distribution-groups.md)
+ [刪除流量分佈群組](delete-traffic-distribution-groups.md)
# 列出流量分佈群組
使用 [ListTrafficDistributionGroups](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListTrafficDistributionGroups.html) API 列出所有流量分佈群組。
您可能想要列出流量分佈群組，以便判斷特定 Amazon Connect 執行個體是否屬於任何流量分佈群組的一部分。
# 在 Amazon Connect 中刪除流量分佈群組
使用 [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html) API 刪除不再需要的流量分佈群組。
**注意**
如果電話號碼是向流量分佈群組取得，則您無法刪除該流量分佈群組。您必須先使用 [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html) API，從流量分佈群組釋出電話號碼。之後，您可以刪除流量分佈群組。
您無法使用 Amazon Connect 主控台從流量分佈群組釋出號碼。
如果電話號碼仍向流量分佈群組取得，您的 [DeleteTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DeleteTrafficDistributionGroup.html) API 呼叫將會失敗，並顯示 `ResourceInUseException`。
# 使用 Amazon Connect API 管理跨區域的電話號碼
本節中的主題說明如何 AWS 區域 使用 Amazon Connect APIs 管理跨 的電話號碼。
**Topics**
+ [向多個執行個體申請電話號碼 AWS 區域](claim-phone-number-multiple-regions.md)
+ [將申請的電話號碼跨 移至多個執行個體 AWS 區域](move-phone-number-multiple-regions.md)
+ [從流量分佈群組釋出號碼](release-numbers-traffic-distribution-group.md)
# 跨多個 向 Amazon Connect 執行個體申請電話號碼 AWS 區域
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
若要跨多個執行個體撥打或接聽電話號碼 AWS 區域，您需要向流量分佈群組申請電話號碼。
**向流量分佈群組取得電話號碼**
1. 使用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 建立流量分佈群組。
1. 使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 描述您的流量分佈群組，來判斷其是否已成功建立 (`Status` 必須為 `ACTIVE`)。
1. 成功建立流量分佈群組 (`Status` 為 `ACTIVE`) 之後，您可以使用 [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) API 來取得該群組的電話號碼。
# 將申請的電話號碼跨 移至多個 Amazon Connect 執行個體 AWS 區域
**注意**
**您是新的使用者嗎？** 參閱 [Amazon Connect 全球恢復能力研討會](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US)。這個線上課程會引導您透過 AWS CLI 使用新 API，來加入和測試電話號碼和客服人員容錯移轉。
全域彈性僅適用於在下列 AWS 區域中建立的 Amazon Connect 執行個體：美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、亞太區域 （大阪）、亞太區域 （東京）、歐洲 （法蘭克福） 和歐洲 （倫敦）。
如果您的來源是美國西部 (奧勒岡)，您只能在美國東部 (維吉尼亞北部) 區域中建立複本，反之亦然。
如果您的來源是歐洲 (倫敦)，您只能在歐洲 (法蘭克福) 區域中建立複本，反之亦然。
如果您的來源是亞太地區 (東京)，您只能在亞太區域 (大阪) 區域中建立複本。
若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。
您可以將先前取得的電話號碼移至執行個體，而非將其指派給多個 AWS 區域執行個體。您可以透過將電話號碼指派給流量分佈群組來執行此操作。
**將電話號碼指派至流量分佈群組**
1. 使用 [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html) API 建立流量分佈群組。
1. 使用 [DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html) API 描述您的流量分佈群組，來判斷其是否已成功建立 (`Status` 必須為 `ACTIVE`)。
1. 成功建立流量分佈群組 (`Status` 為 `ACTIVE`) 之後，您可以將先前取得的電話號碼指派至其他執行個體或其他流量分佈群組。使用 [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) API。
# 從流量分佈群組釋出 Amazon Connect 中的電話號碼
若要從流量分佈群組釋出電話號碼，請使用 [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html) API。該號碼將釋出回庫存，供其他客戶取得。
您無法使用 Amazon Connect 主控台從流量分佈群組釋出號碼。
# 在 Amazon Connect 執行個體中管理跨區域的聊天
您可以透過建立兩個自訂聊天介面或兩個out-of-the-box通訊小工具來管理跨 AWS 區域的聊天：一個在來源區域中，另一個在複本區域中。您可以根據您要使用的區域聊天介面或現成的通訊小工具，在兩者之間手動切換。
+ 自訂聊天介面：在複本區域中設定聊天介面，以使用複本區域的 API 端點。如需自訂介面範例，請參閱 GitHub 上的 [Amazon Connect 開放原始碼程式庫](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master)。如需詳細資訊，請參閱[使用 Amazon Connect 開放原始碼範例自訂聊天](download-chat-example.md)。
+ 現成的通訊小工具：在複本 Amazon Connect 執行個體中建立通訊小工具。如需說明，請參閱 [在複本執行個體中設定通訊小工具](#communicationswidget-multiple-regions)。
以下是在您的網站或應用程式中，啟動用戶端聊天所需的聊天組態參數：
+ **Amazon Connect 執行個體 ID** 和**流程 ID**：在來源和複本區域中，這些參數是相同的。
+ **目標 AWS 區域**，通常是用來開始聊天的 **API 端點** （也就是取得參與者字符）：來源和複本區域中的這些參數不同。
例如，下圖顯示聊天流量需跨區域移動時，應如何更新聊天組態以指向複本區域的 API 閘道。
![\[顯示來源區域和複本區域的圖表。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/chatconfig.png)
## 在複本執行個體中設定通訊小工具
1. 如果還沒有通訊小工具，請在您的來源 Amazon Connect 執行個體上建立用於聊天的通訊小工具。如需說明，請參閱 [將聊天使用者介面新增至 Amazon Connect 託管的網站](add-chat-to-website.md)。
1. 在您的複本執行個體上，建立另一個用於聊天的通訊小工具。透過來源執行個體小工具所使用的流程來設定小工具。流程已在複本執行個體中，因為 Amazon Connect 全球恢復能力會將來源的所有流程複製到複本，並持續保持同步。
1. 複製您在複本執行個體中建立的新通訊小工具指令碼。聊天流量轉至複本執行個體時，在應啟用的網站或應用程式上嵌入指令碼。
1. 若要在區域間切換流量，請在您的網頁中，將來源執行個體通訊小工具取代為複本執行個體通訊小工具。
下圖顯示小工具指令碼範例。
![\[通訊小工具指令碼範例。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/source-comwidget.png)
1. 如果您之後對來源執行個體中的通訊小工具進行任何變更，您也需要對複本執行個體中的通訊小工具中進行相同變更。
## 提升順暢度的選項
若要讓跨區域的聊天流量轉移更順暢並減少手動變更，可以透過以下方式，自訂聊天體驗：
1. 將參數新增至集中控制的資料庫 (例如 DynamoDB 全域資料表)。此參數的目的是定義目前作用中的區域。
1. 更新您的網站或應用程式，檢查中央資料庫中區域參數的狀態。
1. 根據不同的作用中區域，網站或應用程式將使用該區域的 API 端點或通訊小工具。
1. 此參數應在呼叫 [UpdateTrafficDistribution](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateTrafficDistribution.html) API 的同時進行更新，以在適用情況下跨區域轉移語音流量和客服人員。
# 跨 ACGR 區域的指標、報告和搜尋
本節中的主題說明 Amazon Connect Global Resiliency (ACGR) AWS 區域 客戶的合併指標、報告和搜尋。
**Topics**
+ [聯絡搜尋和聯絡詳細資訊](contact-search-and-contact-details.md)
+ [跨區域的合併指標](consolidated-metrics-across-regions.md)
# 聯絡搜尋和聯絡詳細資訊
**重要**
若要啟用 ACGR 執行個體的合併聯絡人搜尋，請聯絡 [AWS Support](https://console.aws.amazon.com/support/home)。
**重要**
當您加入此功能時，Amazon Connect 別名會更新為格式為 的新子網域`region.sourcealias.my.connect.aws`。例如，如果您的 ACGR 執行個體部署在美國東部 （維吉尼亞北部） 和美國西部 （奧勒岡），並將來源別名設定為 `source.my.connect.aws`，並將複本別名設定為 `replica.my.connect.aws`，則在將您的 Amazon Connect 執行個體加入此功能後，您將使用 `us-east-1.source.my.connect.aws`和 `us-west-2.source.my.connect.aws`。請確定您更新防火牆規則和第三方整合，以使用這些新的子網域。
當您存取聯絡人搜尋頁面時，預設會看到來自配對 Amazon Connect Global Resiliency (ACGR) 執行個體的聯絡人，讓您完整檢視整個組織的客戶互動。這可提供無縫搜尋體驗，無論哪些區域聯絡人來自或您目前登入的區域為何。
+ **作用中區域**：正在處理或完成聯絡人 AWS 區域 的 。
## 聯絡人搜尋體驗
### 作用中區域篩選條件
您將在篩選條件下拉式清單中看到新的「作用中區域」篩選條件。這可讓您在需要時縮小特定區域的搜尋範圍。
若要使用作用中區域篩選條件：
1. 在**聯絡人搜尋頁面上**，選擇**新增篩選條件**。
1. 從下拉式清單中選取**作用中區域**。
1. 選擇一或多個區域。
![\[作用中區域篩選條件下拉式清單顯示要選取的可用區域。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/active-region-filter.png)
### 區域特定的資源篩選條件
當您使用下列篩選條件時，下拉式清單選項只會顯示在您登入區域中建立的資源：
+ 自訂聯絡屬性
+ 聯絡人類別
+ 評估篩選條件
+ 電子郵件地址
+ 自訂聯絡客群屬性
**重要**
當您手動輸入篩選條件值，而不是從下拉式清單中選取，而且這些資源名稱在 ACGR 執行個體之間是相同的時，您的結果將包含來自兩個區域的聯絡人。
自訂聯絡屬性
電子郵件地址
**評估篩選條件**只會傳回目前區域的聯絡人，因為它們使用區域特定的唯一評估表單 IDs進行搜尋。
### 已儲存的搜尋
您儲存的搜尋會顯示兩個 ACGR 執行個體的聯絡人。任何先前儲存的區域篩選條件都會繼續如預期般運作。
## 聯絡詳細資訊體驗
### 檢視聯絡資訊
當您開啟聯絡詳細資訊頁面時，無論聯絡來自哪個區域，您都會看到完整的資訊，包括：
+ 概觀、連線詳細資訊和佇列資訊
+ 聯絡人標籤和屬性
+ Contact Lens 資料 （對話式分析、語音文字記錄、聊天文字記錄）
+ 螢幕和音訊錄製
+ 聊天文字記錄和 IVR 互動
+ 電子郵件附件和文字記錄
聯絡人的作用中區域會顯示在**全球彈性中繼資料**下的聯絡人詳細資訊頁面上。
![\[聯絡人詳細資訊頁面，顯示具有作用中區域資訊的全域彈性中繼資料區段。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/global-resiliency-metadata.png)
**注意**
如果聯絡人的作用中區域受損，部分資訊可能無法使用，包括螢幕和錄音、聊天文字記錄、IVR 互動、電子郵件附件和文字記錄，以及 Contact Lens 資料。
### Contact Lens 資料存取
您可以完整存取跨區域的 Contact Lens 資料，包括：
+ 進行中聯絡人：對話分析、語音文字記錄 （已編輯和未編輯） 和聊天文字記錄。
+ 已完成的聯絡人：所有對話分析、語音文字記錄 （已編輯和未編輯） 和聊天文字記錄。
+ 錄製：無論聯絡人的作用中區域為何，都可以存取螢幕和音訊錄製。
+ 文字記錄：聊天、IVR 和電子郵件文字記錄可在區域間使用。
### 聯絡動作
無論聯絡人的作用中區域為何，您都可以執行聯絡人動作，例如轉接、重新排程或結束聯絡人。這些動作會路由到聯絡人的作用中區域。
### 聯絡評估
聯絡人評估僅適用於在您登入區域中作用中的聯絡人。您無法檢視或執行來自其他區域的複寫聯絡人評估。
### SearchContacts API
如果您以程式設計方式使用 SearchContacts API，回應會包含其他資訊：
+ GlobalResiliencyMetadata 物件：包含所有聯絡人的 `ActiveRegion``OriginRegion`、 和 `TrafficDistributionGroupId` 欄位，顯示聯絡人作用中的特定區域。
如需 SearchContacts API 的詳細資訊，請參閱 [Amazon Connect API 參考](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchContacts.html)。
# 跨區域的合併指標
**重要**
若要啟用 ACGR 執行個體的合併客服人員和聯絡指標，請聯絡 [AWS Support](https://console.aws.amazon.com/support/home)。
當您在 Amazon Connect 中檢視指標時，無論您目前登入的區域為何，您都會看到所有配對區域的客服人員和聯絡指標的合併檢視。
例如，如果您有 5 個客服人員登入 us-east-1 並可用於 BasicQueue，以及 10 個客服人員登入 us-west-2 並可用於 BasicQueue，即時指標頁面會顯示總共 15 個客服人員線上。此合併檢視可讓您在單一界面中監控聯絡中心操作。
## 可用的指標
合併檢視可用於：
+ 即時指標：檢視 ACGR 執行個體目前的客服人員活動和聯絡指標。
+ 歷史指標：跨 ACGR 執行個體存取歷史效能資料。
+ 指標 APIs：API 回應會傳回 ACGR 執行個體的合併指標。
**注意**
客服人員和聯絡指標會跨區域合併。分析等其他指標仍會依區域而有所不同。
如需 Amazon Connect 報告的詳細資訊，請參閱 [Amazon Connect 中的指標、儀表板和報告](amazon-connect-metrics.md)。