View a markdown version of this page

Administrar los agentes de RCS - AWS SMS de mensajería para el usuario final
Descripción del agente RCS de AWSComprender el modelo de identidad de dos nivelesCreación de un agente RCS de AWSActualización de un agente de AWS RCSVisualización de los agentes RCS de AWSRevisar su agente de pruebasVisualización del estado de lanzamiento del paísEliminar un agente de AWS 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.

Administrar los agentes de RCS

Un agente de AWS RCS es el recurso de nivel superior en mensajería para usuarios AWS finales que representa su marca para la mensajería de RCS. Sirve como el recurso unificado que une a su agente de pruebas y a los agentes de lanzamiento nacionales (RCS for Business). IDs Las palabras clave y la configuración de mensajería bidireccional se definen en el agente RCS de AWS. Los activos de la marca se definen en cada registro (agente de pruebas o agente de lanzamiento nacional). Para obtener información general sobre la relación entre AWS RCS Agent y RCS for Business IDs, consulte. ¿Qué es RCS?

El agente RCS de AWS sigue este ciclo de vida:

  1. Cree el agente RCS de AWS.

  2. Agregue un agente de pruebas (incluido en el flujo de creación de la consola; opcional mediante CLI).

  3. Pruebe su mensajería RCS con dispositivos de prueba registrados. No se requiere la aprobación del transportista para realizar las pruebas.

  4. Envía un registro de lanzamiento por país para cada país al que quieras enviar mensajes de RCS de producción.

  5. Aprobado parcialmente: al menos un transportista ha aprobado a tu agente. Puedes empezar a enviar a los destinatarios a través de transportistas aprobados.

  6. Totalmente aprobado: todos los transportistas del país han aprobado a tu agente. Alcance total en ese país.

Un agente de AWS RCS se asigna a un agente de pruebas (un RCS for Business ID) más varios agentes de lanzamiento nacionales (un RCS for Business ID por país). Cuando crea un agente de AWS RCS en la consola, el flujo de trabajo lo guía inmediatamente para crear un agente de pruebas. A continuación, la configuración de marca del agente de pruebas se utiliza para rellenar previamente los formularios de registro de los lanzamientos nacionales, lo que reduce la duplicación de la entrada de datos.

Descripción del agente RCS de AWS

El agente de RCS de AWS es distinto del RCS for Business IDs que administra. En la siguiente tabla se resumen las diferencias:

Comparación entre AWS RCS Agent y RCS for Business ID
Atributo Agente RCS de AWS ID de RCS para empresas
Administrado por Usted, a través de la consola de mensajería para el usuario AWS final o la API AWS Mensajes para el usuario final, durante el proceso de registro
Alcance Uno por marca o por caso de uso Uno por lanzamiento en cada país, más un agente de pruebas
Configuración Nombre descriptivo, protección contra la eliminación, lista de exclusión, etiquetas, palabras clave, destino de mensajería bidireccional Los activos de la marca y otros ajustes definidos durante el registro
Identificador Formato rcs-a1b2c3d4 Administrado internamente por el proveedor de infraestructura de RCS

ID de agente y ARN

Cada agente RCS de AWS tiene un identificador único en el formato rcs-a1b2c3d4 (el prefijo rcs- seguido de una cadena hexadecimal). Este ID se utiliza al llamar a operaciones de API como UpdateRcsAgent y. DeleteRcsAgent

Cada agente de AWS RCS también tiene un ARN AWS de recurso en el siguiente formato:

arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id

Puede usar el ARN al especificar el agente RCS de AWS como identidad de origen en la SendTextMessage API o al agregar el agente a un grupo de teléfonos.

Estados del ciclo de vida

Un agente de AWS RCS pasa por los siguientes estados del ciclo de vida:

CREADO

El recurso AWS RCS Agent se creó en AWS End User Messaging, pero aún no se ha enviado ningún registro. Puede actualizar los activos y la configuración de la marca en este estado.

PENDING

Se ha enviado un registro y está pendiente de procesamiento. El agente aún no está disponible para enviar mensajes.

PROBANDO

Se ha aprobado el registro de las pruebas. El agente tiene un agente de pruebas (RCS for Business ID) y puede enviar mensajes a los dispositivos de prueba registrados. No se ha completado el registro de lanzamientos en ningún país.

