View a markdown version of this page

Testando mensagens RCS - AWS SMS de mensagens para o usuário final
O que é um agente de teste?Adicionando dispositivos de testeFluxo de convites para testadoresVisualizando dispositivos de testeEnvio de mensagens de testeTestando o fallback de SMSSolução de problemas de testes de RCS

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á.

Testando mensagens RCS

Antes de iniciar o sistema de mensagens RCS na produção, você pode testar sua integração usando um agente de teste. O agente de teste é um RCS for Business ID criado quando você envia um registro de teste para seu AWS RCS Agent. Ele fornece acesso total à API idêntico ao da produção, mas restringe a entrega de mensagens somente aos dispositivos de teste registrados. Nenhuma aprovação da transportadora é necessária para o teste.

Este capítulo se concentra no próprio agente de teste, incluindo como gerenciar dispositivos de teste e como solucionar problemas comuns. Para ver um step-by-step passo a passo sobre como criar seu primeiro AWS RCS Agent e enviar uma mensagem de teste, consulte. Começando com o RCS Para obter detalhes sobre como criar um AWS RCS Agent e enviar um registro de teste, consulte. Gerenciando agentes RCS

Importante

As mensagens de teste são cobradas de acordo com as taxas padrão de RCS. O agente de teste fornece um ambiente de teste para validar sua integração, mas a entrega de mensagens aos dispositivos de teste incorre nas mesmas cobranças que as mensagens de produção.

O que é um agente de teste?

Um agente de teste é um RCS for Business ID que o AWS End User Messaging cria quando você envia um registro de teste para seu AWS RCS Agent. O agente de teste permite que você:

  • Envie mensagens RCS para dispositivos de teste registrados sem a aprovação da operadora

  • Use a SendTextMessage API para enviar mensagens de teste, a mesma API que você usa na produção

  • Configure pools, conjuntos de configuração, listas de exclusão, palavras-chave e outros recursos de mensagens de usuário AWS final para seu fluxo de trabalho de teste

  • Teste mensagens bidirecionais enviando mensagens com palavras-chave de resposta automática

  • Teste o comportamento de fallback de SMS com ou sem um número de telefone SMS aprovado

Os dispositivos de teste que você registra como agente de teste funcionam em todos os países para esse AWS RCS Agent. Você não precisa registrar os dispositivos de teste separadamente para cada país. Por outro lado, o agente de teste pode enviar mensagens para dispositivos de teste em qualquer país, independentemente de você ter enviado um registro de lançamento de país para esse país.

Adicionando dispositivos de teste

Antes de enviar mensagens RCS de teste, você deve registrar um ou mais dispositivos de teste como números de destino verificados. Você pode adicionar dispositivos de teste usando o console AWS End User Messaging ou a CreateVerifiedDestinationNumber API.

Console

No console, dispositivos de teste são adicionados como parte do fluxo de trabalho de criação do AWS RCS Agent. Para obter instruções step-by-step do console, consulteEtapa 2: adicionar um dispositivo de teste.

AWS CLI

Use o create-verified-destination-number comando 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
nota

O parâmetro --origination-identity não é necessário. Quando você especifica--rcs-agent-id, o comando registra o número de telefone para o teste de RCS com esse agente. Quando você omite --rcs-agent-id e usa --origination-identity em vez disso, o comando envia um SMS OTP para verificação por SMS. Os dois parâmetros são mutuamente exclusivos.

Fluxo de convites para testadores

Depois de adicionar um dispositivo de teste, o AWS End User Messaging envia um convite de testador de um agente RCS chamado RBM Tester Management. O convite contém botões para aceitar ou recusar. Para obter detalhes sobre o fluxo de convites do testador, incluindo o requisito de espera de 120 segundos e o comportamento específico do iOS, consulte. Etapa 2: adicionar um dispositivo de teste

Visualizando dispositivos de teste

Você pode visualizar os dispositivos de teste registrados para seu AWS RCS Agent usando o console AWS End User Messaging ou a DescribeVerifiedDestinationNumbers API.

Console

Para visualizar seus dispositivos de teste registrados no console, navegue até a página de detalhes do seu AWS RCS Agent e escolha a guia Teste. A guia exibe todos os números de destino verificados associados ao agente, incluindo o status da verificação e o número de telefone.

AWS CLI

