View a markdown version of this page

Mengelola agen RCS - AWS SMS Pesan Pengguna Akhir
Memahami Agen AWS RCSMemahami model identitas dua tingkatMembuat Agen AWS RCSMemperbarui Agen AWS RCSMelihat Agen AWS RCSMeninjau agen pengujian AndaMelihat status peluncuran negaraMenghapus Agen AWS RCS

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

Mengelola agen RCS

Agen AWS RCS adalah sumber daya tingkat atas di AWS End User Messaging yang mewakili merek Anda untuk pesan RCS. Ini berfungsi sebagai sumber daya terpadu yang mengikat agen pengujian Anda dan agen peluncuran negara (RCS for Business). IDs Kata kunci dan konfigurasi pesan dua arah ditentukan pada AWS RCS Agent. Aset merek ditentukan pada setiap pendaftaran (agen pengujian atau agen peluncuran negara). Untuk gambaran umum tentang bagaimana AWS RCS Agent berhubungan dengan RCS for Business IDs, lihat. Apa itu RCS?

Agen AWS RCS mengikuti siklus hidup ini:

  1. Buat AWS RCS Agent.

  2. Tambahkan agen pengujian (termasuk dalam alur pembuatan konsol; opsional melalui CLI).

  3. Uji pesan RCS Anda dengan perangkat uji terdaftar. Tidak diperlukan persetujuan operator untuk pengujian.

  4. Kirim pendaftaran peluncuran negara untuk setiap negara tempat Anda ingin mengirim pesan RCS produksi.

  5. Disetujui sebagian: setidaknya satu operator telah menyetujui agen Anda. Anda dapat mulai mengirim ke penerima pada operator yang disetujui.

  6. Sepenuhnya disetujui: semua operator di negara ini telah menyetujui agen Anda. Jangkauan penuh di negara itu.

Satu AWS RCS Agent memetakan ke satu agen pengujian (RCS untuk ID Bisnis) ditambah beberapa agen peluncuran negara (satu RCS untuk ID Bisnis per negara). Saat Anda membuat AWS RCS Agent di konsol, alur kerja langsung memandu Anda untuk membuat agen pengujian. Konfigurasi merek agen pengujian kemudian digunakan untuk mengisi formulir pendaftaran peluncuran negara sebelumnya, mengurangi entri data duplikatif.

Memahami Agen AWS RCS

AWS RCS Agent berbeda dari RCS for Business IDs yang dikelola. Tabel berikut merangkum perbedaan:

AWS RCS Agent dibandingkan dengan RCS untuk ID Bisnis
Atribut Agen AWS RCS RCS untuk ID Bisnis
Dikelola oleh Anda, melalui konsol AWS End User Messaging atau API AWS End User Messaging, selama proses pendaftaran
Lingkup Satu per merek atau per kasus penggunaan Satu peluncuran per negara, ditambah satu agen pengujian
Konfigurasi Nama ramah, perlindungan penghapusan, daftar opt-out, tag, kata kunci, tujuan pesan dua arah Aset merek dan pengaturan lain yang ditentukan selama pendaftaran
Pengidentifikasi rcs-a1b2c3d4format Dikelola secara internal oleh penyedia infrastruktur RCS

ID Agen dan ARN

Setiap AWS RCS Agent memiliki pengenal unik dalam format rcs-a1b2c3d4 (awalan rcs- diikuti oleh string heksadesimal). Anda menggunakan ID ini saat memanggil operasi API seperti UpdateRcsAgent danDeleteRcsAgent.

Setiap AWS RCS Agent juga memiliki ARN AWS sumber daya dalam format berikut:

arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id

Anda dapat menggunakan ARN saat menentukan AWS RCS Agent sebagai identitas originasi di SendTextMessage API atau saat menambahkan agen ke kumpulan telepon.

Status siklus hidup

AWS RCS Agent bertransisi melalui status siklus hidup berikut:

DIBUAT

Sumber daya AWS RCS Agent telah dibuat di AWS End User Messaging, tetapi belum ada pendaftaran yang dikirimkan. Anda dapat memperbarui aset dan konfigurasi merek di negara bagian ini.

TERTUNDA

Pendaftaran telah diajukan dan sedang menunggu pemrosesan. Agen belum tersedia untuk mengirim pesan.

PENGUJIAN

Pendaftaran pengujian telah disetujui. Agen memiliki agen pengujian (RCS untuk ID Bisnis) dan dapat mengirim pesan ke perangkat uji terdaftar. Tidak ada pendaftaran peluncuran negara yang diselesaikan.

