View a markdown version of this page

Fallback RCS ke SMS menggunakan kumpulan telepon - AWS Pesan SMS Pengguna Akhir

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

Fallback RCS ke SMS menggunakan kumpulan telepon

Kumpulan telepon adalah wadah identitas pesan, seperti Agen AWS RCS dan nomor telepon SMS, yang menyediakan lapisan abstraksi antara permintaan API Anda dan identitas asal yang mendasarinya. Pool menyederhanakan perubahan konfigurasi, migrasi tipe angka, dan RCS-to-SMS fallback. Anda mengirim satu panggilan API ke kumpulan, dan Pesan AWS Pengguna Akhir menangani pemilihan saluran untuk Anda.

Bab ini menjelaskan bagaimana pengiriman RCS dapat gagal, apa yang memungkinkan fallback SMS, logika fallback dan urutan prioritas, dan implikasi penagihan. Ini juga mencakup praktik terbaik kumpulan per kasus penggunaan dan cara menambahkan dan menghapus Agen AWS RCS dari kumpulan. Untuk informasi umum tentang kumpulan telepon, lihatKumpulan telepon di AWS Pesan SMS Pengguna Akhir. Untuk informasi tentang mengelola Agen AWS RCS, lihatMengelola agen RCS.

Bagaimana pengiriman RCS bisa gagal

Pengiriman RCS dapat gagal karena beberapa alasan. Memahami mode kegagalan ini membantu Anda merencanakan strategi fallback Anda:

  • Operator tidak mendukung RCS — Operator seluler penerima belum mengaktifkan pesan RCS di jaringan mereka.

  • Perangkat tidak mendukung RCS — Perangkat penerima tidak memiliki kemampuan RCS (misalnya, perangkat Android yang lebih lama atau iPhone yang menjalankan iOS lebih awal dari 18).

  • Agen tidak aktif di operator — Agen AWS RCS Anda belum disetujui oleh operator penerima, atau agen dalam status PARSIAL untuk negara tersebut.

  • Perangkat sementara tidak dapat dijang kau — Perangkat penerima mendukung RCS tetapi sementara offline atau tidak memiliki koneksi data. Pesan RCS memerlukan koneksi data untuk pengiriman.

Ketika salah satu dari kondisi ini terjadi dan Anda menggunakan pengiriman berbasis kumpulan atau tingkat akun, Pesan Pengguna Ak AWS hir secara otomatis kembali ke pengiriman SMS menggunakan nomor telepon khusus atau ID pengirim dari kumpulan atau akun yang sama. Rute SMS bersama tidak didukung sebagai cadangan untuk pengiriman RCS. Jika kumpulan atau akun tidak berisi pencetus khusus (nomor telepon atau ID pengirim) yang valid untuk negara tujuan, pesan gagal.

Apa yang memungkinkan fallback SMS

SMS fallback memerlukan Agen AWS RCS dan setidaknya satu nomor telepon SMS khusus atau ID pengirim di kumpulan yang sama. Saat Anda mengirim pesan ke kumpulan, Pesan Pengguna AWS Akhir mencoba pengiriman RCS terlebih dahulu. Jika pengiriman RCS gagal, layanan akan mencoba kembali pesan melalui SMS menggunakan nomor telepon khusus dari kumpulan yang sama. Rute SMS bersama tidak didukung untuk fallback RCS. Kumpulan hanya dengan Agen AWS RCS (dan tanpa nomor telepon khusus atau ID pengirim) tidak mendukung fallback SMS. Jika RCS gagal dalam konfigurasi itu, pesan tidak terkirim.

penting

Agar fallback SMS berfungsi, kumpulan Anda harus berisi Agen AWS RCS dan satu atau lebih nomor telepon SMS khusus atau ID pengirim. Kumpulan dengan hanya satu tipe identitas tidak menyediakan fallback lintas saluran. Rute bersama tidak digunakan untuk RCS-to-SMS fallback, bahkan jika rute bersama diaktifkan di kumpulan.

