View a markdown version of this page

Mensajes de RCS de pruebas - AWS Mensajería SMS para el usuario final
¿Qué es un agente de pruebas?Añadir dispositivos de pruebaFlujo de invitaciones a los probadoresVisualización de los dispositivos de pruebaEnvío de mensajes de pruebaProbando la alternativa de SMSSolución de problemas en 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.

Mensajes de RCS de pruebas

Antes de lanzar la mensajería RCS en producción, puede probar la integración con un agente de pruebas. El agente de prueba es un identificador de RCS for Business que se crea al enviar un registro de prueba para su agente de AWS RCS. 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 agente de prueba en sí, e incluye cómo administrar los dispositivos de prueba y cómo solucionar problemas comunes. Para ver un tutorial paso a paso sobre cómo crear su primer agente de AWS RCS y enviar un mensaje de prueba, consulte. Introducción a RCS Para obtener más información sobre la creación de un agente RCS de AWS y el envío de un registro de prueba, consulte. Administración de agentes de RCS

importante

Los mensajes de prueba se cobran según las tarifas estándar de RCS. El agente de pruebas proporciona un entorno de pruebas para validar la integración, pero la entrega 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 identificador de RCS for Business que la mensajería de usuario AWS final crea cuando envía un registro de prueba para su agente de AWS RCS. El agente de pruebas le permite:

  • Enviar mensajes de RCS a los 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 voluntaria, palabras clave y otras funciones de mensajería de 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 que hayas presentado un registro de lanzamiento para ese país.

Añadir dispositivos de prueba

Para poder enviar mensajes de RCS de prueba, debe registrar uno o más dispositivos de prueba como números de destino verificados. Puede agregar 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 administran en la subpestaña de administración del probador de RBM, dentro de la pestaña de pruebas de su agente de AWS RCS. Para obtener instrucciones paso a paso sobre la consola, consulte. Paso 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 de AWS RCS:

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 especifica--rcs-agent-id, el comando registra el número de teléfono para realizar las pruebas de RCS con ese agente. Si se omite --rcs-agent-id y se usa --origination-identity en su lugar, el comando envía un SMS OTP para la verificación por SMS. Los dos parámetros se excluyen mutuamente.

Flujo de invitaciones a los probadores

Después de añadir un dispositivo de prueba, AWS End User Messaging envía una invitación a los evaluadores desde un agente de RCS llamado 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, incluidos el requisito de espera de 120 segundos y el OS-specific comportamiento de los usuarios, 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 de AWS RCS 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. Seleccione la subpestaña de administración de RBM Tester para ver 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 de su agente de AWS RCS. Utilice el --filters parámetro con 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 los mensajes de prueba enviados desde cualquier AWS región en la que esté disponible su agente de RCS de AWS.

Envío de mensajes de prueba

Cuando un dispositivo de prueba haya aceptado la invitación del probador, puedes enviarle mensajes de 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 RCS de AWS que quiera probar.

  4. Elija la pestaña Pruebas.

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

  6. Ingresa 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 la alternativa de SMS

Puede probar el comportamiento alternativo de los SMS para comprobar que los mensajes se entregan por SMS cuando no es posible entregarlos mediante 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 el flujo completo de principio a fin, consulte. Probando la alternativa de SMS

Solución de problemas en las pruebas de RCS

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

El dispositivo de prueba no recibe mensajes de RCS

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

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

  • Verifique que el dispositivo de prueba tenga habilitado el RCS. 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 una versión posterior.

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

  • Compruebe que está enviando al número de teléfono correcto en el E.164 formato.

El mensaje se entregó como SMS en lugar de RCS

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

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

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

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

No se recibió la invitación del probador

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

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

  • Comprueba que el número de teléfono esté en el E.164 formato correcto y que sea un número de teléfono móvil válido.

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

iOS: invitación para probar en Unknown Senders

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

Para buscar la invitación:

Para encontrar 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 evaluador para aceptar la invitación.