View a markdown version of this page

Prueba de mensajes RCS - AWS SMS de mensajería para el usuario final
¿Qué es un agente de pruebas?Añadir dispositivos de pruebaFlujo de invitaciones para probadoresVisualización de los dispositivos de pruebaEnvío de mensajes de pruebaProbando el respaldo de SMSSolución de problemas de las pruebas de RCS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Prueba de mensajes RCS

Antes de lanzar la mensajería RCS en producción, puede probar la integración mediante un agente de pruebas. El agente de pruebas es un ID de RCS for Business que se crea al enviar un registro de prueba para su agente de RCS de AWS. Proporciona un acceso completo a la API idéntico al de producción, pero restringe la entrega de mensajes únicamente a los dispositivos de prueba registrados. No se necesita la aprobación del transportista para realizar las pruebas.

Este capítulo se centra en el propio agente de pruebas, incluida la forma de gestionar los dispositivos de prueba y la forma de solucionar problemas comunes. Para ver un step-by-step tutorial sobre cómo crear su primer agente de AWS RCS y enviar un mensaje de prueba, consulte. Cómo empezar con RCS Para obtener más información sobre la creación de un agente de AWS RCS y el envío de un registro de prueba, consulteAdministrar los agentes de RCS.

importante

Los mensajes de prueba se cobran según las tarifas de RCS estándar. El agente de pruebas proporciona un entorno de pruebas para validar la integración, pero el envío de mensajes a los dispositivos de prueba conlleva los mismos gastos que los mensajes de producción.

¿Qué es un agente de pruebas?

Un agente de pruebas es un ID de RCS for Business que AWS End User Messaging crea al enviar un registro de prueba para su agente de RCS de AWS. El agente de pruebas le permite:

  • Enviar mensajes RCS a dispositivos de prueba registrados sin la aprobación del operador

  • Usa la SendTextMessage API para enviar mensajes de prueba, la misma API que usas en producción

  • Configure grupos, conjuntos de configuraciones, listas de exclusión, palabras clave y otras funciones de mensajería para el usuario AWS final para su flujo de trabajo de pruebas

  • Pruebe la mensajería bidireccional enviando mensajes con palabras clave de respuesta automática

  • Pruebe el comportamiento alternativo de los SMS con o sin un número de teléfono SMS aprobado

Los dispositivos de prueba que registre para un agente de pruebas funcionan en todos los países para ese agente de AWS RCS. No necesita registrar los dispositivos de prueba por separado para cada país. Por el contrario, el agente de pruebas puede enviar mensajes a los dispositivos de prueba de cualquier país, independientemente de si has presentado un registro de lanzamiento nacional para ese país.

Añadir dispositivos de prueba

Antes de poder enviar mensajes RCS de prueba, debe registrar uno o más dispositivos de prueba como números de destino verificados. Puede añadir dispositivos de prueba mediante la consola de mensajería para el usuario AWS final o la CreateVerifiedDestinationNumber API.

Console

En la consola, los dispositivos de prueba se añaden como parte del flujo de trabajo de creación de AWS RCS Agent. Para obtener instrucciones sobre step-by-step la consola, consultePaso 2: Añadir un dispositivo de prueba.

AWS CLI

Utilice el create-verified-destination-number comando con el --rcs-agent-id parámetro para registrar un dispositivo de prueba para su agente RCS de AWS:

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
nota

El parámetro --origination-identity no es obligatorio. Cuando lo especifique--rcs-agent-id, el comando registrará el número de teléfono para realizar las pruebas de RCS con ese agente. Si lo omites --rcs-agent-id y lo usas --origination-identity en su lugar, el comando envía un SMS OTP para su verificación por SMS. Los dos parámetros se excluyen mutuamente.

Flujo de invitaciones para probadores

Tras añadir un dispositivo de prueba, AWS End User Messaging envía una invitación al probador desde un agente de RCS denominado RBM Tester Management. La invitación contiene botones para aceptar o rechazar. Para obtener más información sobre el flujo de invitaciones a los evaluadores, incluido el requisito de espera de 120 segundos y el comportamiento específico de iOS, consulte. Paso 2: Añadir un dispositivo de prueba

Visualización de los dispositivos de prueba

Puede ver los dispositivos de prueba registrados para su agente RCS de AWS mediante la consola de mensajería para el usuario AWS final o la DescribeVerifiedDestinationNumbers API.

Console

Para ver los dispositivos de prueba registrados en la consola, vaya a la página de detalles de su agente de AWS RCS y seleccione la pestaña Pruebas. La pestaña muestra todos los números de destino verificados asociados al agente, incluidos su estado de verificación y su número de teléfono.

AWS CLI

