Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengkonfigurasi fallback SMS atau MMS per pesan
Saat Anda mengirim pesan RCS, perangkat penerima mungkin tidak mendukung RCS, atau pesan mungkin kedaluwarsa sebelum pengiriman. Dengan fallback per pesan, Anda dapat menentukan konten SMS atau MMS alternatif yang diberikan AWS End User Messaging secara otomatis ketika pesan RCS tidak dapat mencapai penerima. Anda mengonfigurasi fallback pada setiap SendRcsMessage permintaan dengan menyertakan parameter. FallbackConfiguration
Saat fallback memicu
AWSEnd User Messaging memicu pesan fallback dalam dua situasi:
-
Kegagalan RCS segera: Perangkat atau operator penerima tidak mendukung RCS, atau saluran RCS menolak pesan.
-
TTL kedaluwarsa: Anda menetapkan
TimeToLivenilai dan pesan tidak terkirim sebelum timer kedaluwarsa. Untuk informasi selengkapnya tentang kedaluwarsa pesan, lihat. Mengkonfigurasi kedaluwarsa pesan RCS
Jika Anda tidak menyertakan FallbackConfiguration dalam permintaan dan pesan RCS gagal atau kedaluwarsa, tidak ada pesan fallback yang dikirim.
Per-message fallback dibandingkan dengan fallback berbasis kolam renang
Per-message fallback on SendRcsMessage berbeda dari fallback berbasis kolam otomatis yang tersedia. SendTextMessage Untuk detail tentang fallback berbasis kolam renang, lihat. RCS ke SMS fallback menggunakan kolam telepon
| Fitur | Pool-based mundur () SendTextMessage |
Per-message mundur () SendRcsMessage |
|---|---|---|
| Konfigurasi | Otomatis ketika kolam berisi agen RCS dan identitas SMS | Eksplisit: Anda sertakan FallbackConfiguration dalam setiap permintaan |
| Saluran mundur | SMS (dipilih oleh kolam renang) | SMS atau MMS (Anda pilih denganChannel) |
| Konten fallback | Badan pesan yang sama | Anda menyediakan konten terpisah yang disesuaikan untuk SMS atau MMS |
| Pemilihan identitas | Pool memilih identitas originasi | Anda menentukan nomor telepon atau ID pengirim |
| Pemicu | RCS tidak didukung (berbasis timeout) | Kegagalan RCS langsung atau kedaluwarsa TTL |
FallbackConfiguration struktur
FallbackConfigurationParameter adalah objek tunggal pada SendRcsMessage permintaan. Anda mengatur Channel bidang untuk menunjukkan apakah fallback adalah SMS atau MMS, lalu berikan bidang konten yang sesuai.
| Bidang | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
Channel |
Tali | Ya | Saluran fallback. Nilai yang benar: SMS atau MMS. |
MessageBody |
String | Bersyarat | Tubuh teks dari pesan fallback. Maksimal 1.600 karakter. Diperlukan kapan ChannelSMS. UntukMMS, setidaknya satu dari MessageBody atau MediaUrls harus disediakan. |
MediaUrls |
Daftar string | Bersyarat | Satu atau beberapa URL media untuk fallback MMS. UntukMMS, setidaknya satu dari MessageBody atau MediaUrls harus disediakan. |
OriginationIdentity |
String | Bersyarat | Identitas originasi untuk pesan fallback. Menerima nomor telepon atau ID pengirim (berdasarkan nilai, ID, atau ARN); Anda tidak dapat menentukan kumpulan atau agen RCS. Jika Anda menghilangkan bidang ini dan pesan asli dikirim melalui kumpulan, layanan memilih nomor yang sesuai dari kumpulan itu. |
penting
Batas fallback MessageBody adalah 1.600 karakter. Ini lebih pendek dari batas 3.072 karakter untuk tubuh RCS. TextMessage Buat konten fallback Anda agar sesuai dengan batasan karakter SMS atau MMS.
JSON berikut menunjukkan struktur FallbackConfiguration objek untuk fallback SMS:
{ "Channel": "SMS", "MessageBody": "Your order has shipped. Track at https://example.com/track/12345", "OriginationIdentity": "+18005550199" }
JSON berikut menunjukkan struktur untuk fallback MMS:
{ "Channel": "MMS", "MessageBody": "Your order has shipped.", "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"], "OriginationIdentity": "+18005550199" }
Mengkonfigurasi fallback SMS
Untuk kembali ke SMS, atur Channel ke SMS dan berikan fileMessageBody. Karena SMS tidak mendukung chip saran atau kartu kaya, sertakan URL penting apa pun sebagai teks biasa di badan pesan.
Mengkonfigurasi fallback MMS
Untuk kembali ke MMS, atur Channel ke MMS dan sediakan satu atau beberapa URL media di. MediaUrls Gunakan MMS fallback ketika pesan RCS Anda berisi konten visual (seperti kartu kaya dengan gambar) dan Anda ingin mempertahankan pengalaman visual untuk penerima yang tidak mendukung RCS.
Menggabungkan fallback dengan kedaluwarsa pesan
Saat Anda mengatur keduanya TimeToLive dan FallbackConfiguration berdasarkan permintaan, AWS End User Messaging mencoba pengiriman RCS selama TTL. Jika pesan tidak terkirim sebelum timer kedaluwarsa, layanan akan mengirimkan pesan fallback. Pola ini berguna untuk konten yang sensitif terhadap waktu seperti kata sandi satu kali atau pengingat janji temu.
Untuk informasi selengkapnya tentang mengonfigurasi kedaluwarsa pesan, lihat. Mengkonfigurasi kedaluwarsa pesan RCS
Contoh berikut menetapkan TTL 60 detik dengan fallback SMS:
{ "DestinationPhoneNumber": "+12065550100", "OriginationIdentity": "rcs-agent-1234567890", "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}", "TimeToLive": 60, "FallbackConfiguration": { "Channel": "SMS", "MessageBody": "Your verification code is 483291.", "OriginationIdentity": "+18005550199" } }
Praktik terbaik
-
Tulis konten fallback secara terpisah. Konten RCS yang kaya (chip saran, kartu kaya, komidi putar) tidak diterjemahkan langsung ke SMS atau MMS. Tulis pesan fallback yang ringkas dan mandiri daripada menggunakan kembali kata demi kata tubuh RCS.
-
Sertakan URL sebagai teks biasa dalam fallback SMS. Ganti chip saran interaktif (seperti
OpenUrltindakan) dengan URL sebaris di.MessageBody -
Gunakan MMS fallback untuk konten visual. Jika pesan RCS Anda menampilkan kartu kaya atau korsel dengan gambar, fallback MMS mempertahankan konteks visual untuk penerima tanpa dukungan RCS.
-
Tetapkan TTL yang masuk akal. Saat Anda menggabungkan fallback dengan
TimeToLive, pilih TTL yang menyeimbangkan upaya pengiriman dengan ketepatan waktu. Untuk pesan sensitif waktu, TTL 30 hingga 60 detik memberikan jendela pengiriman RCS singkat sebelum jatuh kembali. Untuk pesan umum, jendela yang lebih panjang (menit ke jam) memberi saluran RCS lebih banyak kesempatan untuk berhasil. -
Verifikasi identitas originasi Anda. Konfigurasi fallback harus berupa nomor telepon atau ID pengirim yang terdaftar di akun AWS End User Messaging Anda dan mampu mengirim SMS atau MMS ke negara tujuan.
OriginationIdentity
Sumber daya terkait
-
RCS ke SMS fallback menggunakan kolam teleponuntuk informasi tentang fallback berbasis kolam otomatis dengan.
SendTextMessage -
Mengkonfigurasi kedaluwarsa pesan RCSuntuk informasi tentang mengkonfigurasi TTL dan perilaku kedaluwarsa.
-
Mengirim pesan RCS yang kayauntuk ikhtisar jenis pesan kaya RCS dan
SendRcsMessageAPI.