本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# AWS 最終使用者簡訊簡訊中的電話集區
電話集區也稱為 集區，是一組電話號碼或寄件者 IDs，共用您可用來傳送訊息的相同設定。當您透過電話集區傳送訊息時，它會選擇適當的起始身分來傳送訊息。如果電話集區中的起始身分失敗，如果電話集區位於相同的電話集區中，則電話集區將容錯移轉至另一個起始身分。
**注意**
電話集區可以與通知組態建立關聯，以使用您自己的專用電話號碼與受 AWS管身分進行範本傳訊。如需詳細資訊，請參閱[搭配 Notify 使用專用號碼](notify-dedicated-numbers.md)。
建立集區時，可以設定指定的起始身分。此身分包括關鍵字、訊息類型、選擇不接收清單、雙向組態和自我管理選擇不接收組態。例如，使用集區，您可以將選擇退出的目的地電話號碼清單與特定國家/地區的電話號碼建立關聯。如此一來，您就可以避免將訊息傳送給已選擇不接收您訊息的使用者。
新增至集區的每個電話號碼的組態，必須與建立集區時指定的第一個電話號碼的組態相符。假設您建立的集區包含了已啟用雙向傳訊功能的電話號碼，那麼您也必須為加入集區的其他號碼啟用雙向傳訊功能。
您也可以將 AWS RCS 代理程式新增為集區中的起始身分，以及電話號碼和寄件者 IDs。當 AWS RCS 代理程式位於集區中時，集區會啟用自動 RCS-to-SMS 備用 – 如果 RCS 交付失敗，服務會使用相同集區中的另一個起始身分，透過 SMS 自動重試訊息。如需使用集區設定 RCS 備用的詳細資訊，請參閱 [使用電話集區的 RCS 到 SMS 備用](rcs-sms-fallback.md)。
**Topics**
+ [建立電話集區](phone-pool-create.md)
+ [新增電話號碼或寄件者 ID](phone-pool-add-number.md)
+ [檢視所有電話集區](phone-pool-list.md)
+ [刪除電話集區](phone-pool-delete.md)
+ [變更集區的選擇退出清單](phone-pool-manage-opt-out-list.md)
+ [更新共用路由](phone-pool-shared-routes.md)
+ [使用電話集區刪除保護](phone-pool-deletion-protection.md)
+ [管理電話集區的標籤](phone-pool-tags.md)
+ [列出共用電話集區](phone-pool-shared.md)
+ [
# 在集區中管理 AWS RCS 代理程式
](phone-pool-rcs-agents.md)
# 在 AWS 最終使用者簡訊 SMS 中建立電話集區
當您建立新的電話集區時，它會繼承新增的第一個電話號碼或寄件者 ID 的所有設定。例如，如果您建立集區，且新增的第一個電話號碼已啟用雙向傳訊，則您新增至集區的其他電話號碼也必須啟用雙向傳訊。
------
#### [ Create a phone pool (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台建立集區，請遵循下列步驟：
**建立集區 （主控台）**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇**建立電話集區**。
1. 在**集區設定**區段下，針對**集區名稱**輸入集區的名稱。
1. 請選擇下列其中一個選項：
+ **電話號碼** – 在**可用於關聯的電話號碼**區段中，選擇要與集區建立關聯的電話號碼。
+ **模擬器號碼 **（選用） – 如果您沒有任何電話號碼並想要請求模擬器電話號碼，請在**可用於關聯的電話號碼**區段中選擇**電話號碼**和 ，執行下列動作：
+ 選擇**請求模擬器號碼**。
+ 在**請求模擬器號碼**中，從下拉式清單中選擇您的國家/地區。
+ 選擇**請求號碼**。
+ 在**可用於關聯的電話號碼**中，選擇新的模擬器電話號碼。
+ **寄件者 ID** – 在**可用於關聯的寄件者 IDs**區段中，選擇要與集區建立關聯的寄件者 ID。
1. （選用） 展開**標籤**，然後選擇**新增標籤**。
1. 輸入新的空白金鑰/值對。
1. （選用） 選擇**新增標籤**以新增另一個標籤。
1. 選擇**建立電話集區**。
------
#### [ Create a phone pool (AWS CLI) ]
您可以使用 [create-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-pool.html) 命令來建立新的集區。
使用 `RequestPhoneNumber` API 購買電話號碼時，也可以將電話號碼加入集區。如需詳細資訊，請參閱[在 AWS 最終使用者簡訊簡訊中請求電話號碼](phone-numbers-request.md)。
**使用 建立集區 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 create-pool \
> --origination-identity originationIdentity \
> --iso-country-code XX \
> --message-type TRANSACTIONAL
```
在上述命令中，進行下列變更：
+ 將 *originationIdentity* 替換成要新增到集區的電話號碼或寄件者 ID 的唯一 ID 或 Amazon Resource Name (ARN)。
**提示**
您可以使用 [describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html) 操作來尋找電話號碼的 ID 和 ARN。您可以使用 [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html) 操作來尋找寄件者 ID 的 ID 和 ARN。
+ 將 *XX* 取代為 *originationIdentity* 國家/地區的 ISO-3166 alpha-2 識別符。
+ 如果您要使用集區傳送行銷或促銷訊息，請將 *TRANSACTIONAL* 替換成 `PROMOTIONAL`。否則，請使用 `TRANSACTIONAL`。
------
# 將電話號碼或寄件者 ID 新增至電話集區
請依照這些指示，將電話號碼或寄件者 ID 新增至電話集區。您新增至集區的每個電話號碼或寄件者 ID 的組態，必須符合電話集區的組態。例如，如果您建立集區，且新增的第一個電話號碼已啟用雙向傳訊，則您新增至集區的其他電話號碼也必須啟用雙向傳訊。
------
#### [ Add a phone number or sender ID to a pool (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台將電話號碼或寄件者 ID 新增至集區，請遵循下列步驟：
**新增電話號碼或寄件者 ID （主控台）**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇要新增起始身分的電話集區。
1. 在**關聯的集區原始伺服器**索引標籤上，選擇**新增原始伺服器**。
1. 請選擇下列其中一個選項：
+ **電話號碼** – 如果您選擇此選項，請在**可用於關聯的電話號碼**區段下，執行下列動作：
+ 選擇要新增至電話集區的電話號碼。
+ **寄件者 ID** – 如果您選擇此選項，請在**可用於關聯的寄件者 IDs**區段下，執行下列動作：
+ 選擇寄件者 ID 以新增電話集區。
1. 選擇**將原始伺服器新增至集區**。
------
#### [ Add a phone number or sender ID to a pool (AWS CLI) ]
您可以使用 [associate-origination-identity](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/associate-origination-identity.html) CLI，將電話號碼或寄件者 IDs 新增至現有的集區。
您新增至集區的每個電話號碼或寄件者 ID 的組態，必須符合您在建立集區時指定的第一個電話號碼或寄件者 ID 的組態。假設您建立的集區包含了已啟用雙向傳訊功能的電話號碼，那麼您也必須為加入集區的其他號碼啟用雙向傳訊功能。
**使用 將電話號碼或寄件者 ID 新增至集區 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 associate-origination-identity \
> --pool-id poolId \
> --origination-identity originationIdentity \
> --iso-country-code US
```
在上述命令中，進行下列變更：
+ 將 *poolId* 替換成您要新增起始身分的集區的 ID 或 Amazon Resource Name (ARN)。
+ 將 *originationIdentity* 替換成要新增到集區的電話號碼或寄件者 ID 的唯一 ID 或 Amazon Resource Name (ARN)。
+ 將 *\$112065550142* 替換成您要加入集區的起始身分。此值可以是短碼、電話號碼或寄件者 ID。
+ 將 *US* 替換成起始身分所在國家/地區的 ISO-3166 兩位字母代碼。
------
#### [ List origination identities (AWS CLI) ]
您可以使用 [list-pool-origination-identities](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-pool-origination-identities.html) CLI 來檢視已新增至特定集區的所有起始身分的相關資訊。
**使用 檢視集區中的起始 IDs 清單 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 list-pool-origination-identities \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
在上述命令中，將 *poolId* 取代為集區的 ID 或 Amazon Resource Name (ARN)。
------
# 檢視 AWS 最終使用者簡訊簡訊中的所有電話集區
您可以使用 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI 來檢視現有集區的相關資訊。
此操作可以提供 AWS 最終使用者簡訊 SMS 帳戶中所有集區的完整清單、特定集區的相關資訊，或根據您定義的條件篩選的集區清單。
**使用 擷取所有集區的清單 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools
```
若要尋找特定集區的相關資訊，請使用 `PoolId` 參數。
**使用 取得特定集區的相關資訊 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --pool-id poolId
```
在上述命令中，將 *poolId* 取代為集區的 ID 或 Amazon Resource Name (ARN)。
若要查看已篩選的集區清單，請使用 `Filters` 參數。您可以使用以下篩選條件值：
+ `status` – 集區目前的狀態，例如 `ACTIVE`。
+ `message-type` – 集區用於傳送的訊息類型。可能的值為 `TRANSACTIONAL` 或 `PROMOTIONAL`。
+ `two-way-enabled` – 布林值，顯示是否為集區中的號碼啟用了雙向簡訊。
+ `self-managed-opt-outs-enabled` – 布林值，顯示是否為集區中的號碼啟用了自我管理選擇不接收 SMS。
+ `opt-out-list-name` – 與集區相關聯的選擇不接收清單的名稱。
+ `shared-routes-enabled` – 布林值，顯示是否為集區啟用共用路由。
+ `deletion-protection-enabled` – 布林值，顯示是否可以使用 `DeletePhoneNumber` 操作刪除電話號碼。
假設您要檢視支援雙向傳訊的交易訊息集區清單，請在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --filters Name=message-type,Values=TRANSACTIONAL \
> --filters Name=two-way-enabled,Values=true
```
# 刪除 AWS 最終使用者簡訊簡訊中的電話集區
在刪除集區之前，您需要關閉**刪除保護**，並從電話集區中移除除一個外的所有原始伺服器。如需如何停用刪除保護的詳細資訊，請參閱 [在 AWS 最終使用者簡訊簡訊中使用電話集區刪除保護](phone-pool-deletion-protection.md)。與集區相關聯的電話號碼和寄件者 IDs 會保留在您的 AWS 最終使用者傳訊簡訊帳戶中。
------
#### [ Delete a phone pool (Console) ]
您必須先關閉刪除保護，並從電話集區中移除所有原始伺服器，才能刪除集區。若要使用 AWS 最終使用者簡訊 SMS 主控台刪除集區，請遵循下列步驟：
**刪除集區 （主控台）**
1. 在 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 開啟 AWS 最終使用者傳訊簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇要刪除的集區。
1. 選擇 **刪除**。
1. 輸入 **release** ，然後**確認**以刪除集區。
------
#### [ Delete a phone pool (AWS CLI) ]
您必須先關閉刪除保護，並從電話集區中移除所有原始伺服器，才能刪除集區。您可以使用 [delete-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-pool.html) API 來刪除集區。
**使用 刪除集區 AWS CLI**
+ 若要刪除集區，請在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 delete-pool \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
在上述命令中，將 *pool-78ec067f62f94d57bd3bab991example* 替換成集區的唯一 ID 或 Amazon Resource Name (ARN)。您可以使用 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) 操作來尋找這兩個值。
------
# 在 AWS 最終使用者傳訊簡訊中變更集區的選擇退出清單
選擇*不接收清單*是目的地電話號碼的清單，不應將訊息傳送給他們。傳送 SMS 訊息時，如果目的地身分使用關鍵字 STOP 回覆您的起始號碼 (除非您啟用自我管理選擇不接收選項)，系統會將目的地身分自動加入選擇不接收清單。如果您嘗試將訊息傳送至選擇不接收清單上的目的地號碼，且選擇不接收清單與用來傳送訊息的集區相關聯， AWS 則最終使用者簡訊簡訊不會嘗試傳送訊息。
根據預設，建立集區時，會將其指派給*預設*選擇退出清單。集區可以共用相同的選擇退出清單。當您變更集區選擇不接收清單時，任何先前選擇不接收的收件人可能不在新清單中，並開始接收訊息。如需從選擇退出清單中新增或移除目的地電話號碼的詳細資訊，請參閱 [將目的地電話號碼新增至 AWS 最終使用者簡訊 SMS 中的選擇退出清單](opt-out-list-add-phone-number.md)。
------
#### [ Change opt-out list (Console) ]
若要使用 AWS 最終使用者簡訊 SMS 主控台變更選擇不接收清單，請遵循下列步驟：
**變更選擇退出清單**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇集區。
1. 在**選擇退出清單**索引標籤上，選擇**編輯設定**。
+ **建立新的選擇退出清單** – 建立新的空白選擇退出清單，並輸入易記的名稱。
+ **選擇現有的選擇不接收清單** – 從下拉式清單中選擇先前建立的不接收清單。
1. （選用） 若要啟用自我管理選擇退出，請選擇**啟用自我管理選擇退出**。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ Change opt-out list (AWS CLI) ]
您可以使用 [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) 命令來變更集區使用的選擇退出清單。
在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 update-pool --pool-id poolid --opt-out-list-name OptOutListName
```
在上述命令中，進行下列變更：
+ 以*集區的 poolID 或 Amazon Resource Name (ARN) 取代 poolid*。 poolID
+ 將 *OptOutListName* 取代為 Amazon Resource Name (ARN) 或選擇退出清單名稱。
------
# 在 AWS 最終使用者簡訊簡訊中更新共用路由
在某些國家/地區， AWS 最終使用者傳訊簡訊會維護共用來源身分的集區。當您啟用共用路由時， AWS 最終使用者傳訊簡訊會努力使用其中一個共用身分來傳遞您的訊息。起始身分可以是寄件者 ID、長碼或短碼，而且在每個國家/地區中可能有所不同。當共用路由使用寄件者 ID 做為起始身分時，寄件者 ID 將是一般寄件者 ID，例如 `NOTICE`。共用身分在某些國家/地區不可用，包括美國。
**注意**
共用路由可能會受到增加的下游篩選影響，而且在可用的情況下，偏好使用專用路由。
**開啟共用路由 (AWS 管理主控台)**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇將啟用共用路由的集區。
1. 在**共用路由**索引標籤上，選擇**編輯設定**按鈕。
1. 選擇**啟用共用路由**，然後選擇**儲存變更**。
# 在 AWS 最終使用者簡訊簡訊中使用電話集區刪除保護
當您開啟刪除保護時，您將無法刪除集區，直到停用刪除保護為止。預設會停用刪除保護。
**啟用刪除保護 （主控台）**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇將啟用刪除的電話集區。
1. 在**刪除保護**索引標籤上，選擇**編輯設定**。
1. 選擇**啟用刪除保護**，然後選擇**儲存變更**。
# 管理電話集區的 AWS 最終使用者簡訊 SMS 標籤
標籤是一組金鑰和值，您可以選擇性地套用到您的 AWS 資源，以控制存取或使用。編輯名稱索引鍵/值對的值，以變更集區的名稱。
------
#### [ Manage tags (Console) ]
使用 AWS 最終使用者簡訊 SMS 主控台來新增或編輯集區中的標籤。
**管理標籤 （主控台）**
1. 開啟位於 https：//[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) 的 AWS 終端使用者簡訊主控台。
1. 在導覽窗格中的**組態**下，選擇**電話集區**。
1. 在**電話集**區頁面上，選擇要新增標籤的電話集區。
1. 在 **Tags** (標籤) 索引標籤上，選擇 **Manage tags** (管理標籤)。
+ **新增標籤** – 在**管理標籤**中，選擇**新增標籤**以建立新的空白金鑰/值對。
+ **刪除標籤** – 在**管理標籤**中，選擇鍵/值對旁的**移除**。
+ **編輯標籤** – 在**管理標籤**中，選擇**金鑰**或**值**並編輯文字。
1. 選擇 **Save changes** (儲存變更)。
------
#### [ Manage tags (AWS CLI) ]
使用 新增 AWS CLI 或編輯標籤。
```
$ aws pinpoint-sms-voice-v2 tag-resource \
--resource-arn resource-arn \
--tags tags={key1=value1,key2=value2}
```
在上述範例中，執行下列動作：
+ 將 *resource-arn* 取代為您要新增標籤的 Amazon Resource Name (ARN)。
+ 將 *key1* 和 *key2* 替換成您要加入資源的標籤的索引鍵。
+ 將 *value1* 和 *value2* 替換成您要為各索引鍵加入的標籤的值。
使用 AWS CLI 刪除標籤。
```
$ aws pinpoint-sms-voice-v2 untag-resource \
--resource-arn resource-arn \
--tag-keys tags={key1=value1,key2=value2}
```
在上述範例中，執行下列動作：
+ 將 *resource-arn* 取代為您要從中移除標籤的 Amazon Resource Name (ARN)。
+ 將 *key1* 和 *key2* 取代為您要移除之標籤的金鑰。
+ 將 *value1* 和 *value2* 取代為您要移除的標籤值。
------
# 使用 列出共用電話集區 AWS CLI
您可以使用 [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI 或 [AWS RAM 主控台](https://console.aws.amazon.com/ram)來檢視與您的帳戶共用之集區的相關資訊。如需共用資源的詳細資訊，請參閱 [在 AWS 最終使用者傳訊簡訊中使用共用資源](shared-resources.md)。
**使用 擷取與您共用的集區清單 AWS CLI**
+ 在命令列中輸入以下命令：
```
$ aws pinpoint-sms-voice-v2 describe-pools --owner SHARED
```
在上述命令中，將 *SHARED* 取代為 *SELF*，以列出您帳戶擁有的集區。
# 在集區中管理 AWS RCS 代理程式
您可以新增 AWS RCS 代理程式做為電話集區中的起始身分，以及 SMS 電話號碼。當集區同時包含 AWS RCS 代理程式和 SMS 電話號碼時， AWS 最終使用者傳訊會先嘗試 RCS 交付，並在無法進行 RCS 交付時自動回到 SMS。如需備用運作方式的詳細資訊，請參閱 [使用電話集區的 RCS 到 SMS 備用](rcs-sms-fallback.md)。
**注意**
當您將 AWS RCS 代理程式新增至集區時，請使用 `ZZ`做為 ISO 國家/地區碼。此`ZZ`程式碼表示 RCS 代理程式在集區層級不是國家/地區特定。國家特定路由是透過客服人員的國家/地區啟動註冊來處理。集區可以包含來自多個國家/地區的電話號碼，以及 RCS 代理程式。
ISO 國家/地區代碼會在集區建立時提供，但不會保留在集區上。如果您呼叫 `DescribePools`，ISO 國家/地區代碼不會出現在回應中。
## 使用 AWS RCS 代理程式建立集區
您可以使用 AWS 最終使用者傳訊主控台或 `CreatePool` API 建立新的集區，其中包含您的 AWS RCS 代理程式。
------
#### [ Console ]
**使用主控台建立具有 AWS RCS 代理程式的集區**
1. 開啟 AWS 最終使用者傳訊主控台。
1. 在導覽窗格中，選擇**電話集區**。
1. 選擇**建立集區**。
1. 針對**原始身分**，選取您的 AWS RCS 代理程式。集區會從您選取的起始身分繼承其組態。
1. 視需要設定集區設定，然後選擇**建立集區**。
1. 建立集區之後，請將您的 SMS 電話號碼新增至集區，以啟用 SMS 備用。集區中的所有起始身分都必須具有相符的組態。如需詳細資訊，請參閱[RCS 的集區組態需求](#phone-pool-rcs-config)。
------
#### [ AWS CLI ]
使用 `CreatePool` API 以您的 AWS RCS 代理程式做為初始起始身分來建立集區。建立集區時，請將 AWS RCS 代理程式 ARN 指定為起始身分。
下列範例使用 CLI AWS 建立集區：
```
aws pinpoint-sms-voice-v2 create-pool \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ \
--message-type TRANSACTIONAL
```
建立集區之後，請使用 `AssociateOriginationIdentity` API 將 SMS 電話號碼新增至集區以進行備用。
------
## 將 AWS RCS 代理程式新增至現有集區
如果您已有具有簡訊電話號碼的集區，您可以將 AWS RCS 代理程式新增至集區，以啟用具有簡訊備用功能的 RCS 訊息。您也可以將其他簡訊電話號碼新增至已包含 AWS RCS 代理程式的集區。
**重要**
將起始身分新增至現有集區之前，請確認集區的組態與您新增的身分相符。集區中的所有起始身分必須具有相同的中繼資料。如果不相符，操作會失敗並顯示 `ConflictException`。如需哪些欄位必須相符以及如何解決不相符的詳細資訊，請參閱 [RCS 的集區組態需求](#phone-pool-rcs-config)。
------
#### [ Console ]
使用主控台將 AWS RCS 代理程式新增至集區之前，請檢查集區的詳細資訊頁面，以檢閱其目前的組態。確認集區的訊息類型、ISO 國家/地區碼和其他設定與您要新增的 AWS RCS 代理程式相容。
**使用主控台將 AWS RCS 代理程式新增至現有集區**
1. 開啟 AWS 最終使用者傳訊主控台。
1. 在導覽窗格中，選擇**電話集區**。
1. 選擇您要新增 AWS RCS 代理程式的集區。
1. 在詳細資訊頁面上檢閱集區的組態。確認訊息類型和其他設定符合您要新增的 AWS RCS 代理程式。
1. 在**起始身分**區段中，選擇**新增起始身分**。
1. 從清單中選擇您的 AWS RCS 代理程式，然後選擇**新增**。
------
#### [ AWS CLI ]
使用 CLI 或 API 將 AWS RCS 代理程式新增至集區之前，請使用 `DescribePools` API 擷取集區目前的組態。確認集區的設定符合您要新增的 AWS RCS 代理程式。
下列範例會擷取集區詳細資訊：
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids pool-id
```
確認組態相符後，請使用 `AssociateOriginationIdentity` API 將 AWS RCS 代理程式新增至集區：
```
aws pinpoint-sms-voice-v2 associate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
------
## RCS 的集區組態需求
集區中的所有起始身分必須具有相同的中繼資料。當您將起始身分新增至集區時， AWS 最終使用者傳訊會將身分的組態與集區的現有組態進行比較。如果不相符，操作會失敗`ConflictException`，其中包含不同特定欄位的詳細資訊。
集區組態欄位分為兩個類別：建立集區時設定且無法變更的不可變欄位，以及您可以在建立後更新的可變欄位。
**不可變與可變集區組態欄位**
| 欄位 | 可變更性 | 備註 |
| --- | --- | --- |
| 訊息類型 | 固定 | 在集區建立時設定 。所有身分都必須相符。 |
| ISO 國家/地區代碼 | 固定 | 在集區建立時設定 。對於 AWS RCS 代理程式，值為 ZZ。集區可以包含來自多個國家/地區的電話號碼。 |
| 刪除保護 | Mutable | 可在建立後切換。必須在身分之間保持一致。 |
| 選擇不接收清單 | Mutable | 可以在建立後變更。必須在身分之間保持一致。 |
下列組態欄位必須符合集區中所有起始身分：
+ **訊息類型** — 必須針對相同的訊息類型設定所有身分 （例如 TRANSACTIONAL 或 PROMOTIONAL)。
+ **ISO 國家/地區代碼** — 在集區建立時設定。對於 AWS RCS 代理程式，請使用 `ZZ`做為 ISO 國家/地區碼。集區可以包含來自多個國家/地區的電話號碼。
+ **刪除保護** — 刪除保護設定必須跨身分保持一致。
+ **選擇退出清單** — 所有身分都必須與相同的選擇退出清單相關聯，否則這些身分都不應有選擇退出清單。
### 了解 ConflictException 錯誤
當您嘗試將起始身分新增至集區，且組態不相符時， `AssociateOriginationIdentity`或 `CreatePool` API 會傳回 `ConflictException`。例外狀況訊息包含有關哪些欄位在身分和集區之間不同的詳細資訊。
例如，如果您嘗試將針對 PROMOTIONAL 訊息設定的電話號碼新增至針對 TRANSACTIONAL 訊息設定的集區，錯誤訊息會指出訊息類型不相符。
若要解析 `ConflictException`：
1. 檢閱錯誤訊息以識別哪些欄位不同。
1. 更新起始身分或集區組態，讓欄位相符。
1. 重試 `AssociateOriginationIdentity`或 `CreatePool`操作。
**注意**
如果您無法解決組態不相符的問題，請考慮為起始身分建立單獨的集區。每個集區都可以有自己的組態，而且您可以針對不同的使用案例使用不同的集區。
## 從集區移除 AWS RCS 代理程式
您可以使用 AWS 最終使用者傳訊主控台或 `DisassociateOriginationIdentity` API，從集區中移除 AWS RCS 代理程式。從集區移除 AWS RCS 代理程式會停用透過該集區傳送之訊息的 RCS 交付。移除代理程式後傳送到集區的訊息只會透過 SMS 傳遞 （使用集區中剩餘的電話號碼）。
------
#### [ Console ]
**使用主控台從集區移除 AWS RCS 代理程式**
1. 開啟 AWS 最終使用者傳訊主控台。
1. 在導覽窗格中，選擇**電話集區**。
1. 選擇包含您要移除之 AWS RCS 代理程式的集區。
1. 在**起始身分**區段中，選取 AWS RCS 代理程式。
1. 選擇**移除**，然後確認移除。
------
#### [ AWS CLI ]
使用 `DisassociateOriginationIdentity` API 從集區中移除 AWS RCS 代理程式：
```
aws pinpoint-sms-voice-v2 disassociate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
移除 AWS RCS 代理程式後，透過集區傳送的訊息只會透過 SMS 傳送。若要重新啟用 RCS 交付，請使用 `AssociateOriginationIdentity` API 將 AWS RCS 代理程式新增至集區。
------