View a markdown version of this page

Mengirim pesan RCS yang kaya dari konsol - AWSSMS Pesan Pengguna Akhir
PrasyaratMengirim pesan RCS yang kayaValidasi masukanSumber daya terkait

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

Mengirim pesan RCS yang kaya dari konsol

Konsol AWS End User Messaging menyediakan komposer pesan visual yang dapat Anda gunakan untuk membangun dan mengirim pesan RCS kaya tanpa menulis kode. Komposer memetakan langsung ke SendRcsMessage API dan mendukung semua jenis konten: pesan teks, pesan file, kartu kaya, dan komidi putar. Anda dapat melampirkan saran interaktif ke semua jenis pesan, mengonfigurasi pengaturan time-to-live (TTL), dan mengatur fallback SMS atau MMS untuk penerima yang perangkatnya tidak mendukung RCS.

Anda menulis dan mengirim pesan kaya dari tab Pesan uji keluar dari antarmuka pengujian RCS. Pesan dikirim ke penguji RBM terverifikasi sehingga Anda dapat memvalidasi rendering dan pengiriman sebelum mengintegrasikan API ke SendRcsMessage dalam aplikasi Anda.

Saat Anda mengonfigurasi pesan, pratinjau telepon real-time menampilkan cara pesan dirender di perangkat penerima. Anda juga dapat menyalin payload JSON atau perintah AWS CLI yang setara untuk menggunakan struktur pesan yang sama dalam kode aplikasi Anda.

Untuk informasi selengkapnya tentang jenis pesan dan struktur API-nya, lihatMengirim pesan RCS yang kaya. Untuk detail tentang jenis dan perilaku saran, lihatMengkonfigurasi saran RCS.

Prasyarat

Sebelum Anda mengirim pesan RCS yang kaya dari konsol, konfirmasikan hal berikut:

  • Agen RCS Anda dalam keadaan Pengujian atau Aktif.

  • Anda memiliki setidaknya satu nomor telepon penguji RBM terverifikasi yang terkait dengan agen Anda. Untuk petunjuk penyiapan, lihatMenguji pesan RCS.

  • Jika Anda berencana mengirim file media dari Amazon S3, bucket S3 harus memiliki kebijakan bucket yang memberikan sms-voice.amazonaws.com akses baca. Lihat perinciannya di Mengirim pesan file RCS.

Mengirim pesan RCS yang kaya