Mengapa menggunakan kolam

Sebaiknya gunakan kumpulan telepon untuk semua kasus penggunaan pesan, bukan hanya RCS. Kolam renang memberikan keuntungan sebagai berikut:

  • Fallback SMS Otom atis — Ketika kumpulan berisi Agen AWS RCS dan nomor telepon SMS, Pesan Pengguna Akhir AWS mencoba pengiriman RCS terlebih dahulu. Jika pengiriman RCS gagal (misalnya, perangkat penerima atau operator tidak mendukung RCS), layanan secara otomatis mencoba ulang pesan melalui SMS menggunakan nomor telepon dari kumpulan yang sama. Anda tidak perlu menerapkan logika fallback dalam aplikasi Anda.

  • Perutean cerdas — Layanan memilih identitas asal terbaik dari kumpulan berdasarkan tujuan, ketersediaan saluran, dan riwayat pengiriman yang melekat. Perutean ini terjadi secara transparan dengan setiap SendTextMessage panggilan.

  • Panggilan API tunggal — Anda menentukan ID kumpulan sebagai identitas asal dalam SendTextMessage permintaan Anda. Layanan menentukan apakah akan mengirimkan melalui RCS atau SMS tanpa logika tambahan di pihak Anda.

  • Fleksibilitas untuk perubahan di masa mendatang — Anda dapat menambahkan atau menghapus nomor telepon dan Agen AWS RCS dari kumpulan kapan saja tanpa mengubah kode aplikasi Anda. Misalnya, Anda dapat menambahkan nomor bebas pulsa untuk SMS fallback atau menukar nomor 10DLC tanpa mengubah integrasi pengiriman Anda.

  • Tanpa biaya atau kerugian — Membuat kumpulan dan menambahkan identitas asal ke dalamnya tidak dikenakan biaya tambahan. Bahkan dengan satu nomor telepon atau satu Agen AWS RCS, menggunakan kumpulan memberi Anda fleksibilitas untuk menambahkan lebih banyak identitas nanti tanpa perubahan aplikasi.

catatan

Kami merekomendasikan selalu menggunakan kolam untuk pengiriman pesan. Tidak ada biaya atau kerugian untuk menggunakan kolam, bahkan dengan identitas asli tunggal. Untuk RCS-to-SMS fallback, kumpulan harus berisi Agen AWS RCS dan setidaknya satu nomor telepon SMS. Dimulai dengan kumpulan dari awal berarti Anda dapat menambahkan nomor fallback SMS atau Agen AWS RCS tambahan nanti tanpa mengubah kode pengiriman Anda.

Pool-per-use-case model

Sebaiknya buat satu kumpulan per kasus penggunaan. Setiap kumpulan harus berisi semua nomor telepon dan Agen AWS RCS yang melayani satu tujuan pengiriman pesan. Contoh:

  • Kumpulan transaksional untuk kode OTP dan notifikasi akun, berisi Agen AWS RCS Anda dan nomor 10DLC yang terdaftar untuk pengiriman pesan transaksional.

  • Kumpulan pemasaran untuk pesan promosi, berisi Agen AWS RCS yang sama (atau yang berbeda) dan nomor bebas pulsa yang terdaftar untuk pemasaran.

  • Kumpulan pengingat janji temu untuk penjadwalan pemberitahuan, berisi Agen AWS RCS Anda dan nomor telepon khusus untuk pesan terkait janji temu.

Model ini memastikan bahwa ketika pengiriman RCS gagal dan layanan jatuh kembali ke SMS, pesan fallback dikirim dari nomor telepon yang terdaftar dan disetujui untuk kasus penggunaan yang sama. Ini membuat pesan Anda sesuai dengan persyaratan operator dan ketentuan pendaftaran.

Risiko kepatuhan dengan pengiriman tingkat akun