PARCIALES

Se ha completado el registro de lanzamientos de al menos un país, pero no todos los lanzamientos nacionales enviados están activos. El agente puede enviar mensajes a los países en los que ha sido aprobado, pero solo a los destinatarios de los operadores específicos que han aprobado el agente. La CountryStatus opción correspondiente a un país pasa a PARTIAL tan pronto como haya al menos un operador de ese país activo.

ACTIVE

Todos los registros de lanzamientos de países enviados están completos y activos. El agente está en pleno funcionamiento en todos los países registrados. Tenga en cuenta que un agente ACTIVO puede volver al estado PARCIAL cuando se presenta el registro de lanzamiento de un nuevo país, ya que el nuevo país aún no está aprobado.

DELETED

Se ha eliminado el agente RCS de AWS. Todos los RCS for Business asociados IDs (agentes de pruebas y de lanzamiento nacionales) están desactivados. Esta acción no se puede deshacer.

Comprender el modelo de identidad de dos niveles

La RCS en la mensajería para usuarios AWS finales utiliza un modelo de identidad de dos niveles: el agente RCS de AWS y uno o más RCS for Business. IDs

Agente RCS de AWS

El agente RCS de AWS es el recurso de nivel superior que se crea y administra en AWS End User Messaging. Sirve como el recurso unificado que une a su agente de pruebas y a los agentes de lanzamiento nacionales. Las palabras clave y la configuración de mensajería bidireccional se definen en el agente RCS de AWS. Los activos de la marca se definen en cada registro. Cada agente RCS de AWS tiene un identificador único en el formato rcs-a1b2c3d4 y un ARN AWS de recurso. Piense en el AWS RCS Agent como la identidad unificada de su marca en todos los países en los que lance RCS.

ID de RCS para empresas

Un identificador de RCS for Business es la identidad de agente por país que se crea con el proveedor de infraestructura de RCS durante el proceso de registro. Cada lanzamiento en un país crea un identificador de RCS for Business independiente en su agente de AWS RCS. No administra RCS for Business directamente. IDs AWS La mensajería para el usuario final gestiona la creación y el ciclo de vida como parte del proceso de registro.

Un agente de AWS RCS puede tener los siguientes RCS for Business: IDs

  • Un agente de pruebas: un ID de RCS for Business creado durante la fase de registro de las pruebas. El agente de pruebas funciona con dispositivos de prueba registrados y le permite validar su integración con el RCS antes de ponerla en producción. Los mensajes de prueba se cobran según las tarifas estándar.

  • Agentes de lanzamiento en varios países: cada país en el que se lanza RCS crea un identificador de RCS for Business independiente. Por ejemplo, si realiza el lanzamiento en los Estados Unidos y Canadá, su agente de AWS RCS tiene dos agentes de lanzamiento en el país (un RCS de EE. UU. para Business ID y otro de RCS para Business ID de Canadá) además del agente de pruebas.

El siguiente diagrama muestra la relación entre estas identidades:


AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (US RCS for Business ID)
└── CA country launch agent (Canada RCS for Business ID)

Las palabras clave y los destinos de mensajería bidireccional se configuran en el agente de AWS RCS y se aplican a todos los RCS for Business asociados. IDs Los activos de la marca son específicos de cada registro (agente de pruebas o agente de lanzamiento nacional). El agente RCS de AWS también incluye ajustes a nivel de cuenta, como el nombre descriptivo, la protección contra eliminaciones y la lista de exclusión.

Creación de un agente RCS de AWS

Puede crear un agente de AWS RCS mediante la consola de mensajería para el usuario AWS final o la CreateRcsAgent API. Al crear un agente, debe introducir un nombre descriptivo en la consola (una etiqueta exclusiva para la consola que se guarda como etiqueta, que no se ve a través de la API ni se muestra en los teléfonos de los destinatarios) y se configuran ajustes opcionales, como la protección contra la eliminación y la asociación a listas de exclusión. Los activos de la marca se definen en el registro, no en el propio agente de AWS RCS.

Requisitos de activos de marca

