As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciamento de agentes do AWS RCS em pools
Você pode adicionar um AWS RCS Agent como uma identidade de origem em um pool telefônico junto com seus números de telefone SMS. Quando um pool contém um AWS RCS Agent e números de telefone SMS, o AWS End User Messaging tenta primeiro a entrega do RCS e automaticamente retorna ao SMS se a entrega do RCS não for possível. Para obter detalhes sobre como o fallback funciona, consulte[Fallback de RCS para SMS usando pools telefônicos](rcs-sms-fallback.md).
**nota**
Ao adicionar um AWS RCS Agent a um pool, use `ZZ` como código ISO do país. O `ZZ` código indica que o agente RCS não é específico do país no nível do pool. O roteamento específico do país é feito por meio dos registros de lançamento do agente no país. Um pool pode conter números de telefone de vários países junto com o agente RCS.
O código ISO do país é fornecido no momento da criação do pool, mas não persiste no pool. Se você ligar`DescribePools`, o código ISO do país não aparecerá na resposta.
## Criação de um pool com um AWS RCS Agent
Você pode criar um novo pool que inclua seu AWS RCS Agent usando o console AWS End User Messaging ou a `CreatePool` API.
------
#### [ Console ]
**Para criar um pool com um AWS RCS Agent usando o console**
1. Abra o console AWS End User Messaging.
1. No painel de navegação, escolha **Pools de telefones**.
1. Selecione **Criar**.
1. Em **Identidade de origem**, selecione seu AWS RCS Agent. O pool herda sua configuração da identidade de origem que você selecionou.
1. Defina as configurações do pool conforme necessário e escolha **Criar pool**.
1. Depois que o pool for criado, adicione seus números de telefone SMS ao pool para ativar o recurso de SMS. Todas as identidades de origem no pool devem ter uma configuração correspondente. Para obter detalhes, consulte [Requisitos de configuração de pool para RCS](#phone-pool-rcs-config).
------
#### [ AWS CLI ]
Use a `CreatePool` API para criar um pool com seu AWS RCS Agent como a identidade de origem inicial. Especifique o ARN do AWS RCS Agent como a identidade de origem ao criar o pool.
O exemplo a seguir cria um pool usando a AWS CLI:
```
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
```
Depois que o pool for criado, use a `AssociateOriginationIdentity` API para adicionar números de telefone SMS ao pool para fins alternativos.
------
## Adicionar agentes do AWS RCS aos pools existentes
Se você já tem um pool com números de telefone SMS, você pode adicionar seu AWS RCS Agent ao pool para habilitar o envio de mensagens RCS com SMS fallback. Você também pode adicionar números de telefone SMS adicionais a um pool que já contém um AWS RCS Agent.
**Importante**
Antes de adicionar uma identidade de origem a um pool existente, verifique se a configuração do pool corresponde à identidade que você está adicionando. Todas as identidades de origem em um pool devem ter metadados idênticos. Se houver uma incompatibilidade, a operação falhará com um`ConflictException`. Para obter detalhes sobre quais campos devem corresponder e como resolver incompatibilidades, consulte[Requisitos de configuração de pool para RCS](#phone-pool-rcs-config).
------
#### [ Console ]
Antes de adicionar um AWS RCS Agent a um pool usando o console, inspecione a página de detalhes do pool para revisar sua configuração atual. Confirme se o tipo de mensagem do pool, o código ISO do país e outras configurações são compatíveis com o AWS RCS Agent que você deseja adicionar.
**Para adicionar um AWS RCS Agent a um pool existente usando o console**
1. Abra o console AWS End User Messaging.
1. No painel de navegação, escolha **Pools de telefones**.
1. Escolha o pool ao qual você deseja adicionar o AWS RCS Agent.
1. Revise a configuração do pool na página de detalhes. Confirme se o tipo de mensagem e outras configurações correspondem ao AWS RCS Agent que você deseja adicionar.
1. Na seção **Identidades de origem**, escolha **Adicionar identidade de origem**.
1. Selecione seu AWS RCS Agent na lista e escolha **Adicionar**.
------
#### [ AWS CLI ]
Antes de adicionar um AWS RCS Agent a um pool usando a CLI ou a API, use `DescribePools` a API para recuperar a configuração atual do pool. Verifique se as configurações do pool correspondem ao AWS RCS Agent que você deseja adicionar.
O exemplo a seguir recupera os detalhes do pool:
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids pool-id
```
Depois de confirmar as correspondências de configuração, use a `AssociateOriginationIdentity` API para adicionar o AWS RCS Agent ao pool:
```
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
```
------
## Requisitos de configuração de pool para RCS
Todas as identidades de origem em um pool devem ter metadados idênticos. Quando você adiciona uma identidade de origem a um pool, o AWS End User Messaging compara a configuração da identidade com a configuração existente do pool. Se houver uma incompatibilidade, a operação falhará com uma `ConflictException` que inclua detalhes sobre os campos específicos que diferem.
Os campos de configuração do pool se dividem em duas categorias: campos imutáveis que são definidos quando o pool é criado e não podem ser alterados e campos mutáveis que você pode atualizar após a criação.
**Campos de configuração de pool imutáveis versus mutáveis**
| Campo | Mutabilidade | Observações |
| --- | --- | --- |
| Tipo de mensagem | Imutável | Definido na criação do pool. Todas as identidades devem corresponder. |
| Código ISO do país | Imutável | Definido na criação do pool. Para agentes do AWS RCS, o valor éZZ. Os pools podem conter números de telefone de vários países. |
| Deletion protection (Proteção contra exclusão) | Mutable | Pode ser alternado após a criação. Deve ser consistente em todas as identidades. |
| Lista de cancelamento | Mutable | Pode ser alterado após a criação. Deve ser consistente em todas as identidades. |
Os seguintes campos de configuração devem corresponder a todas as identidades de origem em um pool:
+ **Tipo de mensagem** — Todas as identidades devem ser configuradas para o mesmo tipo de mensagem (por exemplo, TRANSACIONAL ou PROMOCIONAL).
+ **Código ISO do país** — Definido na criação do pool. Para agentes do AWS RCS, use `ZZ` como código ISO do país. Os pools podem conter números de telefone de vários países.
+ **Proteção contra exclusão** — A configuração de proteção contra exclusão deve ser consistente em todas as identidades.
+ **Lista de exclusão** — Todas as identidades devem estar associadas à mesma lista de exclusão, ou nenhuma delas deve ter uma lista de exclusão.
### Entendendo ConflictException os erros
Quando você tenta adicionar uma identidade de origem a um pool e a configuração não corresponde, a `CreatePool` API `AssociateOriginationIdentity` ou retorna a. `ConflictException` A mensagem de exceção inclui detalhes sobre quais campos diferem entre a identidade e o pool.
Por exemplo, se você tentar adicionar um número de telefone configurado para mensagens PROMOCIONAIS a um pool configurado para mensagens TRANSACIONAIS, a mensagem de erro indica que o tipo de mensagem não corresponde.
Para resolver um`ConflictException`:
1. Revise a mensagem de erro para identificar quais campos são diferentes.
1. Atualize a identidade de origem ou a configuração do pool para que os campos correspondam.
1. Tente novamente a `CreatePool` operação `AssociateOriginationIdentity` or.
**nota**
Se você não conseguir resolver a incompatibilidade de configuração, considere criar um pool separado para a identidade de origem. Cada pool pode ter sua própria configuração, e você pode usar diferentes pools para diferentes casos de uso.
## Removendo agentes do AWS RCS dos pools
Você pode remover um AWS RCS Agent de um pool usando o console AWS End User Messaging ou a `DisassociateOriginationIdentity` API. A remoção de um AWS RCS Agent de um pool desativa a entrega de RCS para mensagens enviadas por esse pool. As mensagens enviadas para o pool após a remoção do agente são entregues somente via SMS (usando os números de telefone restantes no pool).
------
#### [ Console ]
**Para remover um AWS RCS Agent de um pool usando o console**
1. Abra o console AWS End User Messaging.
1. No painel de navegação, escolha **Pools de telefones**.
1. Escolha o pool que contém o AWS RCS Agent que você deseja remover.
1. Na seção **Identidades de origem**, selecione o AWS RCS Agent.
1. Escolha **Remover** e confirme a remoção.
------
#### [ AWS CLI ]
Use a `DisassociateOriginationIdentity` API para remover um AWS RCS Agent de um pool:
```
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
```
Depois de remover o AWS RCS Agent, as mensagens enviadas pelo pool são entregues somente via SMS. Para reativar a entrega do RCS, adicione o AWS RCS Agent de volta ao pool usando a API. `AssociateOriginationIdentity`
------