Saat Anda mengirim pesan di tingkat akun (tanpa menentukan kumpulan atau identitas asal), Pesan Pengguna AWS Akhir memilih identitas asal dari semua identitas yang tersedia di akun Anda. Jika akun Anda memiliki beberapa nomor telepon yang terdaftar untuk kasus penggunaan yang berbeda, layanan dapat memilih nomor telepon yang tidak sesuai dengan konten pesan Anda.

penting

Account-level mengirim dengan kasus penggunaan campuran menciptakan risiko kepatuhan. Misalnya, jika akun Anda memiliki nomor 10DLC yang terdaftar untuk pesan OTP dan nomor bebas pulsa yang terdaftar untuk pengingat janji temu, pesan OTP yang kembali ke SMS dapat dikirim dari nomor bebas pulsa pengingat janji temu. Ini melanggar ketentuan pendaftaran untuk nomor tersebut dan dapat mengakibatkan pemfilteran operator atau penangguhan nomor.

Untuk menghindari risiko ini, gunakan pengiriman berbasis kumpulan dengan satu kumpulan per kasus penggunaan. Saat Anda menentukan ID kumpulan dalam SendTextMessage permintaan Anda, layanan hanya memilih identitas asal dari kumpulan itu. Karena semua identitas di kumpulan terdaftar untuk kasus penggunaan yang sama, pesan fallback selalu dikirim dari nomor yang sesuai.

Mengirim perbandingan kepatuhan pendekatan
Pendekatan pengiriman Perilaku fallback SMS Risiko kepatuhan
Pool-based (direkomendasikan) Kembali ke nomor telepon di kolam yang sama, terdaftar untuk kasus penggunaan yang sama Rendah — nomor fallback cocok dengan kasus penggunaan pesan
Account-level Kembali ke nomor telepon khusus atau ID pengirim yang tersedia di akun. Tidak kembali ke rute bersama. Tinggi — nomor fallback mungkin tidak cocok dengan kasus penggunaan pesan jika beberapa kasus penggunaan berbagi akun
Langsung (Agen AWS RCS ARN) Tidak ada SMS fallback Tidak ada — pesan dikirim melalui RCS saja atau tidak sama sekali

Logika fallback dan urutan prioritas

Ketika AWS Pesan Pengguna Akhir memilih identitas asal untuk pesan (baik dari kumpulan atau dari semua identitas akun), itu mengevaluasi identitas dalam urutan prioritas berikut:

  1. Identitas lengket — Jika ada pasangan pengiriman lengket untuk nomor telepon tujuan dan identitas masih tersedia, layanan akan menggunakan identitas tersebut.

  2. Agen AWS RCS — Jika tidak ada pemasangan lengket, layanan akan mencoba pengiriman RCS melalui Agen AWS RCS yang tersedia.

  3. SMS Short Code — Jika RCS tidak tersedia, layanan memilih kode pendek SMS.

  4. SMS 10DLC - Jika tidak ada kode pendek yang tersedia, layanan memilih nomor 10DLC.

  5. Toll-Free Nomor SMS — Jika tidak ada nomor 10DLC yang tersedia, layanan memilih nomor bebas pulsa.

  6. ID Pengirim SMS — Jika tidak ada identitas lain yang tersedia, layanan memilih ID pengirim.

Urutan prioritas ini berlaku dalam lingkup pola pengiriman yang Anda gunakan. Untuk pengiriman berbasis kumpulan, layanan hanya mempertimbangkan identitas dalam kumpulan yang ditentukan. Untuk pengiriman tingkat akun, layanan mempertimbangkan semua identitas di akun Anda.

Fallback SMS otomatis

Saat Anda mengirim pesan melalui kumpulan atau di tingkat akun, Pesan Pengguna AWS Akhir secara otomatis akan kembali ke SMS jika pengiriman RCS tidak memungkinkan. Fallback tidak sinkron:

