Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Eventi dei messaggi RCS

Quando si inviano messaggi RCS con AWS End User Messaging, la piattaforma RCS genera eventi che segnalano le modifiche del ciclo di vita dei messaggi, le interazioni con i destinatari e i risultati a livello di sistema. Questi eventi forniscono segnali più ricchi rispetto alle tradizionali ricevute di recapito via SMS e consentono di verificare in tempo reale se un messaggio è stato recapitato, letto, scaduto o se è stato convertito in SMS o MMS.

Gli eventi sullo stato in uscita (consegna, lettura, scadenza e fallback) vengono forniti tramite destinazioni di eventi impostate dalla configurazione. Gli eventi di interazione in entrata (indicatori di digitazione e tocchi di suggerimenti) vengono forniti nell'argomento Amazon SNS bidirezionale che configuri sul tuo agente RCS. Per configurare le destinazioni degli eventi, consulta. Destinazioni degli eventi negli SMS di messaggistica per l'utente AWS finale

Per informazioni dettagliate sui messaggi che generano questi eventi, consultaInvio di messaggi RCS complessi.

Campi comuni sugli eventi RCS

Tutti gli eventi RCS, inclusi gli eventi sullo stato di consegna, le conferme di lettura e gli eventi di interazione in entrata, includono i seguenti campi che identificano l'agente RCS:

Questi campi sono presenti in tutti gli eventi RCS. Non sono inclusi negli eventi SMS o MMS.

Eventi sullo stato della consegna

Gli eventi sullo stato della consegna indicano lo stato del ciclo di vita di un messaggio RCS in uscita. Questi eventi vengono utilizzati per confermare la consegna, attivare la logica di fallback o avvisare il team operativo in caso di violazioni dei contenuti.

Ogni evento di stato in uscita ha un eventType of RCS_DELIVERED (e i relativi tipi di eventi di stato RCS) e un messageStatus campo che contiene uno dei seguenti valori:

L'esempio seguente mostra il payload di un evento di consegna:

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

Leggi le ricevute

Una conferma di lettura indica che il destinatario ha aperto o visualizzato il messaggio. Utilizza le conferme di lettura per monitorare il coinvolgimento e misurare i tassi di lettura.

L'evento di lettura utilizza un eventType comando RCS_READ off messageStatus impostato suREAD:

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

Puoi calcolare la velocità di lettura come il numero di READ eventi diviso per il numero di DELIVERED eventi, moltiplicato per 100.

Indicatori di digitazione

Gli eventi dell'indicatore di digitazione segnalano che un partecipante sta componendo un messaggio. Questi eventi fluiscono in entrambe le direzioni:

L'esempio seguente mostra una notifica di digitazione in entrata:

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

Eventi di scadenza TTL

Quando si imposta un TimeToLive valore su un messaggio e il TTL scade prima che il messaggio venga recapitato, la piattaforma RCS tenta di revocare (eliminare) il messaggio. Il risultato genera uno dei seguenti eventi:

Gli eventi di scadenza TTL interagiscono con la tua strategia di fallback. Per i dettagli sulla configurazione della scadenza dei messaggi, vedere. Configurazione della scadenza dei messaggi RCS

Eventi di fallback

Quando un messaggio RCS non può essere recapitato e AWS End User Messaging attiva un fallback SMS o MMS (tramite la configurazione basata sul pool o per messaggioFallbackConfiguration), il servizio genera eventi che indicano l'esito del fallback.

Gli eventi di fallback indicano:

Monitora questi eventi per misurare il tasso di fallback e identificare i numeri di telefono che richiedono costantemente la consegna di fallback. Per dettagli sulla configurazione del fallback per messaggio, consulta. Configurazione del fallback SMS o MMS per messaggio

Eventi Suggestion Tap (postback)

Quando un destinatario sceglie un suggerimento (una risposta o un'azione suggerita), ricevi un evento di postback contenente la PostbackData stringa che hai configurato su quel suggerimento. Utilizza i dati di postback per indirizzare la logica di conversazione, non il testo visualizzato.

La notifica messageBody contiene un oggetto JSON con un type ofSUGGESTION, lo schermo e l'impostazione che postbackData hai text impostato sul suggerimento:

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

Per dettagli su come configurare i suggerimenti e i relativi dati di postback, consulta. Configurazione dei suggerimenti RCS

Eventi e campi relativi ai prezzi conversazionali

Se si registra il proprio agente RCS per utilizzare la tariffazione conversazionale, AWS End User Messaging aggiunge campi agli eventi di consegna e in entrata mentre un messaggio fa parte di una sessione di conversazione attiva e invia un evento all'inizio di una CONVERSATION_STARTED sessione. Per una panoramica del modello di prezzo conversazionale, consulta. Prezzi conversazionali

Campi di conversazione

I seguenti campi vengono visualizzati in un evento di recapito o in entrata solo quando il messaggio fa parte di una sessione di conversazione attiva. Quando il messaggio non fa parte di una conversazione, AWS End User Messaging omette completamente questi campi.

Quando un messaggio fa parte di una sessione di conversazione attiva, il relativo evento totalCarrierFee di recapito segnala una totalMessagePrice 0.0 fine, poiché la tariffa della sessione copre il messaggio. L'esempio seguente mostra un evento di recapito di un messaggio all'interno di una conversazione attiva:

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

AWSEnd User Messaging invia un CONVERSATION_STARTED evento all'argomento del tuo evento RCS Amazon SNS all'inizio di una sessione di conversazione. Una sessione inizia quando l'agente invia un messaggio e il destinatario risponde entro 24 ore (avvio aziendale) oppure quando il destinatario invia un messaggio e l'agente risponde (iniziativa avviata dall'utente).

messageBodyContiene un oggetto JSON con i seguenti campi:

L'esempio seguente mostra 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"
}

Indirizzamento degli eventi verso le destinazioni

AWSLa messaggistica per l'utente finale indirizza gli eventi RCS attraverso le destinazioni degli eventi del set di configurazione. Le destinazioni degli eventi vengono configurate sul set di configurazione associato alle operazioni di invio. Le destinazioni supportate includono:

Per informazioni su come creare e configurare le destinazioni degli eventi, consulta. Destinazioni degli eventi negli SMS di messaggistica per l'utente AWS finale

Quando chiamiSendRcsMessage, specifica il ConfigurationSetName parametro per associare il messaggio al set di configurazione. Gli eventi di stato in uscita generati da quel messaggio vengono indirizzati alle destinazioni configurate.

Quando configurate i tipi di eventi a cui corrisponde una destinazione di evento, potete scegliere di RCS_ALL sottoscrivere tutti i tipi di eventi RCS con un unico tipo corrispondente, invece di elencare ogni tipo di evento RCS singolarmente (ad esempio e). RCS_DELIVERED RCS_READ

Le migliori pratiche per l'elaborazione degli eventi