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.

eventos de mensajes RCS

Cuando envía mensajes RCS con mensajería para el usuario AWS final, la plataforma RCS genera eventos que informan sobre los cambios en el ciclo de vida de los mensajes, las interacciones de los destinatarios y los resultados a nivel del sistema. Estos eventos proporcionan señales más detalladas que los recibos de entrega por SMS tradicionales, ya que permiten saber en tiempo real si un mensaje se ha entregado, leído, caducado o ha vuelto a convertirse en SMS o MMS.

Los eventos de estado salientes (entrega, lectura, caducidad y respaldo) se envían a través de los destinos de eventos establecidos en la configuración. Los eventos de interacción entrantes (indicadores de escritura y toques de sugerencia) se envían al tema bidireccional de Amazon SNS que configure en su agente de RCS. Para configurar los destinos de los eventos, consulte. Destinos de eventos en los SMS de mensajería para usuarios AWS finales

Para obtener más información sobre los mensajes que generan estos eventos, consulteEnvío de mensajes RCS enriquecidos.

Campos comunes en los eventos de RCS

Todos los eventos de RCS, incluidos los eventos de estado de entrega, las confirmaciones de lectura y los eventos de interacción entrante, incluyen los siguientes campos que identifican al agente de RCS:

Estos campos están presentes en todos los eventos de RCS. No se incluyen en los eventos de SMS o MMS.

Eventos sobre el estado de la entrega

Los eventos de estado de entrega indican el estado del ciclo de vida de un mensaje RCS saliente. Estos eventos se utilizan para confirmar la entrega, activar una lógica alternativa o alertar al equipo de operaciones sobre infracciones de contenido.

Cada evento de estado saliente tiene un eventType de RCS_DELIVERED (y los tipos de eventos de estado de RCS relacionados) y un messageStatus campo que contiene uno de los siguientes valores:

El siguiente ejemplo muestra la carga útil de un evento de entrega:

{
    "eventType": "RCS_DELIVERED",
    "eventVersion": "1.0",
    "eventTimestamp": 1781661267660,
    "isFinal": true,
    "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60",
    "destinationPhoneNumber": "+13022640220",
    "isoCountryCode": "US",
    "isInternationalSend": false,
    "messageId": "test-sc1-004",
    "messageRequestTimestamp": 1781300397157,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "DELIVERED",
    "messageStatusDescription": "Message has been accepted by phone",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.007,
    "totalCarrierFee": 0.00494,
    "rcsMetadata": { "billingEventType": "RICH" },
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "US"
}

Lea los recibos

Un recibo leído indica que el destinatario ha abierto o visto el mensaje. Usa las confirmaciones de lectura para hacer un seguimiento de la participación y medir las tasas de lectura.

El evento de lectura utiliza un valor eventType de RCS_READ con messageStatus el READ siguiente valor:

{
    "eventType": "RCS_READ",
    "eventVersion": "1.0",
    "eventTimestamp": 1781661267203,
    "isFinal": true,
    "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60",
    "destinationPhoneNumber": "+13022640220",
    "isoCountryCode": "US",
    "isInternationalSend": false,
    "messageId": "test-sc1-004",
    "messageRequestTimestamp": 1781300397157,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "READ",
    "messageStatusDescription": "Message has been read by recipient",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.0,
    "totalCarrierFee": 0.0,
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "US"
}

Puedes calcular tu velocidad de lectura como el número de READ eventos dividido por el número de DELIVERED eventos multiplicado por 100.

Indicadores de escritura

Al escribir eventos indicadores, se indica que un participante está redactando un mensaje. Estos eventos fluyen en ambas direcciones:

El siguiente ejemplo muestra una notificación de escritura entrante:

{
    "originationNumber": "12679164820",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"type\":\"RCS_TYPING\",\"receivedAt\":\"2026-06-17T17:36:29.937+0000\"}",
    "inboundMessageId": "12679164820-2026-06-17T17:36:29.937+0000"
}

Eventos de caducidad del TTL

Cuando se establece un TimeToLive valor en un mensaje y el TTL caduca antes de que se entregue el mensaje, la plataforma RCS intenta revocar (eliminar) el mensaje. El resultado genera uno de los siguientes eventos:

Los eventos de caducidad del TTL se combinan con tu estrategia alternativa. Para obtener más información sobre la configuración de la caducidad de los mensajes, consulte. Configuración de la caducidad de los mensajes RCS

Eventos alternativos

Cuando no se puede entregar un mensaje RCS y la mensajería del usuario AWS final desencadena una reserva de SMS o MMS (ya sea mediante una configuración basada en un grupo o por mensajeFallbackConfiguration), el servicio genera eventos que indican el resultado de la reserva.

Los eventos de respaldo indican:

Supervise estos eventos para medir su tasa de respaldo e identificar los números de teléfono que requieren la entrega alternativa de manera constante. Para obtener más información sobre cómo configurar la opción alternativa por mensaje, consulte. Configuración del respaldo de SMS o MMS por mensaje

Eventos de toque de sugerencias (postback)

