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á.

Eventos de mensagem RCS

Quando você envia mensagens RCS com AWS End User Messaging, a plataforma RCS gera eventos que relatam alterações no ciclo de vida da mensagem, interações com destinatários e resultados em nível de sistema. Esses eventos fornecem sinais mais ricos do que os recibos de entrega de SMS tradicionais, oferecendo visibilidade em tempo real sobre se uma mensagem foi entregue, lida, expirou ou voltou para SMS ou MMS.

Os eventos de status de saída (entrega, leitura, expiração e fallback) são entregues por meio de destinos de eventos definidos na configuração. Os eventos de interação de entrada (indicadores de digitação e toques de sugestão) são entregues ao tópico bidirecional do Amazon SNS que você configura em seu agente RCS. Para configurar destinos de eventos, consulteDestinos de eventos em SMS de mensagens de usuário AWS final.

Para obter detalhes sobre as mensagens que geram esses eventos, consulteEnviando mensagens ricas de RCS.

Campos comuns em eventos do RCS

Todos os eventos do RCS, incluindo eventos de status de entrega, recibos de leitura e eventos de interação de entrada, incluem os seguintes campos que identificam o agente do RCS:

Esses campos estão presentes em todos os eventos do RCS. Eles não estão incluídos em eventos de SMS ou MMS.

Eventos de status de entrega

Os eventos de status de entrega indicam o estado do ciclo de vida de uma mensagem RCS de saída. Você usa esses eventos para confirmar a entrega, acionar a lógica de fallback ou alertar sua equipe de operações sobre violações de conteúdo.

Cada evento de status de saída tem um eventType de RCS_DELIVERED (e tipos de eventos de status RCS relacionados) e um messageStatus campo que contém um dos seguintes valores:

O exemplo a seguir mostra a carga útil de um 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"
}

Leia os recibos

Um recibo de leitura indica que o destinatário abriu ou visualizou sua mensagem. Use recibos de leitura para monitorar o engajamento e medir as taxas de leitura.

O evento de leitura usa um eventType of RCS_READ com messageStatus definido comoREAD:

{
    "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"
}

Você pode calcular sua taxa de leitura como o número de READ eventos dividido pelo número de DELIVERED eventos, multiplicado por 100.

Indicadores de digitação

Os eventos do indicador de digitação sinalizam que um participante está redigindo uma mensagem. Esses eventos fluem nas duas direções:

O exemplo a seguir mostra uma notificação de digitação recebida:

{
    "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 expiração de TTL

Quando você define um TimeToLive valor em uma mensagem e o TTL expira antes que a mensagem seja entregue, a plataforma RCS tenta revogar (excluir) a mensagem. O resultado gera um dos seguintes eventos:

Os eventos de expiração do TTL funcionam em conjunto com sua estratégia alternativa. Para obter detalhes sobre como configurar a expiração da mensagem, consulteConfigurando a expiração da mensagem RCS.

Eventos alternativos

Quando uma mensagem RCS não pode ser entregue e o AWS End User Messaging aciona um fallback de SMS ou MMS (seja por meio de configuração baseada em pool ou por mensagemFallbackConfiguration), o serviço gera eventos que indicam o resultado do fallback.

Eventos alternativos indicam:

Monitore esses eventos para medir sua taxa de fallback e identificar números de telefone que exigem consistentemente a entrega de fallback. Para obter detalhes sobre como configurar o fallback por mensagem, consulte. Configurando o fallback de SMS ou MMS por mensagem

Sugestão de eventos de toque (postback)

Quando um destinatário escolhe uma sugestão (uma resposta sugerida ou uma ação sugerida), você recebe um evento de postback contendo a PostbackData string que você configurou nessa sugestão. Use dados de postback para rotear sua lógica de conversação, não o texto exibido.

A notificação messageBody contém um objeto JSON com um type deSUGGESTION, a exibição text e o postbackData que você definiu na sugestão:

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

Para obter detalhes sobre como configurar sugestões e seus dados de postback, consulteConfigurando sugestões de RCS.

Eventos e campos de preços conversacionais

Se você registrar seu agente RCS para usar preços de conversação, o AWS End User Messaging adicionará campos aos eventos de entrega e de entrada enquanto uma mensagem fizer parte de uma sessão de conversa ativa e enviará um CONVERSATION_STARTED evento quando a sessão começar. Para obter uma visão geral do modelo de preços conversacionais, consultePreços conversacionais.

Campos de conversação

Os campos a seguir aparecem em um evento de entrega ou de entrada somente quando a mensagem faz parte de uma sessão de conversa ativa. Quando a mensagem não faz parte de uma conversa, o AWS End User Messaging omite totalmente esses campos.

Quando uma mensagem faz parte de uma sessão de conversa ativa, seu evento de entrega relata um totalMessagePrice e totalCarrierFee um0.0, porque a taxa da sessão cobre a mensagem. O exemplo a seguir mostra um evento de entrega de uma mensagem em uma conversa ativa:

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

AWSO End User Messaging envia um CONVERSATION_STARTED evento para o tópico Amazon SNS do seu evento RCS quando uma sessão de conversa começa. Uma sessão começa quando seu agente envia uma mensagem e o destinatário responde em 24 horas (iniciado pela empresa), ou quando o destinatário envia uma mensagem e seu agente responde (iniciado pelo usuário).

O messageBody contém um objeto JSON com os seguintes campos:

O exemplo a seguir mostra um 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"
}

Encaminhamento de eventos para destinos

AWSO End User Messaging roteia eventos RCS por meio de destinos de eventos definidos na configuração. Você configura destinos de eventos no conjunto de configurações associado às suas operações de envio. Os destinos compatíveis incluem:

Para saber como criar e configurar destinos de eventos, consulteDestinos de eventos em SMS de mensagens de usuário AWS final.

Ao ligarSendRcsMessage, especifique o ConfigurationSetName parâmetro para associar a mensagem ao seu conjunto de configurações. Os eventos de status de saída gerados por essa mensagem são roteados para os destinos que você configurou.

Ao configurar os tipos de eventos aos quais um destino de evento corresponde, você pode RCS_ALL optar por se inscrever em todos os tipos de eventos RCS com um único tipo de correspondência, em vez de listar cada tipo de evento RCS individualmente (como RCS_DELIVERED eRCS_READ).

Práticas recomendadas para processamento de eventos