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á. # Gerenciando agentes RCS Um AWS RCS Agent é o recurso de alto nível em mensagens de usuário AWS final que representa sua marca para mensagens RCS. Ele serve como o recurso unificado que une seu agente de teste e os agentes de lançamento do país (RCS for Business IDs). As palavras-chave e a configuração de mensagens bidirecionais são definidas no AWS RCS Agent. Os ativos da marca são definidos em cada registro (agente de teste ou agente de lançamento do país). Para obter uma visão geral de como o AWS RCS Agent se relaciona com o RCS for Business IDs, consulte. [O que é RCS?](rcs-overview.md) O AWS RCS Agent segue esse ciclo de vida: 1. **Crie** o AWS RCS Agent. 1. **Adicione um agente de teste** (incluído no fluxo de criação do console; opcional via CLI). 1. **Teste** suas mensagens RCS com dispositivos de teste registrados. Nenhuma aprovação da transportadora é necessária para o teste. 1. **Envie um registro de lançamento** de cada país para o qual você deseja enviar mensagens RCS de produção. 1. **Parcialmente aprovado**: pelo menos uma transportadora aprovou seu agente. Você pode começar a enviar para destinatários em transportadoras aprovadas. 1. **Totalmente aprovado**: todas as operadoras do país aprovaram seu agente. Alcance total naquele país. Um agente do AWS RCS é mapeado para um agente de teste (um RCS for Business ID) mais vários agentes de lançamento de países (um RCS for Business ID por país). Quando você cria um AWS RCS Agent no console, o fluxo de trabalho orienta você imediatamente a criar um agente de teste. A configuração da marca do agente de teste é então usada para preencher previamente os formulários de registro de lançamento do país, reduzindo a entrada duplicada de dados. **Topics** + [Entendendo o AWS RCS Agent](#rcs-agents-concept) + [Entendendo o modelo de identidade de dois níveis](#rcs-agents-identity-model) + [Criação de um AWS RCS Agent](#rcs-agents-create) + [Atualização de um AWS RCS Agent](#rcs-agents-update) + [Visualização de agentes do AWS RCS](#rcs-agents-view) + [Analisando seu agente de teste](#rcs-agents-review-test-agent) + [Visualizando o status de lançamento do país](#rcs-agents-country-launch-status) + [Excluindo um agente do AWS RCS](#rcs-agents-delete) ## Entendendo o AWS RCS Agent O AWS RCS Agent é diferente do RCS for Business IDs que ele gerencia. A tabela a seguir resume as diferenças: **AWS RCS Agent comparado ao RCS for Business ID** | Atributo | Agente AWS RCS | RCS para ID comercial | | --- | --- | --- | | Gerenciado por | Você, por meio do console de mensagens do usuário AWS final ou da API | AWS Mensagens para o usuário final, durante o processo de registro | | Escopo | Um por marca ou por caso de uso | Um lançamento por país, mais um agente de teste | | Configuração | Nome amigável, proteção contra exclusão, lista de exclusão, tags, palavras-chave, destino de mensagens bidirecionais | Ativos da marca e outras configurações definidas durante o registro | | Identificador | Formato de rcs-a1b2c3d4 | Gerenciado internamente pelo provedor de infraestrutura RCS | ### ID e ARN do agente Cada agente do AWS RCS tem um identificador exclusivo no formato `rcs-a1b2c3d4` (o prefixo `rcs-` seguido por uma string hexadecimal). Você usa esse ID ao chamar operações de API, como `UpdateRcsAgent` `DeleteRcsAgent` e. Cada agente do AWS RCS também tem um ARN de AWS recurso no seguinte formato: ``` arn:aws:sms-voice:{{region}}:{{account-id}}:rcs-agent/{{rcs-agent-id}} ``` Você pode usar o ARN ao especificar o AWS RCS Agent como uma identidade de origem na `SendTextMessage` API ou ao adicionar o agente a um pool telefônico. ### Estados do ciclo de vida Um agente do AWS RCS faz a transição pelos seguintes estados do ciclo de vida: **CRIADO** O recurso AWS RCS Agent foi criado no AWS End User Messaging, mas nenhum registro foi enviado ainda. Você pode atualizar os ativos e a configuração da marca nesse estado. **PENDING (PENDENTES)** Um registro foi enviado e está aguardando processamento. O agente ainda não está disponível para enviar mensagens. **TESTANDO** O registro do teste foi aprovado. O agente tem um agente de teste (RCS for Business ID) e pode enviar mensagens para dispositivos de teste registrados. Os registros de lançamento de nenhum país foram concluídos. **PARCIAL** Pelo menos um registro de lançamento em um país foi concluído, mas nem todos os lançamentos de países enviados estão ativos. O agente pode enviar mensagens nos países em que foi aprovado, mas somente para destinatários da (s) operadora (s) específica (s) que aprovaram o agente. O `CountryStatus` para um país passa para PARCIAL assim que pelo menos uma operadora nesse país estiver ativa. **ATIVO** Todos os registros de lançamento do país enviados estão completos e ativos. O agente está totalmente operacional em todos os países registrados. Observe que um agente ATIVO pode retornar ao status PARCIAL quando o registro de lançamento de um novo país é enviado, porque o novo país ainda não foi aprovado. **EXCLUÍDA** O AWS RCS Agent foi excluído. Todos os RCS for Business associados IDs (agentes de teste e lançamento no país) estão desativados. Esta ação não pode ser desfeita. ## Entendendo o modelo de identidade de dois níveis O RCS no AWS End User Messaging usa um modelo de identidade de dois níveis: o **AWS RCS Agent** e um ou mais **RCS** for Business. IDs **Agente AWS RCS** O AWS RCS Agent é o recurso de alto nível que você cria e gerencia no AWS End User Messaging. Ele serve como o recurso unificado que une seu agente de teste e os agentes de lançamento do país. As palavras-chave e a configuração de mensagens bidirecionais são definidas no AWS RCS Agent. Os ativos da marca são definidos em cada registro. Cada agente do AWS RCS tem um identificador exclusivo no formato `rcs-a1b2c3d4` e um ARN AWS de recurso. Pense no AWS RCS Agent como a identidade unificada da sua marca em todos os países em que você lança o RCS. **RCS para ID comercial** Um RCS for Business ID é a identidade do agente por país criada com o provedor de infraestrutura do RCS durante o processo de registro. Cada lançamento de país cria um RCS for Business ID separado em seu AWS RCS Agent. Você não gerencia o RCS for Business IDs diretamente. AWS O End User Messaging trata da criação e do ciclo de vida como parte do processo de registro. Um agente do AWS RCS pode ter o seguinte RCS for Business: IDs + **Um agente de teste** — um RCS for Business ID criado durante a fase de registro do teste. O agente de teste trabalha com dispositivos de teste registrados e permite que você valide sua integração com o RCS antes do lançamento na produção. As mensagens de teste são cobradas de acordo com as taxas padrão. + **Agentes de lançamento de vários** países — Cada país em que você lança o RCS cria um RCS separado para Business ID. Por exemplo, se você lançar nos Estados Unidos da América e no Canadá, seu agente do AWS RCS tem dois agentes de lançamento nacionais (um RCS dos EUA para ID comercial e um RCS do Canadá para ID comercial) além do agente de teste. O diagrama a seguir mostra a relação entre essas identidades: ``` AWS RCS Agent (rcs-a1b2c3d4) ├── Testing agent (RCS for Business ID) ├── US country launch agent (US RCS for Business ID) └── CA country launch agent (Canada RCS for Business ID) ``` Palavras-chave e destinos de mensagens bidirecionais são configurados no AWS RCS Agent e se aplicam a todos os RCS for Business associados. IDs Os ativos da marca são específicos para cada registro (agente de teste ou agente de lançamento do país). O AWS RCS Agent também mantém configurações em nível de conta, como nome amigável, proteção contra exclusão e lista de exclusão. ## Criação de um AWS RCS Agent Você pode criar um AWS RCS Agent usando o console AWS End User Messaging ou a `CreateRcsAgent` API. Ao criar um agente, você fornece um nome amigável no console (uma etiqueta somente para console armazenada como uma tag, não visível por meio da API ou exibida nos telefones dos destinatários) e define configurações opcionais, como proteção contra exclusão e associação à lista de exclusão. Os ativos da marca são definidos no registro, não no próprio AWS RCS Agent. ### Requisitos de ativos da marca Os ativos da sua marca são exibidos aos destinatários junto com suas mensagens RCS. Os ativos da marca são enviados como parte do registro de teste, que o console apresenta como uma continuação do fluxo de trabalho de criação do agente. Os seguintes ativos são necessários ao criar um agente do AWS RCS: **Logotipo** Uma imagem quadrada que representa sua marca. O logotipo aparece no aplicativo de mensagens ao lado de suas mensagens. + Dimensões: 224 × 224 pixels + Formato: PNG com transparência + Tamanho máximo do arquivo: 50 KB **Imagem do banner** Uma imagem ampla que aparece na parte superior do perfil do seu agente no aplicativo de mensagens. A imagem do banner só é exibida em dispositivos Android. + Dimensões: 1440 × 448 pixels + Formato: PNG ou JPEG + Tamanho máximo do arquivo: 200 KB **Cor da marca** Um código de cor hexadecimal (por exemplo,`#1A73E8`) usado como cor de destaque no aplicativo de mensagens. A cor deve ter uma taxa de contraste mínima de 4,5:1 contra um fundo branco para atender aos requisitos de acessibilidade. Se a taxa de contraste não estiver definida corretamente, seu agente pode não ser aprovado. **Importante** Os ativos da marca têm limitações nas mudanças após a criação do agente. Alguns ativos da marca não podem ser modificados depois que o agente é enviado para registro. Prepare seus ativos finais de marca antes de criar seu AWS RCS Agent. ------ #### [ Console ] O console AWS End User Messaging apresenta o registro de criação e teste do AWS RCS Agent como um único fluxo de trabalho guiado. Para obter instruções step-by-step do console, consulte[Etapa 1: Crie seu AWS RCS Agent e envie um registro de teste](rcs-getting-started.md#rcs-getting-started-create-agent). ------ #### [ AWS CLI ] Use o `create-rcs-agent` comando para criar um AWS RCS Agent. Os ativos da marca (nome de exibição, descrição, logotipo, banner e cor da marca) não são parâmetros desse comando. Eles são enviados como campos de registro quando você cria um registro de teste. ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` Os seguintes parâmetros opcionais estão disponíveis: + `--deletion-protection-enabled`— Impede que o agente seja excluído até que a proteção contra exclusão seja desativada. + `--opt-out-list-name`— Associa uma lista de exclusão existente ao agente. + `--tags`— Pares de valores-chave para organizar e identificar seu agente do AWS RCS. ------ ## Atualização de um AWS RCS Agent Use a `UpdateRcsAgent` API para modificar as configurações de um AWS RCS Agent existente. Você pode atualizar as seguintes configurações: + **Proteção contra exclusão** — Ative ou desative a proteção contra exclusão para o agente. + **Lista de exclusão** — Associe ou desassocie uma lista de exclusão com o agente. + **Destino bidirecional de mensagens** — Configure o tópico do Amazon SNS e a função do IAM em que as mensagens de entrada são entregues. As mensagens bidirecionais estão sempre habilitadas para o RCS. Os clientes são cobrados por todas as mensagens RCS recebidas com taxas padrão. Essa configuração controla onde as mensagens de entrada são entregues, não se elas são recebidas. **nota** As alterações nas configurações do AWS RCS Agent por meio da API estão disponíveis imediatamente. No entanto, as atualizações dos ativos da marca (campos de registro como logotipo, banner e nome de exibição) são analisadas pelo provedor de infraestrutura do RCS e podem levar algum tempo para aparecer nos dispositivos dos destinatários. Para verificar se suas alterações na API foram aplicadas, use a `DescribeRcsAgents` API para confirmar a configuração atual do agente no AWS End User Messaging. ## Visualização de agentes do AWS RCS Você pode visualizar seus agentes do AWS RCS usando o console AWS End User Messaging ou a `DescribeRcsAgents` API. ------ #### [ Console ] Para visualizar seus agentes do AWS RCS no console, navegue até a página de **agentes do RCS** em **Configurações** no painel de navegação. A página da lista exibe todos os agentes do AWS RCS em sua conta, incluindo o estado atual do ciclo de vida, ID do agente e nome de exibição. Escolha um agente para ver seus detalhes, incluindo ativos da marca, configurações e registros associados. ------ #### [ AWS CLI ] Use o `describe-rcs-agents` comando para listar todos os agentes do AWS RCS em sua conta: ``` aws pinpoint-sms-voice-v2 describe-rcs-agents ``` Para recuperar detalhes de um agente específico, use o `--rcs-agent-ids` parâmetro: ``` aws pinpoint-sms-voice-v2 describe-rcs-agents \ --rcs-agent-ids rcs-a1b2c3d4 ``` ------ ## Analisando seu agente de teste Antes de enviar um registro de lançamento no país, revise a configuração do seu agente de teste para garantir que os ativos de sua marca, palavras-chave e configurações de mensagens estejam corretos. O agente de teste serve como modelo para os registros de lançamento no país, portanto, qualquer problema deve ser resolvido antes de continuar. Para analisar seu agente de teste, navegue até seu AWS RCS Agent no console AWS End User Messaging e escolha a guia **Registros**. O registro do teste mostra a configuração atual da sua marca, incluindo o logotipo, a imagem do banner, a cor da marca e o nome de exibição conforme aparecem nos dispositivos dos destinatários. Você também pode usar a `DescribeRegistrationFieldValues` API para recuperar programaticamente os valores de campo atuais do seu registro de teste. ## Visualizando o status de lançamento do país Depois de enviar um registro de lançamento no país para seu agente do AWS RCS, você pode acompanhar o status de aprovação de cada operadora nesse país. ------ #### [ Console ] Para ver o status de lançamento do país no console, navegue até a página de detalhes do seu agente do AWS RCS e escolha a guia **Status de lançamento do país**. Essa guia exibe o status de aprovação de cada operadora em cada país para o qual você enviou um registro de lançamento. ------ #### [ AWS CLI ] Use o `describe-rcs-agent-country-launch-status` comando para recuperar o status de lançamento por operadora: ``` aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \ --rcs-agent-id rcs-a1b2c3d4 ``` A resposta inclui o status de aprovação de cada operadora em cada país para o qual você enviou um registro de lançamento. ------ Cada operadora analisa e aprova seu agente de forma independente. Seu agente do AWS RCS pode enviar mensagens em um país assim que pelo menos uma operadora desse país tiver aprovado o agente. Você não precisa esperar a aprovação de todas as operadoras antes de começar a enviar mensagens RCS. À medida que outras operadoras aprovam seu agente, seu alcance nesse país aumenta. **nota** Você pode solicitar lançamentos adicionais por país na tela de status de lançamento do país. Cada lançamento de um novo país cria um registro separado e passa pelo processo de aprovação de sua própria operadora. ## Excluindo um agente do AWS RCS Use a `DeleteRcsAgent` API para excluir permanentemente um AWS RCS Agent. Quando você exclui um agente, todos os RCS for Business associados IDs (incluindo o agente de teste e todos os agentes de lançamento do país) são desativados. **Atenção** A exclusão de um agente do AWS RCS é permanente e não pode ser desfeita. Todos os registros, lançamentos nacionais e configurações de teste associados ao agente são perdidos. Antes de excluir um AWS RCS Agent, você deve primeiro excluir todos os registros associados (tanto de teste quanto de lançamento no país) e, em seguida, desativar a proteção contra exclusão. Se a proteção contra exclusão estiver ativada, a `DeleteRcsAgent` API retornará um erro. Para desativar a proteção contra exclusão, use a `UpdateRcsAgent` API com a proteção contra exclusão definida como. `false` **Para excluir um AWS RCS Agent** 1. Se a proteção contra exclusão estiver ativada, desative-a chamando a `UpdateRcsAgent` API com a proteção contra exclusão definida como. `false` 1. Chame a `DeleteRcsAgent` API com o ID do agente ou ARN do AWS RCS Agent que você deseja excluir. 1. Verifique se o agente foi excluído chamando a `DescribeRcsAgents` API. O agente não deve mais aparecer nos resultados ou seu status deve ser EXCLUÍDO.