Gunakan prosedur berikut untuk menulis dan mengirim pesan RCS kaya dari konsol AWS End User Messaging.

  1. Buka konsol AWS End User Messaging dihttps://console.aws.amazon.com/sms-voice/.

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

  3. Pilih agen yang ingin Anda gunakan sebagai identitas originasi. Status agen harus Pengujian atau Aktif.

  4. Pilih tab Pengujian.

  5. Di antarmuka pengujian RCS, pilih tab Pesan uji keluar.

  6. Di bagian Kirim pesan RCS uji, untuk Pilih penguji RBM, pilih nomor telepon penguji RBM terverifikasi.

  7. (Opsional) Untuk set Konfigurasi, pilih set konfigurasi untuk melacak peristiwa pesan.

  8. Untuk Pilih API, pilih SendRcsMessage.

  9. Untuk Pilih format pesan, pilih jenis pesan yang ingin Anda kirim:

    • Teks: Masukkan badan pesan (hingga 3.072 karakter).

    • File: Untuk sumber media, pilih bucket S3 atau URL Publik, lalu masukkan URI S3 (atau URL HTTPS) file yang akan dikirim. Pilih Browse S3 untuk memilih file dari bucket, atau Lihat untuk membuka file yang direferensikan di tab browser baru. Ukuran file maksimum adalah 100 MB. Secara opsional, berikan URL thumbnail untuk file video atau PDF.

    • Kartu kaya: Konfigurasikan bidang kartu berikut. Setidaknya satu judul, deskripsi, atau media diperlukan.

      • Orientasi kartu: Pilih VERTICAL atauHORIZONTAL.

      • Judul kartu: Masukkan judul (hingga 200 karakter).

      • Deskripsi kartu: Masukkan deskripsi (hingga 2.000 karakter).

      • URL Media: Untuk sumber media, pilih bucket S3 atau URL Publik, lalu masukkan URI S3 (atau URL HTTPS). Pilih Browse S3 untuk memilih file, atau Lihat untuk membukanya di tab browser baru. Ukuran file maksimum adalah 100 MB.

      • (Opsional) URL thumbnail media: Gambar pratinjau ditampilkan sebelum media penuh dimuat.

      • (Hanya orientasi HORIZONTAL) Penjajaran thumbnail: Pilih LEFT atau RIGHT untuk memposisikan gambar mini.

      • Saran kartu: Tambahkan hingga 4 saran yang ditampilkan sebagai tombol dalam batas kartu. Untuk jenis saran, lihatMengkonfigurasi saran RCS.

    • Carousel: Konfigurasikan berikut ini:

      • Lebar kartu: Pilih SMALL atauMEDIUM.

      • Tinggi media (semua kartu): Pilih SHORT atauMEDIUM. Semua kartu dalam korsel menggunakan ketinggian media yang sama.

      • Kartu: Tambahkan antara 2 dan 10 kartu. Setiap kartu menyertakan judul kartu, deskripsi kartu, URL media (bucket S3 atau URL publik, maksimum 100 MB), dan hingga 4 saran kartu. Setidaknya satu judul, deskripsi, atau media diperlukan untuk setiap kartu.

    • JSON: Tempelkan muatan RcsMessageContent JSON mentah secara langsung. Pilih Format JSON untuk memformat payload. Konsol memvalidasi struktur dan memperbarui pratinjau telepon secara real time.

  10. (Opsional) Konfigurasikan file media menggunakan browser S3:

    1. Pilih Jelajahi S3.

    2. Pilih bucket dari daftar dropdown.

    3. Arahkan melalui awalan (folder) untuk menemukan file Anda.

    4. Pilih file. Bidang URL terisi secara otomatis.

    catatan

    Bucket S3 harus memiliki kebijakan bucket yang memberikan akses sms-voice.amazonaws.com baca ke objek. Untuk kebijakan yang diperlukan, lihatMengirim pesan file RCS.

  11. (Opsional) Tambahkan saran tingkat pesan. Di bagian Saran:

    1. Pilih Tambahkan saran.

    2. Untuk jenis Saran, pilih salah satu dari Balas, Buka URL, Panggil Telepon, Tampilkan Lokasi, Permintaan Lokasi, atau Acara Kalender.

    3. Masukkan bidang yang diperlukan untuk jenis yang dipilih. Semua jenis saran memerlukan Text nilai (hingga 25 karakter) dan PostbackData (hingga 2.048 karakter).

    4. Ulangi untuk menambahkan hingga 11 saran tingkat pesan.

    Message-level saran ditampilkan sebagai daftar chip di bawah seluruh pesan. Anda dapat melampirkan saran tingkat pesan ke jenis konten apa pun (teks, file, kartu kaya, atau korsel). Lihat perinciannya di Mengkonfigurasi saran RCS.

  12. (Opsional) Konfigurasikan pengaturan time-to-live (TTL). Perluas Opsi lanjutan dan masukkan nilai di bidang Waktu untuk hidup (detik). Nilai yang valid berkisar dari 1 hingga 172.800 detik (48 jam). Nilai minimum 10 detik disarankan.

    Jika pesan tidak terkirim sebelum TTL kedaluwarsa, layanan akan memicu peristiwa kedaluwarsa TTL. Jika Anda mengonfigurasi fallback, pesan fallback dikirim pada saat itu.

    Bagian Advanced options juga berisi Max price (USD), Dry run, Message feedback, Protect configuration, dan Context (metadata nilai kunci opsional).

  13. (Opsional) Konfigurasikan fallback SMS atau MMS. Perluas bagian konfigurasi Fallback:

    1. Untuk saluran Fallback, pilih SMS atau MMS.

    2. Untuk isi pesan Fallback, masukkan teks pesan (hingga 1.600 karakter). Badan pesan diperlukan saat saluran fallback dipilih.

    3. Untuk MMS, Anda juga dapat menyediakan satu atau beberapa URL media.

    4. Untuk identitas Origination, masukkan nomor telepon atau ID pengirim yang akan digunakan untuk pesan fallback SMS atau MMS. Ini diperlukan saat mengirim dari agen RCS.

    Fallback dipicu ketika pesan tidak dapat dikirim melalui RCS (misalnya, ketika perangkat penerima tidak mendukung RCS atau ketika TTL kedaluwarsa). Untuk informasi selengkapnya, lihat Mengirim pesan RCS yang kaya.

  14. (Opsional) Dalam opsi Lanjutan, aktifkan Dry run untuk memvalidasi struktur pesan tanpa mengirim. Ini tidak menimbulkan biaya dan tidak mengirimkan pesan ke penerima.

  15. Tinjau pratinjau telepon di sisi kanan komposer. Pembaruan pratinjau secara real time dan menunjukkan:

    • Rendering konten (teks, media, tata letak kartu, gulir korsel)

    • Chip saran di bawah pesan

    • Card-level tombol dalam kartu

    catatan

    Pratinjau mendekati rendering Android. Tampilan di iOS atau klien RCS lainnya mungkin berbeda. Pratinjau tidak mensimulasikan perilaku pemilihan saran.

  16. Pilih Kirim pesan pengujian untuk mengirim pesan ke penguji RBM yang dipilih, atau gunakan salah satu opsi berikut:

    • Salin JSON: Menyalin pesan JSON ke clipboard Anda. Pilih RcsMessageContentuntuk menyalin hanya bagian konten, atau permintaan API Lengkap untuk menyalin isi SendRcsMessage permintaan lengkap.

    • Salin perintah CLI: Menyalin perintah yang setaraaws pinpoint-sms-voice-v2 send-rcs-message.

Validasi masukan

Konsol melakukan validasi real-time saat Anda mengonfigurasi pesan. Kesalahan validasi ditampilkan sebaris di sebelah bidang yang terpengaruh. Tabel berikut merangkum aturan validasi.

Aturan validasi konsol
Bidang Aturan
Nomor telepon Harus E.164 format
URL Media Harus dimulai dengan https:// atau s3://
Ukuran file media Maksimum 100 MB
Teks saran Maksimal 25 karakter
Data postback Maksimal 2.048 karakter
Judul kartu Maksimal 200 karakter
Deskripsi kartu Maksimal 2.000 karakter
Kartu korsel Minimal 2, maksimal 10
Card-level saran Maksimal 4 per kartu
Message-level saran Maksimal 11
Badan pesan teks Maksimal 3.072 karakter
TTL 1 hingga 172.800 detik
Badan pesan fallback Maksimal 1.600 karakter