Jika AWS Pesan Pengguna Akhir berhasil mengirimkan pesan RCS tetapi tidak menerima konfirmasi pengiriman atau sinyal kegagalan dalam waktu 25 detik, layanan akan kembali ke SMS. Ini menangani kasus di mana infrastruktur RCS menerima pesan tetapi pengiriman terhenti (misalnya, perangkat penerima sementara tidak dapat dijangkau, operator tidak mendukung RCS, atau perangkat tidak). RCS-capable

catatan

Pengiriman langsung (menentukan ARN Agen AWS RCS sebagai identitas asal) tidak mendukung fallback SMS otomatis. Jika Anda memerlukan fallback SMS, gunakan pengiriman berbasis pool.

Pengiriman lengket

Pengiriman lengket adalah pengoptimalan routing yang meningkatkan konsistensi pengiriman. Ketika AWS Pesan Pengguna Akhir berhasil mengirimkan pesan ke nomor telepon tujuan menggunakan identitas asal tertentu, layanan akan mengingat pemasangan tersebut selama 25 jam. Pesan berikutnya ke tujuan yang sama dalam jendela 25 jam dialihkan melalui identitas asal yang sama, asalkan masih tersedia di kumpulan atau akun.

Pengiriman lengket berlaku untuk pengiriman RCS dan SMS. Misalnya, jika pesan dikirimkan melalui RCS melalui Agen AWS RCS Anda, pesan berikutnya ke tujuan yang sama dalam waktu 25 jam juga dicoba melalui RCS melalui agen yang sama. Jika pesan sebelumnya dikirim melalui SMS (setelah fallback RCS), pesan berikutnya dicoba melalui SMS melalui nomor telepon yang sama.

Layanan secara berkala mencoba kembali pengiriman RCS bahkan ketika identitas lengket adalah nomor telepon SMS. Ini memastikan bahwa penerima yang perangkatnya mendapatkan dukungan RCS (misalnya, setelah peluncuran operator atau peningkatan perangkat) mulai menerima pesan RCS tanpa intervensi manual.

Karakteristik utama pengiriman lengket:

  • TTL 25 jam — Pasangan lengket berakhir 25 jam setelah pengiriman terakhir yang berhasil. Setelah kedaluwarsa, layanan mengevaluasi kembali urutan prioritas identitas asal untuk pesan berikutnya.

  • Coba ulang RCS otomatis — Bahkan ketika identitas lengket adalah nomor telepon SMS, layanan secara berkala mencoba pengiriman RCS untuk memeriksa apakah penerima sekarang mendukung RCS.

  • Tidak ada pembilasan manual — Anda tidak dapat menyiram atau mengatur ulang pasangan pengiriman lengket secara manual. Pasangan berakhir secara otomatis setelah TTL 25 jam.

Tanda terima pengiriman selama fallback

Ketika fallback SMS terjadi, AWS Pesan Pengguna Akhir menghasilkan tanda terima pengiriman tunggal untuk saluran akhir yang mengirimkan pesan. Jika pesan dikirim melalui SMS setelah fallback RCS, tanda terima pengiriman menunjukkan SMS sebagai saluran pengiriman. Anda dapat menentukan saluran pengiriman dengan memeriksa originationPhoneNumber lapangan dalam acara tersebut. Jika nilainya adalah ID agen RCS, pesan dikirim melalui RCS. Jika nilainya adalah nomor E.164 telepon atau kode pendek, pesan dikirim melalui SMS. Untuk informasi selengkapnya tentang bidang acara, lihatContoh AWS Data acara SMS Pesan Pengguna Akhir.

Dalam keadaan normal, Pesan AWS Pengguna Akhir mencabut pesan RCS sebelum pesan fallback SMS dikirimkan. Ini mencegah penerima menerima pesan yang sama dua kali. Namun, dalam kasus yang jarang terjadi, pesan RCS dan pesan fallback SMS dapat dikirimkan. Hal ini dapat terjadi jika pesan RCS dikirimkan setelah batas waktu 25 detik tetapi sebelum pencabutan selesai. Dalam skenario pengiriman ganda yang langka ini, Anda mungkin menerima tanda terima pengiriman untuk kedua saluran.