SEBAGIAN

Setidaknya satu pendaftaran peluncuran negara telah selesai, tetapi tidak semua peluncuran negara yang dikirimkan aktif. Agen dapat mengirim pesan di negara-negara di mana ia telah disetujui, tetapi hanya untuk penerima pada operator tertentu yang telah menyetujui agen. CountryStatusUntuk suatu negara pindah ke PARAL segera setelah setidaknya satu operator di negara itu aktif.

AKTIF

Semua pendaftaran peluncuran negara yang dikirimkan lengkap dan aktif. Agen beroperasi penuh di semua negara yang terdaftar. Perhatikan bahwa agen AKTIF dapat kembali ke status PARAL ketika pendaftaran peluncuran negara baru diajukan, karena negara baru belum disetujui.

DIHAPUS

Agen AWS RCS telah dihapus. Semua RCS terkait untuk Bisnis IDs (agen pengujian dan peluncuran negara) dinonaktifkan. Tindakan ini tidak dapat dibatalkan.

Memahami model identitas dua tingkat

RCS dalam AWS End User Messaging menggunakan model identitas dua tingkat: AWS RCS Agent dan satu atau lebih RCS for Business. IDs

Agen AWS RCS

AWS RCS Agent adalah sumber daya tingkat atas yang Anda buat dan kelola di AWS End User Messaging. Ini berfungsi sebagai sumber daya terpadu yang mengikat agen pengujian dan agen peluncuran negara Anda. Kata kunci dan konfigurasi pesan dua arah ditentukan pada AWS RCS Agent. Aset merek ditentukan pada setiap pendaftaran. Setiap AWS RCS Agent memiliki pengenal unik dalam format rcs-a1b2c3d4 dan sumber daya AWS ARN. Pikirkan Agen AWS RCS sebagai identitas terpadu untuk merek Anda di semua negara tempat Anda meluncurkan RCS.

RCS untuk ID Bisnis

RCS for Business ID adalah identitas agen per negara yang dibuat dengan penyedia infrastruktur RCS selama proses pendaftaran. Setiap peluncuran negara membuat RCS terpisah untuk ID Bisnis di bawah Agen AWS RCS Anda. Anda tidak mengelola RCS for Business IDs secara langsung. AWS End User Messaging menangani pembuatan dan siklus hidup sebagai bagian dari proses pendaftaran.

Satu AWS RCS Agent dapat memiliki RCS untuk Bisnis berikut: IDs

  • Satu agen pengujian — RCS untuk ID Bisnis yang dibuat selama tahap pendaftaran pengujian. Agen pengujian bekerja dengan perangkat uji terdaftar dan memungkinkan Anda untuk memvalidasi integrasi RCS Anda sebelum diluncurkan dalam produksi. Pesan pengujian dibebankan pada tarif standar.

  • Beberapa agen peluncuran negara — Setiap negara tempat Anda meluncurkan RCS membuat RCS terpisah untuk ID Bisnis. Misalnya, jika Anda meluncurkan di Amerika Serikat dan Kanada, Agen AWS RCS Anda memiliki dua agen peluncuran negara (satu RCS AS untuk ID Bisnis dan satu RCS Kanada untuk ID Bisnis) selain agen pengujian.

Diagram berikut menunjukkan hubungan antara identitas ini:


AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (US RCS for Business ID)
└── CA country launch agent (Canada RCS for Business ID)

Kata kunci dan tujuan pengiriman pesan dua arah dikonfigurasi di AWS RCS Agent dan berlaku untuk semua RCS for Business terkait. IDs Aset merek khusus untuk setiap pendaftaran (agen pengujian atau agen peluncuran negara). AWS RCS Agent juga memiliki pengaturan tingkat akun seperti nama ramah, perlindungan penghapusan, dan daftar opt-out.

Membuat Agen AWS RCS

Anda dapat membuat AWS RCS Agent menggunakan konsol AWS End User Messaging atau CreateRcsAgent API. Saat membuat agen, Anda memberikan nama ramah di konsol (label khusus konsol yang disimpan sebagai tag, tidak terlihat melalui API atau ditampilkan di ponsel penerima) dan mengonfigurasi pengaturan opsional seperti perlindungan penghapusan dan asosiasi daftar opt-out. Aset merek ditentukan pada pendaftaran, bukan pada Agen AWS RCS itu sendiri.

Persyaratan aset merek

