View a markdown version of this page

Testar mensagens RCS - AWS Mensagens SMS para o usuário final
O que é um agente de teste?Adicionar dispositivos de testeFluxo de convites para testadoresVisualizando dispositivos de testeEnviando mensagens de testeTestando o fallback de SMSSolução de problemas no teste 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á.

Testar mensagens RCS

Antes de iniciar o envio 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 agente do AWS RCS. Ele fornece acesso completo à API idêntico ao da produção, mas restringe a entrega de mensagens somente aos dispositivos de teste registrados. Nenhuma aprovação da operadora é 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 passo a passo sobre como criar seu primeiro agente do AWS RCS e enviar uma mensagem de teste, consulte. Conceitos básicos do RCS Para obter detalhes sobre como criar um agente do AWS RCS e enviar um registro de teste, consulte. Gerenciar agentes RCS

Importante

As mensagens de teste são cobradas de acordo com as taxas RCS padrão. 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 agente do AWS RCS. 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 grupos, conjuntos de configurações, listas de exclusão, palavras-chave e outros recursos de mensagens do 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 alternativo de SMS com ou sem um número de telefone SMS aprovado

Os dispositivos de teste que você registra para um agente de teste funcionam em todos os países para esse agente do AWS RCS. 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 no país em questão.

Adicionar 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 de mensagens do usuário AWS final ou a CreateVerifiedDestinationNumber API.

Console

No console, os dispositivos de teste são gerenciados na subguia de gerenciamento de testadores do RBM na guia Testes do seu agente AWS RCS. Para obter instruções detalhadas do console, consulte. Etapa 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 agente do AWS RCS:

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 testes 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 convite do testador, incluindo o requisito de espera de 120 segundos e o OS-specific comportamento do i, consulte. Etapa 2: adicionar um dispositivo de teste

Visualizando dispositivos de teste

Você pode visualizar os dispositivos de teste registrados para seu agente do AWS RCS usando o console de mensagens do usuário AWS final ou a DescribeVerifiedDestinationNumbers API.

Console

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

AWS CLI

Use o describe-verified-destination-numbers comando para listar dispositivos de teste para seu agente do AWS RCS. Use o --filters parâmetro with rcs-agent-id para mostrar somente os 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 agente do AWS RCS. Um dispositivo de teste registrado em uma AWS região pode receber mensagens de teste enviadas de qualquer AWS região em que seu agente do AWS RCS esteja disponível.

Enviando 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 de mensagens do usuário AWS final ou a SendTextMessage API.

Console
Para enviar uma mensagem de teste usando o console

  1. Abra o console de mensagens do usuário AWS final.

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

  3. Escolha o agente do AWS RCS 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 agente AWS RCS 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 alternativo 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 recurso de SMS, incluindo testes sem um número de SMS aprovado e o fluxo completo de ponta a ponta, consulte. Testando o fallback de SMS

Solução de problemas no teste 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 seu 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 os recursos 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 meio de dados, não pelo canal SMS.

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

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 AWS RCS Agent ARN 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 agente correto do AWS RCS.

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

O convite do testador não foi 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 E.164 formato 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 testadores 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 Tornar-me um testador para aceitar o convite.