Use o describe-verified-destination-numbers comando para listar dispositivos de teste para seu AWS RCS Agent. Use o --filters parâmetro with rcs-agent-id para mostrar somente dispositivos de teste RCS:

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

Os dispositivos de teste que você registra para um agente de teste funcionam globalmente para esse AWS RCS Agent. Um dispositivo de teste registrado em uma AWS região pode receber mensagens de teste enviadas de qualquer AWS região em que seu AWS RCS Agent esteja disponível.

Envio de mensagens de teste

Depois que um dispositivo de teste aceitar o convite do testador, você poderá enviar mensagens RCS para ele. Você pode enviar mensagens de teste usando o console AWS End User Messaging ou a SendTextMessage API.

Console
Para enviar uma mensagem de teste usando o console

  1. Abra o console AWS End User Messaging.

  2. No painel de navegação, em Configurações, escolha Agentes RCS.

  3. Escolha o AWS RCS Agent que você deseja testar.

  4. Escolha a guia Teste.

  5. Na seção Enviar mensagem de teste, escolha um dispositivo de teste verificado na lista.

  6. Digite o texto da sua mensagem.

  7. Escolha Enviar mensagem de teste.

AWS CLI

Use o send-text-message comando para enviar uma mensagem de teste para um número de destino verificado. Especifique o 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 testing!"

Testando o fallback de SMS

Você pode testar o comportamento de fallback do SMS para verificar se suas mensagens são entregues via SMS quando a entrega do RCS não é possível. Para obter instruções completas sobre como testar o SMS fallback, incluindo testes sem um número de SMS aprovado e o end-to-end fluxo completo, consulteTestando o fallback de SMS.

Solução de problemas de testes de RCS

As seções a seguir descrevem problemas comuns que você pode encontrar ao testar mensagens RCS e como resolvê-los.

O dispositivo de teste não está recebendo mensagens RCS

Se o dispositivo de teste não estiver recebendo mensagens RCS, verifique o seguinte:

  • Verifique se o dispositivo de teste aceitou o convite do testador. Use a DescribeVerifiedDestinationNumbers API com o rcs-agent-id filtro para verificar o status de verificação do dispositivo.

  • Verifique se o dispositivo de teste tem o RCS ativado. No Android, verifique as configurações do aplicativo de mensagens para ver os recursos de RCS ou Chat. No iPhone, o RCS requer o iOS 18 ou posterior.

  • Verifique se o dispositivo de teste tem uma conexão de dados ativa. As mensagens RCS são entregues por dados, não pelo canal SMS.

  • Verifique se você está enviando para o número de telefone correto no formato E.164.

Mensagem entregue como SMS em vez de RCS

Se sua mensagem de teste for entregue como SMS em vez de RCS, verifique o seguinte:

  • Verifique se você está enviando a mensagem usando o ARN do AWS RCS Agent ou um pool que contém o AWS RCS Agent como identidade de origem. Se você especificar somente um número de telefone SMS, a mensagem será enviada por SMS.

  • Verifique se o dispositivo de teste aceitou o convite do testador e está registrado como um número de destino verificado para o AWS RCS Agent correto.

  • Verifique o evento de entrega para determinar se a mensagem foi inicialmente tentada via RCS e voltou para SMS ou se foi enviada diretamente via SMS.

Convite do testador não recebido

Se um dispositivo de teste não receber o convite do testador, verifique o seguinte:

  • O convite do testador pode levar até 20 minutos para chegar depois de adicionar um dispositivo de teste. Se o convite não chegar após 20 minutos, remova o dispositivo de teste e adicione-o novamente.

  • Verifique se o número de telefone está no formato E.164 correto e se é um número de celular válido.

  • Verifique se o dispositivo de teste tem uma conexão de dados ativa e se o RCS está ativado.

iOS: convite para testador em remetentes desconhecidos

Em dispositivos iOS (iPhone com iOS 18 ou posterior), o convite do testador do RBM Tester Management pode ser filtrado na pasta Remetentes Desconhecidos no aplicativo Mensagens. Esse é um comportamento padrão do iOS para mensagens de contatos desconhecidos.

Para encontrar o convite:

Para encontrar o convite do testador no iOS

  1. Abra o aplicativo Mensagens no iPhone.

  2. Toque em Filtros no canto superior esquerdo (ou deslize para a direita na lista de mensagens).

  3. Toque em Remetentes desconhecidos.

  4. Procure a mensagem RBM Tester Management e toque em Torne-me um testador para aceitar o convite.