View a markdown version of this page

Menguji pesan RCS - AWS SMS Pesan Pengguna Akhir
Apa itu agen pengujian?Menambahkan perangkat ujiAlur undangan pengujiMelihat perangkat ujiMengirim pesan ujiMenguji 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 Anda 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 step-by-step panduan cara membuat AWS RCS Agent pertama Anda dan mengirim pesan pengujian, lihat. Memulai dengan RCS Untuk detail tentang membuat Agen AWS RCS dan mengirimkan pendaftaran pengujian, lihat. Mengelola agen RCS

penting

Pesan pengujian dibebankan pada tarif RCS standar. Agen pengujian menyediakan lingkungan pengujian untuk memvalidasi integrasi Anda, tetapi pengiriman pesan ke perangkat pengujian menimbulkan biaya yang sama seperti pesan produksi.

Apa itu agen pengujian?

Agen pengujian adalah RCS untuk ID Bisnis yang dibuat Pesan Pengguna AWS 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 pengujian, API yang sama yang Anda gunakan dalam produksi

  • Konfigurasikan pool, set konfigurasi, daftar opt-out, kata kunci, dan kemampuan AWS End User Messaging lainnya untuk alur kerja pengujian Anda

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

  • Uji 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 uji 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 pengujian, Anda harus mendaftarkan satu atau beberapa perangkat uji sebagai nomor tujuan terverifikasi. Anda dapat menambahkan perangkat uji menggunakan konsol AWS End User Messaging atau CreateVerifiedDestinationNumber API.

Console

Di konsol, perangkat uji ditambahkan sebagai bagian dari alur kerja pembuatan AWS RCS Agent. Untuk petunjuk step-by-step konsol, lihatLangkah 2: Tambahkan perangkat uji.

AWS CLI

Gunakan create-verified-destination-number perintah dengan --rcs-agent-id parameter untuk mendaftarkan perangkat uji untuk AWS RCS Agent 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 itu. Ketika Anda menghilangkan --rcs-agent-id dan menggunakan --origination-identity sebagai gantinya, perintah mengirimkan SMS OTP untuk verifikasi SMS. Kedua parameter tersebut saling eksklusif.

Alur undangan penguji

Setelah Anda menambahkan perangkat uji, AWS End User Messaging mengirimkan undangan tester dari agen RCS yang disebut RBM Tester Management. Undangan berisi tombol untuk menerima atau menolak. Untuk detail tentang alur undangan penguji, termasuk persyaratan menunggu 120 detik dan perilaku khusus iOS, lihat. Langkah 2: Tambahkan perangkat uji

Melihat perangkat uji

Anda dapat melihat perangkat uji yang terdaftar untuk AWS RCS Agent menggunakan konsol AWS End User Messaging atau DescribeVerifiedDestinationNumbers API.

Console

Untuk melihat perangkat pengujian terdaftar Anda di konsol, buka halaman detail untuk AWS RCS Agent Anda dan pilih tab Pengujian. Tab menampilkan semua nomor tujuan terverifikasi yang terkait dengan agen, termasuk status verifikasi dan nomor teleponnya.

AWS CLI

Gunakan describe-verified-destination-numbers perintah untuk membuat daftar perangkat pengujian untuk AWS RCS Agent Anda. Gunakan --filters parameter dengan rcs-agent-id 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 AWS Wilayah dapat menerima pesan pengujian yang dikirim dari AWS Wilayah mana pun di mana Agen AWS RCS Anda tersedia.

Mengirim pesan uji

Setelah perangkat uji menerima undangan penguji, Anda dapat mengirim pesan RCS ke sana. Anda dapat mengirim pesan pengujian menggunakan konsol AWS End User Messaging atau SendTextMessage API.

Console
Untuk mengirim pesan pengujian menggunakan konsol

  1. Buka konsol AWS End User Messaging.

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

  3. Pilih AWS RCS Agent 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 uji.

AWS CLI

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

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 instruksi lengkap tentang pengujian fallback SMS, termasuk pengujian tanpa nomor SMS yang disetujui dan end-to-end aliran penuh, lihat. Menguji 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 pengujian 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 membutuhkan iOS 18 atau lebih baru.

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

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

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 AWS RCS Agent sebagai identitas originasi. Jika Anda hanya menentukan nomor telepon SMS, pesan dikirim melalui SMS.

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

  • Periksa acara pengiriman untuk menentukan apakah pesan tersebut awalnya dicoba melalui RCS dan kembali ke SMS, atau apakah 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.

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

  • Verifikasi bahwa perangkat uji memiliki koneksi data aktif dan RCS diaktifkan.

iOS: Undangan penguji di Pengirim Tidak Dikenal

Di perangkat iOS (iPhone dengan iOS 18 atau versi lebih baru), undangan penguji dari Manajemen Penguji RBM dapat difilter 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 Pengirim Tidak Dikenal.

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