Untuk informasi tentang bagaimana pengiriman ganda memengaruhi penagihan, lihatModel penagihan dan harga RCS.

Implikasi penagihan dari fallback SMS

Ketika pesan jatuh kembali dari RCS ke SMS, Anda akan dikenakan biaya untuk pengiriman SMS, bukan upaya RCS yang gagal. Pesan RCS hanya ditagih jika berhasil dikirim ke perangkat penerima. Jika pengiriman RCS gagal dan pesan jatuh kembali ke SMS, Anda membayar tarif SMS untuk pesan itu.

Dalam skenario pengiriman ganda yang jarang terjadi (di mana pesan RCS dan pesan fallback SMS dikirimkan), Anda mungkin dikenakan biaya untuk kedua pengiriman. Untuk detail penagihan lengkap, lihatModel penagihan dan harga RCS.

Menguji fallback SMS

Anda dapat menguji perilaku fallback SMS untuk memverifikasi bahwa pesan Anda dikirim melalui SMS ketika pengiriman RCS tidak memungkinkan. Ada dua pendekatan untuk menguji fallback SMS, tergantung pada apakah Anda memiliki nomor telepon SMS yang disetujui.

Pengujian tanpa nomor SMS yang disetujui

Anda dapat memverifikasi bahwa Pesan AWS Pengguna Akhir memicu mekanisme fallback dengan benar tanpa nomor telepon SMS yang disetujui. Bahkan tanpa nomor yang disetujui, Anda dapat melihat peristiwa percobaan ulang dan kegagalan melalui SMS, yang mengonfirmasi bahwa fallback berfungsi.

Untuk menguji fallback SMS tanpa nomor SMS yang disetujui
  1. Buat perangkat uji Anda offline dengan menonaktifkan data seluler dan Wi-Fi, atau aktifkan mode pesawat.

  2. Kirim pesan RCS ke perangkat uji menggunakan SendTextMessage API dengan ARN Agen AWS RCS Anda sebagai identitas aslinya.

  3. Periksa acara pesan di CloudWatch atau tujuan acara Anda. Anda akan melihat peristiwa pengiriman gagal yang menunjukkan bahwa pengiriman RCS tidak mungkin dilakukan dan bahwa layanan mencoba fallback SMS.

Karena tidak ada nomor telepon SMS yang tersedia untuk fallback, pengiriman SMS juga gagal. Namun, acara tersebut mengonfirmasi bahwa AWS Pesan Pengguna Akhir memicu mekanisme fallback dengan benar.

Pengujian dengan nomor SMS yang disetujui

Untuk pengujian fallback SMS end-to-end lengkap, tambahkan nomor telepon SMS yang disetujui dan Agen AWS RCS Anda ke kumpulan telepon yang sama. Ini memungkinkan Anda untuk memverifikasi bahwa pesan dikirim melalui SMS ketika RCS tidak tersedia.

Untuk menguji fallback SMS dengan nomor SMS yang disetujui
  1. Buat kumpulan telepon yang berisi Agen AWS RCS Anda dan nomor telepon SMS yang disetujui (seperti nomor 10DLC, bebas pulsa, atau kode pendek).

  2. Buat perangkat uji Anda offline dengan menonaktifkan data seluler dan Wi-Fi, atau aktifkan mode pesawat.

  3. Kirim pesan menggunakan SendTextMessage API dengan ID pool sebagai identitas originasi.

  4. Verifikasi bahwa pesan dikirimkan melalui SMS ke perangkat uji Anda.

  5. Periksa acara pengiriman untuk mengonfirmasi bahwa pesan dikirim melalui saluran SMS setelah fallback RCS.

Mengelola Agen AWS RCS di kumpulan

Untuk petunjuk langkah demi langkah tentang membuat kumpulan dengan Agen AWS RCS, menambahkan agen ke kumpulan yang ada, memahami persyaratan konfigurasi kumpulan, dan menghapus agen dari kumpulan, lihatMengelola Agen AWS RCS di pool.