Aset merek Anda ditampilkan kepada penerima di samping pesan RCS Anda. Aset merek dikirimkan sebagai bagian dari pendaftaran pengujian, yang disajikan konsol sebagai kelanjutan dari alur kerja pembuatan agen. Aset berikut diperlukan saat membuat Agen AWS RCS:

Logo

Gambar persegi yang mewakili merek Anda. Logo muncul di aplikasi perpesanan di samping pesan Anda.

  • Dimensi: 224 × 224 piksel

  • Format: PNG dengan transparansi

  • Ukuran file maksimal: 50 KB

Gambar spanduk

Gambar lebar yang muncul di bagian atas profil agen Anda di aplikasi perpesanan. Gambar spanduk hanya ditampilkan di perangkat Android.

  • Dimensi: 1440 × 448 piksel

  • Format: PNG atau JPEG

  • Ukuran file maksimal: 200 KB

Warna merek

Kode warna hex (misalnya,#1A73E8) digunakan sebagai warna aksen di aplikasi perpesanan. Warna harus memiliki rasio kontras minimum 4.5:1 terhadap latar belakang putih untuk memenuhi persyaratan aksesibilitas. Jika rasio kontras tidak diatur dengan benar, agen Anda mungkin tidak disetujui.

penting

Aset merek memiliki batasan perubahan setelah agen dibuat. Beberapa aset merek tidak dapat dimodifikasi setelah agen diserahkan untuk pendaftaran. Siapkan aset merek akhir Anda sebelum membuat Agen AWS RCS Anda.

Console

Konsol Pesan Pengguna AWS Akhir menyajikan pembuatan AWS RCS Agent dan pendaftaran pengujian sebagai alur kerja tunggal yang dipandu. Untuk petunjuk step-by-step konsol, lihatLangkah 1: Buat AWS RCS Agent Anda dan kirimkan pendaftaran pengujian.

AWS CLI

Gunakan create-rcs-agent perintah untuk membuat AWS RCS Agent. Aset merek (nama tampilan, deskripsi, logo, spanduk, dan warna merek) bukan parameter dari perintah ini. Mereka dikirimkan sebagai bidang pendaftaran saat Anda membuat pendaftaran pengujian.

aws pinpoint-sms-voice-v2 create-rcs-agent \
    --deletion-protection-enabled

Parameter opsional berikut tersedia:

  • --deletion-protection-enabled— Mencegah agen dihapus sampai perlindungan penghapusan dinonaktifkan.

  • --opt-out-list-name— Mengaitkan daftar opt-out yang ada dengan agen.

  • --tags— Pasangan nilai kunci untuk mengatur dan mengidentifikasi Agen AWS RCS Anda.

Memperbarui Agen AWS RCS

Gunakan UpdateRcsAgent API untuk mengubah pengaturan Agen AWS RCS yang ada. Anda dapat memperbarui pengaturan berikut:

  • Perlindungan penghapusan - Mengaktifkan atau menonaktifkan perlindungan penghapusan untuk agen.

  • Daftar opt-out — Kaitkan atau pisahkan daftar opt-out dengan agen.

  • Tujuan pengiriman pesan dua arah — Konfigurasikan topik Amazon SNS dan peran IAM tempat pesan masuk dikirimkan. Pesan dua arah selalu diaktifkan untuk RCS. Pelanggan dikenakan biaya untuk semua pesan RCS masuk dengan tarif standar. Pengaturan ini mengontrol tempat pesan masuk dikirim, bukan apakah pesan tersebut diterima.

catatan

Perubahan pada pengaturan AWS RCS Agent Anda melalui API segera tersedia. Namun, pembaruan aset merek (bidang pendaftaran seperti logo, spanduk, dan nama tampilan) ditinjau oleh penyedia infrastruktur RCS dan mungkin memerlukan waktu untuk muncul di perangkat penerima. Untuk memverifikasi bahwa perubahan API Anda telah diterapkan, gunakan DescribeRcsAgents API untuk mengonfirmasi konfigurasi agen saat ini di AWS End User Messaging.

Melihat Agen AWS RCS

Anda dapat melihat Agen AWS RCS menggunakan konsol AWS End User Messaging atau DescribeRcsAgents API.

Console

Untuk melihat Agen AWS RCS Anda di konsol, buka halaman agen RCS di bawah Konfigurasi di panel navigasi. Halaman daftar menampilkan semua Agen AWS RCS di akun Anda, termasuk status siklus hidup saat ini, ID agen, dan nama tampilannya.

Pilih agen untuk melihat detailnya, termasuk aset merek, pengaturan konfigurasi, dan pendaftaran terkait.

AWS CLI

Gunakan describe-rcs-agents perintah untuk mencantumkan semua Agen AWS RCS di akun Anda:

aws pinpoint-sms-voice-v2 describe-rcs-agents

Untuk mengambil detail untuk agen tertentu, gunakan --rcs-agent-ids parameter:

aws pinpoint-sms-voice-v2 describe-rcs-agents \
    --rcs-agent-ids rcs-a1b2c3d4

Meninjau agen pengujian Anda

Sebelum mengirimkan pendaftaran peluncuran negara, tinjau konfigurasi agen pengujian Anda untuk memastikan aset merek, kata kunci, dan pengaturan pesan Anda benar. Agen pengujian berfungsi sebagai templat untuk pendaftaran peluncuran negara, jadi masalah apa pun harus diselesaikan sebelum melanjutkan.

Untuk meninjau agen pengujian Anda, navigasikan ke Agen AWS RCS Anda di konsol Pesan Pengguna AWS Akhir dan pilih tab Pendaftaran. Registrasi pengujian menunjukkan konfigurasi merek Anda saat ini, termasuk logo, gambar spanduk, warna merek, dan nama tampilan saat muncul di perangkat penerima.

Anda juga dapat menggunakan DescribeRegistrationFieldValues API untuk mengambil nilai bidang saat ini untuk pendaftaran pengujian Anda secara terprogram.

Melihat status peluncuran negara

Setelah mengirimkan pendaftaran peluncuran negara untuk Agen AWS RCS Anda, Anda dapat melacak status persetujuan untuk setiap operator di negara tersebut.

Console

Untuk melihat status peluncuran negara di konsol, buka halaman detail untuk AWS RCS Agent Anda dan pilih tab Status peluncuran negara. Tab ini menampilkan status persetujuan untuk setiap operator di setiap negara tempat Anda telah mengirimkan pendaftaran peluncuran.

AWS CLI

Gunakan describe-rcs-agent-country-launch-status perintah untuk mengambil status peluncuran per-operator:

aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \
    --rcs-agent-id rcs-a1b2c3d4

Tanggapan tersebut mencakup status persetujuan untuk setiap operator di setiap negara tempat Anda telah mengirimkan pendaftaran peluncuran.

Setiap operator secara independen meninjau dan menyetujui agen Anda. Agen AWS RCS Anda dapat mengirim pesan di suatu negara segera setelah setidaknya satu operator di negara tersebut menyetujui agen tersebut. Anda tidak perlu menunggu semua operator menyetujui sebelum Anda dapat mulai mengirim pesan RCS. Karena operator tambahan menyetujui agen Anda, jangkauan Anda di negara itu meningkat.

catatan

Anda dapat meminta peluncuran negara tambahan dari layar status peluncuran negara. Setiap peluncuran negara baru membuat pendaftaran terpisah dan melalui proses persetujuan operator sendiri.

Menghapus Agen AWS RCS

Gunakan DeleteRcsAgent API untuk menghapus Agen AWS RCS secara permanen. Saat Anda menghapus agen, semua RCS terkait untuk Bisnis IDs (termasuk agen pengujian dan semua agen peluncuran negara) dinonaktifkan.

Awas

Menghapus Agen AWS RCS bersifat permanen dan tidak dapat dibatalkan. Semua pendaftaran, peluncuran negara, dan konfigurasi pengujian yang terkait dengan agen hilang.

Sebelum Anda dapat menghapus Agen AWS RCS, Anda harus terlebih dahulu menghapus semua pendaftaran terkait (baik pendaftaran pengujian maupun peluncuran negara), lalu menonaktifkan perlindungan penghapusan. Jika perlindungan penghapusan diaktifkan, DeleteRcsAgent API mengembalikan kesalahan. Untuk menonaktifkan perlindungan penghapusan, gunakan UpdateRcsAgent API dengan perlindungan penghapusan yang disetel ke. false

Untuk menghapus Agen AWS RCS

  1. Jika proteksi penghapusan diaktifkan, nonaktifkan dengan memanggil UpdateRcsAgent API dengan perlindungan penghapusan yang disetel ke. false

  2. Panggil DeleteRcsAgent API dengan ID agen atau ARN dari AWS RCS Agent yang ingin Anda hapus.

  3. Verifikasi bahwa agen telah dihapus dengan memanggil DescribeRcsAgents API. Agen seharusnya tidak lagi muncul dalam hasil, atau statusnya harus DIHAPUS.