View a markdown version of this page

Mengkonfigurasi fallback SMS atau MMS per pesan - AWS SMS Pesan Pengguna Akhir

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 TimeToLive nilai 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

Perbandingan mekanisme fallback
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.

FallbackConfiguration bidang
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 OpenUrl tindakan) 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 denganTimeToLive, 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