Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Acara pesan RCS

Saat Anda mengirim pesan RCS dengan AWS End User Messaging, platform RCS menghasilkan peristiwa yang melaporkan perubahan siklus hidup pesan, interaksi penerima, dan hasil tingkat sistem. Peristiwa ini memberikan sinyal yang lebih kaya daripada tanda terima pengiriman SMS tradisional, memberi Anda visibilitas waktu nyata apakah pesan dikirim, dibaca, kedaluwarsa, atau kembali ke SMS atau MMS.

Acara status keluar (pengiriman, baca, kedaluwarsa, dan fallback) dikirimkan melalui tujuan acara yang ditetapkan konfigurasi. Peristiwa interaksi masuk (indikator pengetikan dan ketukan saran) dikirimkan ke topik Amazon SNS dua arah yang Anda konfigurasikan di agen RCS Anda. Untuk mengatur tujuan acara, lihatTujuan acara di SMS Pesan Pengguna AWS Akhir.

Untuk detail tentang pesan yang menghasilkan peristiwa ini, lihatMengirim pesan RCS yang kaya.

Bidang umum pada acara RCS

Semua peristiwa RCS, termasuk peristiwa status pengiriman, tanda terima baca, dan peristiwa interaksi masuk, mencakup bidang berikut yang mengidentifikasi agen RCS:

Bidang ini hadir di semua acara RCS. Mereka tidak termasuk dalam acara SMS atau MMS.

Acara status pengiriman

Peristiwa status pengiriman menunjukkan status siklus hidup pesan RCS keluar. Anda menggunakan peristiwa ini untuk mengonfirmasi pengiriman, memicu logika fallback, atau memperingatkan tim operasi Anda tentang pelanggaran konten.

Setiap peristiwa status keluar memiliki eventType of RCS_DELIVERED (dan jenis peristiwa status RCS terkait) dan messageStatus bidang yang menyimpan salah satu nilai berikut:

Contoh berikut menunjukkan payload acara pengiriman:

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

Baca tanda terima

Tanda terima baca menunjukkan bahwa penerima membuka atau melihat pesan Anda. Gunakan tanda terima baca untuk melacak keterlibatan dan mengukur tingkat baca.

Acara baca menggunakan a eventType of RCS_READ dengan messageStatus set keREAD:

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

Anda dapat menghitung tingkat baca Anda sebagai jumlah READ acara dibagi dengan jumlah DELIVERED acara, dikalikan dengan 100.

Indikator pengetikan

Acara indikator pengetikan menandakan bahwa peserta sedang menulis pesan. Peristiwa ini mengalir di kedua arah:

Contoh berikut menunjukkan pemberitahuan pengetikan masuk:

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

Acara kedaluwarsa TTL

Saat Anda menetapkan TimeToLive nilai pada pesan dan TTL berlalu sebelum pesan dikirimkan, platform RCS mencoba mencabut (menghapus) pesan tersebut. Hasilnya menghasilkan salah satu peristiwa berikut:

Acara kedaluwarsa TTL bekerja sama dengan strategi fallback Anda. Untuk detail tentang mengonfigurasi kedaluwarsa pesan, lihat. Mengkonfigurasi kedaluwarsa pesan RCS

Acara fallback

Ketika pesan RCS tidak dapat dikirimkan dan AWS End User Messaging memicu fallback SMS atau MMS (baik melalui konfigurasi berbasis kumpulan atau per-pesanFallbackConfiguration), layanan menghasilkan peristiwa yang menunjukkan hasil fallback.

Peristiwa fallback menunjukkan:

Pantau peristiwa ini untuk mengukur tingkat fallback Anda dan mengidentifikasi nomor telepon yang secara konsisten memerlukan pengiriman fallback. Untuk detail tentang mengonfigurasi fallback per pesan, lihat. Mengkonfigurasi fallback SMS atau MMS per pesan

Acara ketuk saran (postback)

Saat penerima memilih saran (balasan yang disarankan atau tindakan yang disarankan), Anda menerima peristiwa postback yang berisi PostbackData string yang Anda konfigurasikan pada saran tersebut. Gunakan data postback untuk merutekan logika percakapan Anda, bukan teks tampilan.

Notifikasi messageBody berisi objek JSON dengan type dariSUGGESTION, tampilantext, dan yang postbackData Anda tetapkan pada saran:

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

Untuk detail tentang cara mengonfigurasi saran dan data postback mereka, lihatMengkonfigurasi saran RCS.

Acara dan bidang penetapan harga percakapan

Jika Anda mendaftarkan agen RCS untuk menggunakan harga percakapan, AWS End User Messaging menambahkan bidang ke pengiriman dan acara masuk saat pesan merupakan bagian dari sesi percakapan aktif, dan mengirimkan CONVERSATION_STARTED acara saat sesi dimulai. Untuk ikhtisar model penetapan harga percakapan, lihatHarga percakapan.

Bidang percakapan

Bidang berikut muncul pada acara pengiriman atau masuk hanya jika pesan merupakan bagian dari sesi percakapan aktif. Ketika pesan bukan bagian dari percakapan, AWS End User Messaging menghilangkan bidang ini sepenuhnya.

Ketika pesan merupakan bagian dari sesi percakapan aktif, acara pengirimannya melaporkan a totalMessagePrice dan totalCarrierFee dari0.0, karena biaya sesi mencakup pesan. Contoh berikut menunjukkan peristiwa pengiriman pesan dalam percakapan aktif:

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

Acara CONVERSATION_STARTED

AWSPesan Pengguna Akhir mengirimkan CONVERSATION_STARTED acara ke topik Amazon SNS acara RCS Anda saat sesi percakapan dimulai. Sesi dimulai ketika agen Anda mengirim pesan dan penerima membalas dalam waktu 24 jam (dimulai bisnis), atau ketika penerima mengirim pesan dan agen Anda merespons (dimulai pengguna).

messageBodyBerisi objek JSON dengan bidang-bidang berikut:

Contoh berikut menunjukkan CONVERSATION_STARTED peristiwa:

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

Merutekan acara ke tujuan

AWSEnd User Messaging merutekan peristiwa RCS melalui konfigurasi menetapkan tujuan acara. Anda mengonfigurasi tujuan acara pada set konfigurasi yang terkait dengan operasi pengiriman Anda. Tujuan yang didukung meliputi:

Untuk mempelajari cara membuat dan mengonfigurasi tujuan acara, lihatTujuan acara di SMS Pesan Pengguna AWS Akhir.

Saat Anda meneleponSendRcsMessage, tentukan ConfigurationSetName parameter untuk mengaitkan pesan dengan set konfigurasi Anda. Peristiwa status keluar yang dihasilkan oleh pesan tersebut dirutekan ke tujuan yang Anda konfigurasikan.

Saat mengonfigurasi jenis acara yang cocok dengan tujuan acara, Anda dapat memilih RCS_ALL untuk berlangganan semua jenis acara RCS dengan satu jenis pencocokan, alih-alih mencantumkan setiap jenis acara RCS satu per satu (seperti RCS_DELIVERED danRCS_READ).

Praktik terbaik untuk pemrosesan acara