View a markdown version of this page

Menguji pesan RCS - AWS Pesan SMS Pengguna Akhir
Apa itu agen pengujian?Menambahkan perangkat ujiAlur undangan pengujiMelihat perangkat ujiMengirim pesan tesMenguji fallback SMSMemecahkan masalah pengujian RCS

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

Menguji pesan RCS

Sebelum meluncurkan pesan RCS dalam produksi, Anda dapat menguji integrasi menggunakan agen pengujian. Agen pengujian adalah RCS untuk ID Bisnis yang dibuat saat Anda mengirimkan pendaftaran pengujian untuk Agen AWS RCS Anda. Ini menyediakan akses API penuh yang identik dengan produksi, tetapi membatasi pengiriman pesan ke perangkat uji terdaftar saja. Tidak diperlukan persetujuan operator untuk pengujian.

Bab ini berfokus pada agen pengujian itu sendiri, termasuk cara mengelola perangkat uji dan cara memecahkan masalah umum. Untuk panduan langkah demi langkah dalam membuat Agen AWS RCS pertama Anda dan mengirim pesan pengujian, lihatMulai menggunakan RCS. Untuk detail tentang membuat Agen AWS RCS dan mengirimkan pendaftaran pengujian, lihatMengelola agen RCS.

penting

Pesan pengujian dikenakan biaya dengan tarif RCS standar. Agen pengujian menyediakan lingkungan pengujian untuk memvalidasi integrasi Anda, tetapi pengiriman pesan ke perangkat pengujian dikenakan biaya yang sama dengan pesan produksi.

Apa itu agen pengujian?

Agen pengujian adalah RCS untuk ID Bisnis yang dibuat oleh AWS Pesan Pengguna Akhir saat Anda mengirimkan pendaftaran pengujian untuk Agen AWS RCS Anda. Agen pengujian memungkinkan Anda untuk:

  • Kirim pesan RCS ke perangkat uji terdaftar tanpa persetujuan operator

  • Gunakan SendTextMessage API untuk mengirim pesan uji, API yang sama yang Anda gunakan dalam produksi

  • Konfigurasikan kumpulan, kumpulan konfigurasi, daftar pilihan keluar, kata kunci, dan kemampuan Pesan AWS Pengguna Akhir lainnya untuk alur kerja pengujian Anda

  • Uji pesan dua arah dengan mengirim pesan dengan kata kunci respons otomatis

  • Menguji perilaku fallback SMS dengan atau tanpa nomor telepon SMS yang disetujui

Perangkat uji yang Anda daftarkan untuk agen pengujian berfungsi di semua negara untuk Agen AWS RCS tersebut. Anda tidak perlu mendaftarkan perangkat uji secara terpisah untuk setiap negara. Sebaliknya, agen pengujian dapat mengirim pesan ke perangkat pengujian di negara mana pun, terlepas dari apakah Anda telah mengirimkan pendaftaran peluncuran negara untuk negara tersebut.

Menambahkan perangkat uji

Sebelum Anda dapat mengirim pesan RCS uji, Anda harus mendaftarkan satu atau beberapa perangkat uji sebagai nomor tujuan terverifikasi. Anda dapat menambahkan perangkat uji menggunakan konsol Pesan Pengguna Akhir atau CreateVerifiedDestinationNumber API. AWS

Console

Di konsol, perangkat uji dikelola pada sub-tab manajemen penguji RBM di tab Peng ujian Agen AWS RCS Anda. Untuk petunjuk konsol langkah demi langkah, lihatLangkah 2: Tambahkan perangkat uji.

AWS CLI

Gunakan create-verified-destination-number perintah dengan --rcs-agent-id parameter untuk mendaftarkan perangkat uji untuk Agen AWS RCS Anda:

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
catatan

--origination-identityParameter tidak diperlukan. Saat Anda menentukan--rcs-agent-id, perintah mendaftarkan nomor telepon untuk pengujian RCS dengan agen tersebut. Ketika Anda menghilangkan --rcs-agent-id dan menggunakan sebagai --origination-identity gantinya, perintah mengirimkan SMS OTP untuk verifikasi SMS. Kedua parameter tersebut saling eksklusif.

Alur undangan penguji

Setelah Anda menambahkan perangkat uji, Pesan Pengguna AWS Akhir mengirimkan undangan penguji dari agen RCS yang disebut Manajemen Penguji RBM. Undangan berisi tombol untuk menerima atau menolak. Untuk detail tentang alur undangan penguji, termasuk persyaratan tunggu 120 detik dan OS-specific perilaku i, lihatLangkah 2: Tambahkan perangkat uji.

Melihat perangkat uji

Anda dapat melihat perangkat uji yang terdaftar untuk Agen AWS RCS menggunakan konsol AWS Pesan Pengguna Akhir atau DescribeVerifiedDestinationNumbers API.

Console

Untuk melihat perangkat pengujian terdaftar di konsol, buka halaman detail untuk Agen AWS RCS Anda dan pilih tab Peng ujian. Pilih sub-tab manajemen penguji RBM untuk melihat semua nomor tujuan terverifikasi yang terkait dengan agen, termasuk status verifikasi dan nomor telepon mereka.

AWS CLI