Utilice el describe-verified-destination-numbers comando para enumerar los dispositivos de prueba para su agente RCS de AWS. Utilice el --filters parámetro with rcs-agent-id para mostrar solo los dispositivos de prueba de RCS:

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

Los dispositivos de prueba que registre para un agente de pruebas funcionan a nivel mundial para ese agente de AWS RCS. Un dispositivo de prueba registrado en una AWS región puede recibir mensajes de prueba enviados desde cualquier AWS región en la que esté disponible su agente de AWS RCS.

Envío de mensajes de prueba

Una vez que el dispositivo de prueba haya aceptado la invitación del probador, puede enviarle mensajes RCS. Puede enviar mensajes de prueba mediante la consola de mensajería para el usuario AWS final o la SendTextMessage API.

Console
Para enviar un mensaje de prueba mediante la consola

  1. Abra la consola de mensajería para el usuario AWS final.

  2. En el panel de navegación, en Configuraciones, elija los agentes de RCS.

  3. Elija el agente de AWS RCS que desee probar.

  4. Elija la pestaña Pruebas.

  5. En la sección Enviar mensaje de prueba, selecciona un dispositivo de prueba verificado de la lista.

  6. Introduce el texto del mensaje.

  7. Elija Enviar mensaje de prueba.

AWS CLI

Usa el send-text-message comando para enviar un mensaje de prueba a un número de destino verificado. Especifique el ARN del agente RCS de AWS como identidad de origen:

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!"

Probando el respaldo de SMS

Puedes probar el comportamiento alternativo de los SMS para comprobar que tus mensajes se entregan por SMS cuando no es posible entregarlos por RCS. Para obtener instrucciones completas sobre cómo probar el sistema alternativo de SMS, incluidas las pruebas sin un número de SMS aprobado y todo el proceso, consulte end-to-end. Probando el sistema alternativo de SMS

Solución de problemas de las pruebas de RCS

En las siguientes secciones se describen los problemas más comunes que pueden surgir al probar los mensajes de RCS y cómo resolverlos.

El dispositivo de prueba no recibe mensajes RCS

Si el dispositivo de prueba no recibe mensajes RCS, compruebe lo siguiente:

  • Compruebe que el dispositivo de prueba ha aceptado la invitación del probador. Utilice la DescribeVerifiedDestinationNumbers API con el rcs-agent-id filtro para comprobar el estado de verificación del dispositivo.

  • Compruebe que el dispositivo de prueba tenga el RCS activado. En Android, comprueba la configuración de la aplicación de mensajería para ver las funciones de RCS o Chat. En el iPhone, RCS requiere iOS 18 o posterior.

  • Comprueba que el dispositivo de prueba tenga una conexión de datos activa. Los mensajes RCS se envían a través de datos, no a través del canal SMS.

  • Compruebe que los envía al número de teléfono correcto en formato E.164.

El mensaje se entrega como SMS en lugar de RCS

Si el mensaje de prueba se entrega como SMS en lugar de como RCS, compruebe lo siguiente:

  • Compruebe que envía el mensaje mediante el ARN del agente RCS de AWS o un grupo que contenga el agente RCS de AWS como identidad de origen. Si especifica solo un número de teléfono SMS, el mensaje se envía por SMS.

  • Compruebe que el dispositivo de prueba ha aceptado la invitación del probador y está registrado como número de destino verificado para el agente de AWS RCS correcto.

  • Compruebe el evento de entrega para determinar si el mensaje se intentó enviar inicialmente a través de RCS y volvió a convertirse en SMS, o si se envió directamente a través de SMS.

No se ha recibido la invitación del evaluador

Si un dispositivo de prueba no recibe la invitación del probador, compruebe lo siguiente:

  • La invitación del probador puede tardar hasta 20 minutos en llegar después de añadir un dispositivo de prueba. Si la invitación no ha llegado después de 20 minutos, retira el dispositivo de prueba y vuelve a añadirlo.

  • Compruebe que el número de teléfono tiene el formato E.164 correcto y es un número de teléfono válido.

  • Compruebe que el dispositivo de prueba tenga una conexión de datos activa y que el RCS esté activado.

iOS: invitación a probar en remitentes desconocidos

En los dispositivos iOS (iPhone con iOS 18 o posterior), la invitación del evaluador de RBM Tester Management puede filtrarse a la carpeta Remitentes desconocidos de la aplicación Mensajes. Este es el comportamiento predeterminado de iOS para los mensajes de contactos desconocidos.

Para encontrar la invitación:

Para buscar la invitación del probador en iOS

  1. Abre la aplicación Mensajes en el iPhone.

  2. Pulsa Filtros en la esquina superior izquierda (o desliza el dedo hacia la derecha desde la lista de mensajes).

  3. Pulsa Remitentes desconocidos.

  4. Busque el mensaje de RBM Tester Management y pulse Convertir en probador para aceptar la invitación.