Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengirim pesan RCS yang kaya
Dengan tindakan SendRcsMessage API di AWS End User Messaging, Anda dapat mengirim konten yang kaya dan interaktif ke penerima melalui RCS (Rich Communication Services). Pesan RCS yang kaya melampaui teks biasa untuk menyertakan kartu kaya, komidi putar, file media, dan saran yang dipilih penerima untuk mengambil tindakan. Elemen interaktif ini mengubah pemberitahuan satu arah menjadi pengalaman percakapan dua arah, seperti membiarkan penerima mengonfirmasi janji temu, menelusuri katalog produk, atau membagikan lokasi mereka tanpa meninggalkan percakapan.
Gunakan SendRcsMessage saat Anda perlu mengirimkan konten interaktif yang kaya secara visual, seperti kartu produk dengan gambar dan tombol tindakan, konfirmasi janji temu dengan saran kalender, lampiran file, atau komidi putar multi-item yang digulir oleh penerima. Setiap SendRcsMessage permintaan menyertakan isi teks terpisah untuk konten teks apa pun, dan dapat menyertakan fallback SMS atau MMS opsional untuk penerima yang perangkatnya tidak mendukung RCS.
Untuk pesan teks biasa yang tidak memerlukan pemformatan kaya, gunakan tindakan API sebagai SendTextMessage gantinya. SendTextMessagehanya menerima konten teks, yang membuat permintaan lebih sederhana, dan bekerja dengan kumpulan pesan yang secara otomatis memilih antara RCS dan SMS berdasarkan kemampuan penerima. Lihat perinciannya di Mengirim pesan RCS.
penting
Anda dapat menggunakan pesan RCS dengan SendRcsMessage di semua negara di mana RCS didukung. Untuk daftar saat ini, lihatNegara yang didukung untuk RCS.
Topik
Prasyarat
Sebelum Anda mengirim pesan RCS yang kaya, selesaikan langkah-langkah pengaturan RCS. Mulai menggunakan RCS Selain Agen AWS RCS terdaftar dalam status Aktif, konfirmasikan hal berikut:
-
Untuk memvalidasi konten kaya sebelum Anda mengirim ke penerima produksi, tambahkan perangkat uji terdaftar ke agen pengujian Anda dan kirim pesan pengujian ke sana. Lihat perinciannya di Menguji pesan RCS.
-
Konfigurasikan tujuan acara (topik Amazon SNS atau aliran pengiriman Amazon Data Firehose) untuk menerima peristiwa status pengiriman. Tujuan acara diperlukan jika pesan Anda menyertakan elemen interaktif seperti saran, karena pilihan penerima dikirimkan ke aplikasi Anda sebagai acara postback. Lihat perinciannya di Tujuan acara di SMS Pesan Pengguna AWS Akhir.
-
Jika Anda mengonfigurasi fallback SMS atau MMS dan Anda mengirim ke tujuan dengan risiko pemompaan SMS, kaitkan konfigurasi perlindungan untuk menerapkan aturan opt-out dan negara ke pesan fallback. Lihat perinciannya di Perlindungan Penipuan di AWS SMS Pesan Pengguna Akhir.
Memilih antara SendTextMessage dan SendRcsMessage
Kedua tindakan API dapat mengirimkan pesan melalui RCS, tetapi mereka melayani tujuan yang berbeda. SendTextMessagemengasumsikan setiap pesan dapat dikirimkan sebagai SMS dan juga dapat mengirimkannya melalui RCS, yang memberikan kontrak permintaan yang lebih sederhana. SendRcsMessagemengasumsikan konten RCS yang kaya dan menambahkan kemampuan yang SendTextMessage tidak dimiliki, termasuk media dan jenis konten terstruktur, kedaluwarsa pesan dengan time-to-live (TTL), dan SMS per pesan atau MMS fallback.
| Kemampuan | SendTextMessage | SendRcsMessage |
|---|---|---|
| Isi pesan | Hanya teks biasa | Teks, file, kartu kaya, dan komidi putar, masing-masing dengan saran opsional |
| Saluran pengiriman | RCS atau SMS | RCS, dengan SMS opsional atau mms fallback |
| Pemilihan saluran | Pool memilih RCS atau SMS secara otomatis dengan kemampuan penerima | RCS terlebih dahulu, lalu fallback SMS atau MMS yang dikonfigurasi |
| Mundur | Otomatis, berbasis kolam | Eksplisit, per pesan |
| Identitas Originasi | Kumpulan, nomor telepon, ID pengirim, atau Agen AWS RCS | Agen RCS Pool atau AWS |
| Kedaluwarsa pesan (TTL) | Tidak | Ya |
| Minta kontrak | Lebih sederhana. API yang sama dengan pengiriman SMS dan MMS | API RCS khusus dengan isi teks dan jenis konten terpisah |
Pilih SendTextMessage notifikasi teks biasa, saat Anda menginginkan pemilihan saluran otomatis berbasis kumpulan, atau saat Anda memigrasi alur kerja SMS yang ada dengan sedikit perubahan kode. Pilih SendRcsMessage kapan Anda membutuhkan kartu kaya, komidi putar, file media, atau saran, saat Anda menginginkan fallback per pesan yang ditentukan, atau saat Anda memerlukan kedaluwarsa untuk konten yang sensitif terhadap waktu. TTL-based
Jenis konten
RcsMessageContentParameter berisi Content objek dengan tepat satu jenis konten, dan daftar tingkat pesan Suggestions opsional. Anda tidak dapat menggabungkan beberapa jenis konten dalam satu permintaan.
| Jenis konten | Deskripsi | Informasi selengkapnya |
|---|---|---|
| TextMessage | Isi teks hingga 3.072 karakter, dengan saran opsional. Tidak seperti pesan SMS, pesan teks RCS dapat mencakup saran dan disampaikan sebagai pesan tunggal daripada dibagi menjadi beberapa segmen. | Mengirim pesan teks RCS |
| FileMessage | File media tunggal (gambar, video, audio, atau PDF) yang direferensikan oleh URL HTTPS atau Amazon S3. | Mengirim pesan file RCS |
| RichCard | Kartu terstruktur dengan media opsional, judul, deskripsi, dan hingga 4 saran. | Mengirim kartu kaya RCS |
| Korsel | Satu set yang dapat digulir dari 2 hingga 10 kartu, masing-masing dengan media, teks, dan sarannya sendiri. | Mengirim komidi putar RCS |
Saran
Saran adalah chip interaktif yang dipilih penerima untuk mengambil tindakan. Anda dapat menambahkan saran ke jenis konten apa pun: saran tingkat pesan berlaku untuk seluruh pesan (hingga 11), dan saran tingkat kartu berlaku untuk kartu kaya individu atau kartu korsel (hingga 4). AWSEnd User Messaging mendukung enam jenis saran, termasuk balasan, tautan, dan tindakan seperti memanggil nomor telepon atau berbagi lokasi. Untuk daftar lengkap jenis saran, parameternya, dan cara menerima ketukan saran, lihat. Mengkonfigurasi saran RCS
SendRcsMessage meminta ikhtisar
SendRcsMessagePermintaan menggunakan parameter kunci berikut.
| Parameter | Diperlukan | Deskripsi |
|---|---|---|
DestinationPhoneNumber |
Ya | Nomor telepon penerima dalam E.164 format, misalnya+12065550100. |
OriginationIdentity |
Ya | ID atau ARN dari kumpulan atau Agen AWS RCS untuk dikirim. Agen harus dalam keadaan aktif. |
RcsMessageContent |
Tidak | Isi pesan. Berisi Content objek dengan persis salah satu dariTextMessage,FileMessage,RichCard, atauCarousel, dan Suggestions daftar tingkat atas opsional. |
FallbackConfiguration |
Tidak | Pesan SMS atau MMS untuk dikirim jika pengiriman RCS tidak berhasil. Termasuk wajib Channel (SMSatauMMS), aMessageBody, opsional MediaUrls untuk MMS, dan OriginationIdentity yang merupakan nomor telepon atau ID pengirim. |
TimeToLive |
Tidak | Waktu dalam hitungan detik sebelum pesan kedaluwarsa jika tidak terkirim. Minimal adalah 1 detik dan maksimum adalah 172.800 detik (48 jam). Nilai 10 detik atau lebih direkomendasikan. |
MessageFeedbackEnabled |
Tidak | Setel true untuk mengaktifkan umpan balik pesan untuk pesan. Saat penerima menerima pesan, perbarui status pesan dengan memanggil PutMessageFeedback operasi. |
Respons yang berhasil mengembalikan respons MessageId yang Anda gunakan untuk mengkorelasikan peristiwa status pengiriman.
catatan
Fallback for SendRcsMessage dikonfigurasi per pesan melalui. FallbackConfiguration Untuk perilaku fallback penuh, lihat. Mengkonfigurasi fallback SMS atau MMS per pesan
Ukuran pesan dan batas hitungan
| Kuota | Nilai |
|---|---|
| Badan pesan teks | 3.072 karakter |
| Judul kartu kaya | 200 karakter |
| Deskripsi kartu kaya | 2.000 karakter |
| Ukuran file media | 100 MB |
| Panjang URL media | 2.000 karakter |
| Saran per pesan | 11 |
| Saran per kartu | 4 |
| Teks tampilan saran | 25 karakter |
| Data postback | 2.048 karakter |
| Kartu korsel | 2 hingga 10 kartu |
| Time-to-live | 1 detik hingga 172.800 detik (48 jam) |
Untuk batasan dan batasan RCS di semua jenis konten, lihatBatas dan batasan pesan.
Acara pengiriman dan tindakan penerima
AWSEnd User Messaging menghasilkan peristiwa yang melaporkan status pengiriman pesan dan tindakan penerima, termasuk peristiwa terkirim, dibaca, gagal, kedaluwarsa, dan postback. Acara postback dihasilkan ketika penerima memilih saran dan menyertakan nilainya. PostbackData Rutekan peristiwa ini ke topik Amazon SNS, aliran pengiriman Amazon Data Firehose, atau Amazon Logs. CloudWatch Lihat perinciannya di Acara pesan RCS.
Praktik terbaik
Rancang pesan RCS yang kaya sebagai pengalaman percakapan dan interaktif. Tetapkan TimeToLive konten sensitif waktu seperti kata sandi satu kali, konfigurasikan fallback SMS atau MMS untuk pesan yang harus mencapai penerima bahkan ketika perangkat mereka tidak mendukung RCS, menjaga label saran tetap pendek (batasnya adalah 25 karakter), dan sertakan pengenal terstruktur PostbackData sehingga aplikasi Anda dapat merutekan respons tanpa pencarian tambahan. Untuk panduan terperinci, lihatPraktik terbaik RCS.
