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á.
# Começando com o RCS
Este guia explica como configurar seu primeiro agente RCS no AWS End User Messaging e enviar e receber sua primeira mensagem RCS. No final, você terá um ambiente de teste RCS funcional. Tempo estimado para conclusão: 15 a 30 minutos.
Aqui está o que este guia aborda:
1. Crie um AWS RCS Agent e envie um registro de teste
1. Adicione um dispositivo de teste e aceite o convite do testador
1. Envie sua primeira mensagem RCS de saída
1. Teste mensagens de entrada (bidirecionais) com palavras-chave
Para obter informações sobre como o RCS funciona em mensagens de usuário AWS final, incluindo o modelo de identidade de dois níveis (AWS RCS Agent e RCS for Business IDs), consulte. [O que é RCS?](rcs-overview.md)
## Configurando e testando o RCS
Esta seção orienta você na criação de um AWS RCS Agent, no registro de um dispositivo de teste, no envio da primeira mensagem RCS e na verificação da entrega. Depois de concluir essas etapas, você pode prosseguir com o lançamento do RCS nos países de produção.
### Pré-requisitos
Antes de começar, você deve ter o seguinte:
+ **Uma AWS conta com acesso AWS ao End User Messaging** — Você precisa de uma AWS conta com permissões para usar o AWS End User Messaging. Se você não tiver uma conta, consulte o [guia de configuração da AWS conta](https://docs.aws.amazon.com/accounts/latest/reference/welcome-first-time-user.html).
+ **Um telefone com RCS ativado** — Você precisa de um telefone Android com mensagens RCS habilitado no aplicativo de mensagens padrão ou de um iPhone com iOS 18 ou posterior. Este telefone serve como seu dispositivo de teste para receber mensagens RCS.
+ **(Opcional) AWS CLI configurada** — Se você quiser testar usando a API em vez do console, instale e configure a AWS CLI ou use um AWS SDK como boto3 para Python.
### Etapa 1: Crie seu AWS RCS Agent e envie um registro de teste
A primeira etapa é criar um AWS RCS Agent e enviar um registro de teste. O registro de teste cria um RCS for Business ID (agente de teste) que você pode usar para enviar mensagens para dispositivos de teste registrados sem a aprovação da operadora.
Para obter detalhes completos sobre o gerenciamento de agentes do AWS RCS, incluindo o ciclo de vida do agente e as operações de API, consulte. [Gerenciando agentes RCS](rcs-agents.md)
#### Criação de um AWS RCS Agent (console)
**Para criar um AWS RCS Agent e enviar um registro de teste**
1. Abra o [console AWS End User Messaging](https://console.aws.amazon.com/sms-voice/home).
1. No painel de navegação, em **Configurações**, escolha Agentes **RCS**.
1. Escolha **Criar agente RCS**. Isso cria um AWS RCS Agent e, em seguida, orienta você imediatamente na criação de um registro de teste em um único fluxo de trabalho.
1. A próxima tela mostra uma introdução ao RCS e explica o processo de configuração. Revise as informações e escolha **Avançar** para continuar.
1. Na página **Detalhes do agente**, defina o seguinte:
+ **Nome amigável** — Um rótulo exclusivo para console para seu AWS RCS Agent. Esse é um nome interno para sua referência (armazenado como uma tag) e não é o nome exibido nos telefones dos destinatários. O nome amigável não está disponível por meio da API.
+ **Proteção contra exclusão** — (Opcional) Habilite para evitar a exclusão acidental do agente.
+ **Tags** — (Opcional) Adicione tags para organizar e identificar seu agente.
1. Na seção **Informações da marca** da mesma página, insira o seguinte:
+ **Nome de exibição** — O nome da marca que os destinatários veem ao lado de suas mensagens RCS.
+ **Descrição** — Uma breve descrição da sua marca ou empresa.
+ **Caso de uso** — Selecione o caso de uso principal para suas mensagens RCS (por exemplo, notificações transacionais, marketing ou suporte ao cliente).
1. Na seção **Ativos de marca** da mesma página, faça o upload do seguinte:
+ **Logotipo** — 224 × 224 pixels, PNG com transparência, abaixo de 50 KB.
+ **Imagem do banner** — 1440 × 448 pixels, PNG ou JPEG, com menos de 200 KB.
+ **Cor da marca** — Um código de cor hexadecimal (por exemplo,`#1A73E8`) com uma taxa de contraste mínima de 4,5:1 contra um fundo branco.
**Importante**
Alguns ativos da marca não podem ser alterados depois que o agente é enviado para registro. Prepare seus ativos finais de marca antes de criar o agente. Se quiser experimentar primeiro, você pode criar rapidamente um agente de teste usando esse fluxo e, em seguida, criar um novo agente do AWS RCS com ativos de marca finalizados posteriormente.
1. Na página **Palavras-chave de conformidade**, configure suas palavras-chave e mensagens de resposta automática.
1. Na página **Revisar**, verifique todas as suas configurações.
1. Escolha **Validar e enviar** para criar o AWS RCS Agent e enviar o registro de teste.
**nota**
Você criou com sucesso um AWS RCS Agent e enviou um registro de teste. Seu agente de teste normalmente é aprovado em minutos. Agora vamos ativar as mensagens de teste para o seu dispositivo.
#### Criação de um AWS RCS Agent (CLI)
Você também pode criar um AWS RCS Agent usando a AWS CLI. Primeiro, crie o agente e, em seguida, envie um registro de teste.
Etapa 1: Crie o AWS RCS Agent:
```
aws pinpoint-sms-voice-v2 create-rcs-agent \
--deletion-protection-enabled
```
Etapa 2: envie um registro de teste para o agente. Use a `CreateRegistration` API com o tipo de registro para testes de RCS. Você pode usar a `DescribeRegistrationFieldDefinitions` API para recuperar programaticamente todos os campos disponíveis do formulário de registro antes de enviá-lo. Forneça os ativos, a descrição e os detalhes de contato da sua marca como parte dos campos do formulário de registro.
Para obter detalhes sobre a API de registro, consulte[Gerenciando agentes RCS](rcs-agents.md).
### Etapa 2: adicionar um dispositivo de teste
Depois que seu registro de teste for aprovado, adicione seu telefone como um dispositivo de teste para que você possa receber mensagens RCS do seu agente de teste.
**nota**
Depois de adicionar um dispositivo de teste, o convite do testador não é enviado imediatamente. O sistema atrasa a ativação por pelo menos 120 segundos e pode levar até 20 minutos para que o convite chegue. O console mostra um tempo aproximado de ativação. Você não precisa esperar antes de adicionar o dispositivo — o sistema lida com o atraso automaticamente.
------
#### [ Console ]
**Para adicionar um dispositivo de teste**
1. No console AWS End User Messaging, navegue até seu AWS RCS Agent e escolha a guia **Teste**.
1. Escolha **Adicionar dispositivo de teste**.
1. Insira o número de telefone do seu dispositivo de teste no formato E.164 (por exemplo,`+12065550100`).
1. Escolha **Adicionar**.
------
#### [ AWS CLI ]
Use a `CreateVerifiedDestinationNumber` API com o `--rcs-agent-id` parâmetro para registrar um dispositivo de teste para seu AWS RCS Agent:
```
aws pinpoint-sms-voice-v2 create-verified-destination-number \
--destination-phone-number +12065550100 \
--rcs-agent-id rcs-a1b2c3d4
```
------
Depois de adicionar o dispositivo de teste, o AWS End User Messaging envia um convite do testador para o número de telefone. **O convite vem de um agente do RCS chamado **RBM Tester Management** e contém dois botões para aceitar ou recusar: **Torne-me um** testador e Recusar.** O destinatário deve tocar em **Torne-me um testador** para concluir a verificação.
**nota**
Em dispositivos iOS (iPhone com iOS 18 ou posterior), o convite do testador pode aparecer na pasta **Remetentes desconhecidos** no aplicativo Mensagens, e não na caixa de entrada principal. Se você não ver o convite, verifique a pasta Remetentes desconhecidos.
Para obter mais detalhes sobre o gerenciamento de dispositivos de teste, incluindo a abordagem da API e a solução de problemas, consulte[Testando mensagens RCS](rcs-testing.md).
### Etapa 3: envie sua primeira mensagem RCS
Depois que seu dispositivo de teste aceitar o convite do testador, você poderá enviar sua primeira mensagem RCS. Você pode usar o console AWS End User Messaging ou a API.
------
#### [ Console ]
**Para enviar uma mensagem de teste usando o console**
1. No console AWS End User Messaging, navegue até seu AWS RCS Agent e escolha a guia **Teste**.
1. Escolha **Mensagens de teste de saída**. O console exibe uma prévia de como sua mensagem será renderizada no dispositivo do destinatário, junto com o corpo da solicitação JSON e o comando da CLI.
1. Escolha um dispositivo de teste verificado na lista.
1. Digite o texto da sua mensagem.
1. Escolha **Enviar mensagem de teste**.
**nota**
Opcionalmente, você pode definir um conjunto de configurações para eventos de mensagem. Os conjuntos de configurações permitem que você consuma recibos de entrega granulares (DLRs) e outros eventos de mensagens no destino do evento de sua escolha. Isso é opcional para testes, mas recomendado para uso em produção. Para obter detalhes, consulte [CloudWatch Métricas e monitoramento do RCS](rcs-monitoring.md).
------
#### [ AWS CLI ]
Use o `send-text-message` comando para enviar uma mensagem de teste. Especifique seu ARN do AWS RCS Agent como a identidade de origem:
```
aws pinpoint-sms-voice-v2 send-text-message \
--destination-phone-number +12065550100 \
--origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
--message-body "Hello from RCS! This is my first test message."
```
O `send-text-message` comando é o mesmo que você usa para SMS. Quando você especifica um ARN do AWS RCS Agent como a identidade de origem AWS , o End User Messaging entrega a mensagem via RCS.
------
### Etapa 4: testar mensagens de entrada (bidirecionais)
Você pode testar mensagens RCS de entrada configurando uma palavra-chave com uma resposta automática e enviando uma mensagem do seu dispositivo de teste que corresponda a essa palavra-chave.
**Para testar mensagens recebidas com palavras-chave de resposta automática**
1. No console AWS End User Messaging, navegue até seu AWS RCS Agent e configure uma palavra-chave. Por exemplo, defina a palavra-chave `RCSINBOUNDTESTING` com uma mensagem de resposta automática, como “Teste de entrada bem-sucedido\! Sua mensagem foi recebida.”
1. Na guia **Teste**, escolha **Link direto de entrada**.
1. No campo **Corpo da mensagem padrão**, insira a palavra-chave que você configurou (por exemplo,`RCSINBOUNDTESTING`).
1. Escolha **Gerar link**. O console gera uma URL de link direto de entrada usando o esquema de `sms:` URI padrão da GSMA. Esse link direto está incorporado ao código QR exibido na tela.
1. Digitalize o código QR com seu telefone testador verificado. Isso abre o aplicativo de mensagens nativo com uma mensagem pré-preenchida endereçada ao seu AWS RCS Agent.
1. Envie a mensagem do seu dispositivo de teste.
1. Verifique se você recebeu a mensagem de resposta automática em seu dispositivo de teste.
O teste de palavras-chave de resposta automática não exige a configuração de um destino de evento ou tópico do Amazon SNS. A resposta automática é gerenciada inteiramente pelo AWS End User Messaging com base na configuração de palavras-chave em seu AWS RCS Agent.
Para receber e processar mensagens de entrada arbitrárias (não apenas correspondências de palavras-chave), você precisa configurar um tópico do Amazon SNS para mensagens bidirecionais. Para obter detalhes, consulte [Recebendo mensagens RCS de entrada](rcs-inbound.md).
### O que você realizou
Ao concluir as etapas deste guia, você tem:
+ Criou um AWS RCS Agent com os ativos da sua marca e enviou um registro de teste
+ Registrou um dispositivo de teste e aceitou o convite do testador
+ Enviou sua primeira mensagem RCS e verificou a entrega
+ Mensagens de entrada testadas usando palavras-chave de resposta automática
Seu ambiente de teste agora está pronto. Aqui estão algumas maneiras de integrar as mensagens RCS em seu aplicativo ou ajustar como as mensagens RCS funcionam:
+ **Receba e processe mensagens de entrada**: configure um tópico do Amazon SNS para receber mensagens RCS de entrada e processá-las com funções Lambda. Consulte [Recebendo mensagens RCS de entrada](rcs-inbound.md).
+ **Rastreie eventos de entrega**: configure conjuntos de configurações para consumir recibos de entrega granulares (DLRs) e outros eventos de mensagem no destino do evento de sua escolha. Consulte [CloudWatch Métricas e monitoramento do RCS](rcs-monitoring.md).
+ **Habilite o retorno de SMS**: crie um pool telefônico com seu agente AWS RCS e números de telefone SMS para retornar automaticamente ao SMS quando a entrega do RCS não for possível. Consulte [Fallback de RCS para SMS usando pools telefônicos](rcs-sms-fallback.md).
+ **Lançamento nos países de produção**: envie os registros de lançamento do país para enviar mensagens RCS a todos os destinatários nos Estados Unidos da América e Canadá. Consulte [Lançamento do RCS em países](rcs-country-launch.md).
## Solicitação do agente de IA para configuração do RCS
Se você usa um assistente de codificação de IA generativo ou um agente de IA, pode usar a seguinte solicitação para obter ajuda para criar um agente do AWS RCS, enviar um registro de teste e enviar sua primeira mensagem de teste usando a CLI. AWS
**nota**
Copie o aviso a seguir e cole-o em seu agente de IA ou assistente de codificação:
```
## RCS Setup Assistant Prompt
Help me set up RCS messaging in AWS End User Messaging using the AWS CLI.
The service is `pinpoint-sms-voice-v2`. Walk me through each step with exact
CLI commands. Ask me for all required details before generating any commands.
**Important rules for generating commands:**
- All commands use the `pinpoint-sms-voice-v2` service.
- Use `create-rcs-agent` exactly as spelled — NOT `create-r-c-s-agent`.
- Use the term "testing" — NOT "sandbox".
- There is NO `describe-messages` API. Do not generate it.
- `create-rcs-agent` does NOT accept brand asset parameters (no display name,
no logo, no banner, no color). Brand assets are registration fields only.
- `create-verified-destination-number` uses `--rcs-agent-id`, NOT
`--origination-identity`.
### Step 1: Create an RCS Agent
Use `create-rcs-agent`. This creates the agent resource only.
Optional parameters: `--deletion-protection-enabled`, `--opt-out-list-name`,
`--tags`.
The response returns `RcsAgentId` and `RcsAgentArn` — save both.
### Step 2: Create and submit a testing registration
This configures brand assets and submits for approval. It requires multiple
API calls in sequence:
a. `create-registration --registration-type TEST_RCS_LAUNCH_REGISTRATION`
→ returns `RegistrationId`. Save it.
b. `create-registration-association --registration-id --resource-id `
→ links the registration to the agent.
c. Upload images as attachments (two calls):
`create-registration-attachment --attachment-body fileb://`
`create-registration-attachment --attachment-body fileb://`
→ each returns `RegistrationAttachmentId`. Save both.
d. Set ALL required registration fields using `put-registration-field-value`
with `--registration-id`, `--field-path`, and the appropriate value flag
(`--text-value`, `--select-choices`, or `--registration-attachment-id`).
Required fields (ALL must be set or registration will be DENIED):
- `agentDetails.brandName` (text, 2-65 chars)
- `agentDetails.serviceName` (text, 1-100 chars)
- `agentDetails.senderDisplayName` (text, 1-40 chars)
- `agentDetails.useCase` (select: OTP, TRANSACTIONAL, PROMOTIONAL, MULTI_USE)
- `agentDetails.agentDescription` (text, 1-100 chars)
- `agentDetails.logoImage` (attachment ID from step c, 224x224 PNG)
- `agentDetails.bannerImage` (attachment ID from step c, 1440x448 PNG/JPEG)
- `agentDetails.accentColor` (text, hex code e.g. #0066CC)
- `agentDetails.privacyPolicyUrl` (text, valid URL)
- `agentDetails.termsAndConditionsUrl` (text, valid URL)
- `agentDetails.averageMonthlyRcsFrequency` (select: 10, 100, 1000+)
- `agentDetails.monthlyRcsVolume` (text, 1-100000)
- At least ONE contact method WITH its label:
agentDetails.contactWebsite + agentDetails.contactWebsiteLabel, OR
agentDetails.contactPhoneNumber + agentDetails.contactPhoneLabel, OR
agentDetails.contactEmailAddress + agentDetails.contactEmailLabel
e. Verify all fields: `describe-registration-field-values --registration-id `
Any field showing `DeniedReason: MISSING_REQUIRED_FIELD` must be set.
f. Submit: `submit-registration-version --registration-id `
g. Poll status: `describe-registrations --registration-ids `
Wait for `RegistrationStatus: COMPLETE`.
**Error recovery:** If registration is DENIED, you must:
1. `create-registration-version --registration-id ` (creates new draft)
2. Re-populate ALL fields from scratch (new versions do NOT inherit values)
3. Fix the issue noted in `DeniedReasons`
4. Re-submit
### Step 3: Add a test device
**Prerequisite:** Step 2 must be COMPLETE and the agent's `TestingAgent.Status`
must be `ACTIVE` (check with `describe-rcs-agents`). Then wait at least 120
seconds after the agent becomes ACTIVE.
Use `create-verified-destination-number --destination-phone-number
--rcs-agent-id `.
The device status will be `PENDING`. The user must accept the RCS tester
invitation on their physical device. Check status with
`describe-verified-destination-numbers` — wait for `VERIFIED`.
### Step 4: Send a test RCS message
**Prerequisite:** Step 3 device must be `VERIFIED`.
Use `send-text-message --destination-phone-number
--origination-identity --message-body ""
--message-type TRANSACTIONAL`.
Returns `MessageId`.
### Step 5: Verify delivery
For testing: check the test device — the message appears from the branded
RCS agent.
For production monitoring: set up event destinations BEFORE sending messages
using `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event
destinations do not retroactively capture events for already-sent messages.
CloudWatch metrics in the `AWS/SMSVoice` namespace provide aggregate stats.
---
**Before generating commands, ask me for:**
- Brand name, service name, and sender display name
- Agent description (what the agent does, what messages users receive)
- Use case type: OTP, TRANSACTIONAL, PROMOTIONAL, or MULTI_USE
- Logo file path (224x224 PNG) and banner file path (1440x448 PNG/JPEG)
- Brand accent color hex code (e.g. #0066CC)
- Privacy policy URL and terms & conditions URL
- One contact method with label: website URL, phone number, or email
- Estimated monthly RCS volume and per-user message frequency
- Test device phone number in E.164 format (e.g. +12065550100)
```