Cuando un destinatario elige una sugerencia (una respuesta sugerida o una acción sugerida), recibes un evento de devolución de mensajes que contiene la PostbackData cadena que configuraste en esa sugerencia. Usa los datos de devolución de datos para redirigir la lógica de la conversación, no el texto que se muestra.

La notificación messageBody contiene un objeto JSON con un type deSUGGESTION, la pantalla text y el postbackData que tú configuraste en la sugerencia:

{
    "originationNumber": "12679164820",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Open\",\"postbackData\":\"Open\"}",
    "inboundMessageId": "nIMYZGrBUILWng0Qck0deqVaAoTSJY5PsktKYOBYJhVaTsrdMdrs714e8SLZAjD3"
}

Para obtener más información sobre cómo configurar las sugerencias y sus datos de devolución de datos, consultaConfiguración de sugerencias de RCS.

Campos y eventos de precios conversacionales

Si registra a su agente de RCS para utilizar los precios conversacionales, AWS End User Messaging añade campos a los eventos entrantes y de entrega cuando un mensaje forma parte de una sesión de conversación activa y envía un CONVERSATION_STARTED evento cuando comienza la sesión. Para obtener una descripción general del modelo de precios conversacional, consulte. Precios conversacionales

Campos de conversación

Los siguientes campos aparecen en un evento entrante o de entrega solo cuando el mensaje forma parte de una sesión de conversación activa. Cuando el mensaje no forma parte de una conversación, la mensajería para el usuario AWS final omite estos campos por completo.

Cuando un mensaje forma parte de una sesión de conversación activa, su evento de entrega informa de un totalMessagePrice y totalCarrierFee de0.0, ya que la cuota de sesión cubre el mensaje. En el siguiente ejemplo, se muestra un evento de entrega de un mensaje de una conversación activa:

{
    "eventType": "RCS_DELIVERED",
    "eventVersion": "1.0",
    "eventTimestamp": 1751234567890,
    "isFinal": true,
    "originationPhoneNumber": "rcs-f4e4252a5abe48bea50a6c176a056124",
    "destinationPhoneNumber": "+14376638816",
    "isoCountryCode": "CA",
    "isInternationalSend": false,
    "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235",
    "messageRequestTimestamp": 1751234565000,
    "messageEncoding": "UNICODE",
    "messageType": "TRANSACTIONAL",
    "messageStatus": "DELIVERED",
    "messageStatusDescription": "Message has been accepted by phone",
    "totalMessageParts": 1,
    "totalMessagePrice": 0.0,
    "totalCarrierFee": 0.0,
    "rcsMetadata": {
        "billingEventType": "BASIC"
    },
    "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent",
    "agentIsoCountryCode": "CA",
    "conversationInitiatingMessageId": "177930985040408106521449",
    "conversationInitiatingMessageType": "OUTBOUND",
    "conversationSessionFee": 0.012
}

Evento CONVERSATION_STARTED

AWSLa mensajería para el usuario final envía un CONVERSATION_STARTED evento al tema de Amazon SNS de su evento de RCS cuando comienza una sesión de conversación. Una sesión comienza cuando su agente envía un mensaje y el destinatario responde en un plazo de 24 horas (iniciada por la empresa), o cuando el destinatario envía un mensaje y su agente responde (iniciada por el usuario).

messageBodyContiene un objeto JSON con los siguientes campos:

El siguiente ejemplo muestra un CONVERSATION_STARTED evento:

{
    "originationNumber": "14376638816",
    "destinationNumber": "rcs-e138fa39eabf4d6d8e95546248c8dfa7",
    "messageBody": "{\"type\":\"CONVERSATION_STARTED\",\"startTime\":\"2026-06-28T04:03:08.002+0000\",\"endTime\":\"2026-06-29T04:08:08.002+0000\",\"conversationInitiatingMessageId\":\"7e7da6ec-234a-4d4f-bbc5-943bcca663ab\",\"conversationInitiatingMessageType\":\"OUTBOUND\"}",
    "inboundMessageId": "7e7da6ec-234a-4d4f-bbc5-943bcca663ab"
}

Enrutar eventos a destinos

AWSLa mensajería del usuario final enruta los eventos de RCS a través de los destinos de los eventos establecidos en la configuración. Los destinos de los eventos se configuran en el conjunto de configuraciones asociado a las operaciones de envío. Los destinos compatibles incluyen:

Para obtener información sobre cómo crear y configurar destinos de eventos, consulte. Destinos de eventos en los SMS de mensajería para usuarios AWS finales

Cuando llameSendRcsMessage, especifique el ConfigurationSetName parámetro para asociar el mensaje al conjunto de configuraciones. Los eventos de estado salientes generados por ese mensaje se enrutan a los destinos que configuró.

Al configurar los tipos de eventos con los que coincide el destino de un evento, puede optar por suscribirse RCS_ALL a todos los tipos de eventos de RCS con un solo tipo coincidente, en lugar de enumerar cada tipo de evento de RCS de forma individual (por ejemplo, y). RCS_DELIVERED RCS_READ

Prácticas recomendadas para el procesamiento de eventos