Gunakan describe-verified-destination-numbers perintah untuk membuat daftar perangkat pengujian untuk Agen AWS RCS Anda. Gunakan --filters parameter dengan rcs-agent-id untuk hanya menampilkan perangkat uji RCS:

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

Perangkat uji yang Anda daftarkan untuk agen pengujian berfungsi secara global untuk Agen AWS RCS tersebut. Perangkat uji yang terdaftar di satu Wil AWS ayah dapat menerima pesan pengujian yang dikirim dari Wilayah mana pun AWS di mana Agen AWS RCS Anda tersedia.

Mengirim pesan tes

Setelah perangkat uji menerima undangan penguji, Anda dapat mengirim pesan RCS ke perangkat tersebut. Anda dapat mengirim pesan uji menggunakan konsol Pesan Pengguna Akhir atau SendTextMessage API. AWS

Console
Untuk mengirim pesan pengujian menggunakan konsol

  1. Buka konsol AWS Pesan Pengguna Akhir.

  2. Di panel navigasi, di bawah Konfigurasi, pilih agen RCS.

  3. Pilih Agen AWS RCS yang ingin Anda uji.

  4. Pilih tab Pengujian.

  5. Di bagian Kirim pesan pengujian, pilih perangkat uji terverifikasi dari daftar.

  6. Masukkan teks pesan Anda.

  7. Pilih Kirim pesan tes.

AWS CLI

Gunakan send-text-message perintah untuk mengirim pesan uji ke nomor tujuan yang diverifikasi. Tentukan AWS RCS Agent ARN sebagai identitas aslinya:

aws pinpoint-sms-voice-v2 send-text-message \
    --destination-phone-number +12065550100 \
    --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
    --message-body "Hello from RCS testing!"

Menguji fallback SMS

Anda dapat menguji perilaku fallback SMS untuk memverifikasi bahwa pesan Anda dikirim melalui SMS ketika pengiriman RCS tidak memungkinkan. Untuk petunjuk lengkap tentang pengujian fallback SMS, termasuk pengujian tanpa nomor SMS yang disetujui dan alur end-to-end lengkap, lihatMenguji fallback SMS.

Memecahkan masalah pengujian RCS

Bagian berikut menjelaskan masalah umum yang mungkin Anda temui saat menguji pesan RCS dan cara mengatasinya.

Perangkat uji tidak menerima pesan RCS

Jika perangkat uji Anda tidak menerima pesan RCS, periksa hal berikut:

  • Verifikasi bahwa perangkat uji telah menerima undangan penguji. Gunakan DescribeVerifiedDestinationNumbers API dengan rcs-agent-id filter untuk memeriksa status verifikasi perangkat.

  • Verifikasi bahwa perangkat uji telah mengaktifkan RCS. Di Android, periksa pengaturan aplikasi perpesanan untuk fitur RCS atau Obrolan. Di iPhone, RCS memerlukan iOS 18 atau lebih baru.

  • Pastikan perangkat uji memiliki koneksi data aktif. Pesan RCS dikirim melalui data, bukan saluran SMS.

  • Pastikan Anda mengirim ke nomor telepon yang benar dalam E.164 format.

Pesan dikirim sebagai SMS, bukan RCS

Jika pesan pengujian Anda dikirimkan sebagai SMS, bukan RCS, periksa hal berikut:

  • Verifikasi bahwa Anda mengirim pesan menggunakan AWS RCS Agent ARN atau kumpulan yang berisi Agen AWS RCS sebagai identitas aslinya. Jika Anda hanya menentukan nomor telepon SMS, pesan dikirim melalui SMS.

  • Verifikasi bahwa perangkat uji telah menerima undangan penguji dan terdaftar sebagai nomor tujuan terverifikasi untuk Agen AWS RCS yang benar.

  • Periksa acara pengiriman untuk menentukan apakah pesan awalnya dicoba melalui RCS dan kembali ke SMS, atau apakah pesan itu dikirim langsung melalui SMS.

Undangan penguji tidak diterima

Jika perangkat uji tidak menerima undangan penguji, periksa hal berikut:

  • Undangan penguji dapat memakan waktu hingga 20 menit untuk tiba setelah menambahkan perangkat uji. Jika undangan belum tiba setelah 20 menit, lepaskan perangkat uji dan tambahkan lagi.

  • Pastikan nomor telepon dalam E.164 format yang benar dan merupakan nomor ponsel yang valid.

  • Pastikan perangkat uji memiliki koneksi data aktif dan RCS diaktifkan.

iOS: Undangan penguji di Pengirim Tidak Dikenal

Pada perangkat iOS (iPhone dengan iOS 18 atau lebih baru), undangan penguji dari Manajemen Penguji RBM dapat disaring ke folder Pengirim Tidak Dikenal di aplikasi Pesan. Ini adalah perilaku iOS default untuk pesan dari kontak yang tidak dikenal.

Untuk menemukan undangan:

Untuk menemukan undangan penguji di iOS

  1. Buka aplikasi Pesan di iPhone.

  2. Ketuk Filter di sudut kiri atas (atau geser ke kanan dari daftar pesan).

  3. Ketuk Pen girim Tidak Dikenal.

  4. Cari pesan Manajemen Penguji RBM dan ketuk J adikan saya penguji untuk menerima undangan.