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, consulteFallback de RCS para SMS usando pools telefônicos.
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ê ligarDescribePools, 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.
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 umConflictException. Para obter detalhes sobre quais campos devem corresponder e como resolver incompatibilidades, consulteRequisitos de configuração de pool para RCS.
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.
| 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
ZZcomo 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 umConflictException:
-
Revise a mensagem de erro para identificar quais campos são diferentes.
-
Atualize a identidade de origem ou a configuração do pool para que os campos correspondam.
-
Tente novamente a
CreatePooloperaçãoAssociateOriginationIdentityor.
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).