Los activos de tu marca se muestran a los destinatarios junto con tus mensajes de RCS. Los recursos de la marca se envían como parte del registro de pruebas, que la consola presenta como una continuación del flujo de trabajo de creación de agentes. Se requieren los siguientes recursos para crear un agente de AWS RCS:

Logotipo

Una imagen cuadrada que representa tu marca. El logotipo aparece en la aplicación de mensajería junto a tus mensajes.

  • Dimensiones: 224 × 224 píxeles

  • Formato: PNG con transparencia

  • Tamaño máximo de archivo: 50 KB

Imagen de banner

Imagen ancha que aparece en la parte superior del perfil de su agente en la aplicación de mensajería. La imagen del encabezado solo se muestra en dispositivos Android.

  • Dimensiones: 1440 × 448 píxeles

  • Formato: PNG o JPEG

  • Tamaño máximo de archivo: 200 KB

Color de la marca

Un código de color hexadecimal (por ejemplo#1A73E8) utilizado como color de acento en la aplicación de mensajería. El color debe tener una relación de contraste mínima de 4, 5:1 sobre un fondo blanco para cumplir con los requisitos de accesibilidad. Si la relación de contraste no está configurada correctamente, es posible que su agente no esté aprobado.

importante

Los activos de marca tienen limitaciones en cuanto a los cambios una vez creado el agente. Algunos activos de la marca no se pueden modificar una vez que el agente se haya presentado para su registro. Prepare los activos finales de su marca antes de crear su agente de AWS RCS.

Console

La consola de mensajería para usuarios AWS finales presenta la creación y el registro de pruebas de AWS RCS Agent como un flujo de trabajo guiado único. Para obtener instrucciones sobre step-by-step la consola, consultePaso 1: Cree su agente RCS de AWS y envíe un registro de prueba.

AWS CLI

Utilice el create-rcs-agent comando para crear un agente RCS de AWS. Los activos de la marca (nombre para mostrar, descripción, logotipo, banner y color de la marca) no son parámetros de este comando. Se envían como campos de registro al crear un registro de prueba.

aws pinpoint-sms-voice-v2 create-rcs-agent \
    --deletion-protection-enabled

Están disponibles los siguientes parámetros opcionales:

  • --deletion-protection-enabled— Impide que se elimine el agente hasta que se desactive la protección contra la eliminación.

  • --opt-out-list-name— Asocia una lista de exclusión existente al agente.

  • --tags— Pares de valores clave para organizar e identificar su agente de AWS RCS.

Actualización de un agente de AWS RCS

Utilice la UpdateRcsAgent API para modificar la configuración de un agente RCS de AWS existente. Puede actualizar la siguiente configuración:

  • Protección contra la eliminación: habilita o deshabilita la protección contra la eliminación para el agente.

  • Lista de exclusión: asocie o desasocie una lista de exclusión al agente.

  • Destino de mensajería bidireccional: configure el tema de Amazon SNS y la función de IAM donde se entregan los mensajes entrantes. La mensajería bidireccional siempre está habilitada para RCS. A los clientes se les cobra por todos los mensajes RCS entrantes según las tarifas estándar. Esta configuración controla dónde se entregan los mensajes entrantes, no si se reciben.

nota

Los cambios en la configuración de AWS RCS Agent a través de la API están disponibles de forma inmediata. Sin embargo, el proveedor de infraestructura de RCS revisa las actualizaciones de los activos de la marca (campos de registro como el logotipo, el banner y el nombre para mostrar) y es posible que tarde un tiempo en aparecer en los dispositivos de los destinatarios. Para comprobar que los cambios de la API se han aplicado, utilice la DescribeRcsAgents API para confirmar la configuración actual del agente en AWS End User Messaging.

Visualización de los agentes RCS de AWS

Puede ver sus agentes de AWS RCS mediante la consola de mensajería para el usuario AWS final o la DescribeRcsAgents API.

Console

Para ver los agentes de AWS RCS en la consola, vaya a la página de agentes de RCS, en Configuraciones, en el panel de navegación. La página de lista muestra todos los agentes de AWS RCS de su cuenta, incluido su estado de ciclo de vida actual, su ID de agente y su nombre visible.

Elija un agente para ver sus detalles, incluidos los activos de la marca, los ajustes de configuración y los registros asociados.

AWS CLI

Utilice el describe-rcs-agents comando para enumerar todos los agentes de AWS RCS de su cuenta:

aws pinpoint-sms-voice-v2 describe-rcs-agents

Para recuperar los detalles de un agente específico, utilice el --rcs-agent-ids parámetro:

aws pinpoint-sms-voice-v2 describe-rcs-agents \
    --rcs-agent-ids rcs-a1b2c3d4

Revisar su agente de pruebas

Antes de enviar un registro de lanzamiento en un país, revisa la configuración del agente de pruebas para asegurarte de que los activos de tu marca, las palabras clave y la configuración de mensajería son correctos. El agente de pruebas sirve de modelo para los registros de lanzamientos nacionales, por lo que cualquier problema debe resolverse antes de continuar.

Para revisar su agente de pruebas, vaya a su agente de AWS RCS en la consola de mensajería para el usuario AWS final y seleccione la pestaña Registros. El registro de prueba muestra la configuración de su marca actual, que incluye el logotipo, la imagen del encabezado, el color de la marca y el nombre para mostrar tal y como aparecen en los dispositivos de los destinatarios.

También puedes usar la DescribeRegistrationFieldValues API para recuperar los valores de campo actuales para el registro de las pruebas de forma programática.

Visualización del estado de lanzamiento del país

Tras enviar el registro de lanzamiento de un país para su agente de AWS RCS, podrá realizar un seguimiento del estado de aprobación de cada transportista de ese país.

Console

Para ver el estado del lanzamiento por país en la consola, vaya a la página de detalles de su agente de AWS RCS y seleccione la pestaña Estado de lanzamiento por país. Esta pestaña muestra el estado de aprobación de cada transportista en cada país en el que haya presentado un registro de lanzamiento.

AWS CLI

Usa el describe-rcs-agent-country-launch-status comando para recuperar el estado de lanzamiento por transportista:

aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \
    --rcs-agent-id rcs-a1b2c3d4

La respuesta incluye el estado de aprobación de cada transportista en cada país en el que hayas presentado el registro de lanzamiento.

Cada transportista revisa y aprueba a tu agente de forma independiente. Su agente de AWS RCS puede enviar mensajes a un país en cuanto al menos un transportista de ese país haya aprobado al agente. No necesita esperar a que todos los transportistas lo aprueben para poder empezar a enviar mensajes de RCS. A medida que más transportistas aprueben a tu agente, tu alcance en ese país aumentará.

nota

Puedes solicitar el lanzamiento de más países desde la pantalla de estado del lanzamiento de un país. Cada lanzamiento en un nuevo país crea un registro independiente y pasa por su propio proceso de aprobación por parte del transportista.

Eliminar un agente de AWS RCS

Utilice la DeleteRcsAgent API para eliminar permanentemente un agente de AWS RCS. Al eliminar un agente, se desactivan todos los RCS for Business asociados IDs (incluidos el agente de pruebas y los agentes de lanzamiento de todos los países).

aviso

La eliminación de un agente de AWS RCS es permanente y no se puede deshacer. Se pierden todos los registros, los lanzamientos por países y las configuraciones de prueba asociadas al agente.

Antes de poder eliminar un agente de AWS RCS, primero debe eliminar todos los registros asociados (tanto los registros de prueba como los de lanzamiento por país) y, a continuación, deshabilitar la protección contra la eliminación. Si la protección contra la eliminación está habilitada, la DeleteRcsAgent API devuelve un error. Para deshabilitar la protección contra eliminaciones, usa la UpdateRcsAgent API con la protección contra eliminaciones configurada enfalse.

Para eliminar un agente de AWS RCS

  1. Si la protección contra eliminaciones está habilitada, desactívela llamando a la UpdateRcsAgent API con la protección contra eliminaciones configurada en. false

  2. Llame a la DeleteRcsAgent API con el ID de agente o el ARN del agente de AWS RCS que desee eliminar.

  3. Compruebe que el agente se ha eliminado llamando a la DescribeRcsAgents API. El agente debería dejar de aparecer en los resultados o su estado debería ser ELIMINADO.