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

# 在集區中管理 AWS RCS 代理程式
<a name="phone-pool-rcs-agents"></a>

您可以新增 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 代理程式建立集區
<a name="phone-pool-rcs-create"></a>

您可以使用 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 代理程式新增至現有集區
<a name="phone-pool-rcs-add"></a>

如果您已有具有簡訊電話號碼的集區，您可以將 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 的集區組態需求
<a name="phone-pool-rcs-config"></a>

集區中的所有起始身分必須具有相同的中繼資料。當您將起始身分新增至集區時， AWS 最終使用者傳訊會將身分的組態與集區的現有組態進行比較。如果不相符，操作會失敗`ConflictException`，其中包含不同特定欄位的詳細資訊。

集區組態欄位分為兩個類別：建立集區時設定且無法變更的不可變欄位，以及您可以在建立後更新的可變欄位。


**不可變與可變集區組態欄位**  

| 欄位 | 可變更性 | 備註 | 
| --- | --- | --- | 
| 訊息類型 | 固定 | 在集區建立時設定 。所有身分都必須相符。 | 
| ISO 國家/地區代碼 | 固定 | 在集區建立時設定 。對於 AWS RCS 代理程式，值為 ZZ。集區可以包含來自多個國家/地區的電話號碼。 | 
| 刪除保護 | Mutable | 可在建立後切換。必須在身分之間保持一致。 | 
| 選擇不接收清單 | Mutable | 可以在建立後變更。必須在身分之間保持一致。 | 

下列組態欄位必須符合集區中所有起始身分：
+ **訊息類型** — 必須針對相同的訊息類型設定所有身分 （例如 TRANSACTIONAL 或 PROMOTIONAL)。
+ **ISO 國家/地區代碼** — 在集區建立時設定。對於 AWS RCS 代理程式，請使用 `ZZ`做為 ISO 國家/地區碼。集區可以包含來自多個國家/地區的電話號碼。
+ **刪除保護** — 刪除保護設定必須跨身分保持一致。
+ **選擇退出清單** — 所有身分都必須與相同的選擇退出清單相關聯，否則這些身分都不應有選擇退出清單。

### 了解 ConflictException 錯誤
<a name="phone-pool-rcs-config-conflict"></a>

當您嘗試將起始身分新增至集區，且組態不相符時， `AssociateOriginationIdentity`或 `CreatePool` API 會傳回 `ConflictException`。例外狀況訊息包含有關哪些欄位在身分和集區之間不同的詳細資訊。

例如，如果您嘗試將針對 PROMOTIONAL 訊息設定的電話號碼新增至針對 TRANSACTIONAL 訊息設定的集區，錯誤訊息會指出訊息類型不相符。

若要解析 `ConflictException`：

1. 檢閱錯誤訊息以識別哪些欄位不同。

1. 更新起始身分或集區組態，讓欄位相符。

1. 重試 `AssociateOriginationIdentity`或 `CreatePool`操作。

**注意**  
如果您無法解決組態不相符的問題，請考慮為起始身分建立單獨的集區。每個集區都可以有自己的組態，而且您可以針對不同的使用案例使用不同的集區。

## 從集區移除 AWS RCS 代理程式
<a name="phone-pool-rcs-remove"></a>

您可以使用 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 代理程式新增至集區。

------