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?](rcs-overview.md)
Agen AWS RCS mengikuti siklus hidup ini:
1. **Buat** AWS RCS Agent.
1. **Tambahkan agen pengujian** (termasuk dalam alur pembuatan konsol; opsional melalui CLI).
1. **Uji** pesan RCS Anda dengan perangkat uji terdaftar. Tidak diperlukan persetujuan operator untuk pengujian.
1. **Kirim pendaftaran peluncuran negara** untuk setiap negara tempat Anda ingin mengirim pesan RCS produksi.
1. **Disetujui sebagian**: setidaknya satu operator telah menyetujui agen Anda. Anda dapat mulai mengirim ke penerima pada operator yang disetujui.
1. **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.
**Topics**
+ [Memahami Agen AWS RCS](#rcs-agents-concept)
+ [Memahami model identitas dua tingkat](#rcs-agents-identity-model)
+ [Membuat Agen AWS RCS](#rcs-agents-create)
+ [Memperbarui Agen AWS RCS](#rcs-agents-update)
+ [Melihat Agen AWS RCS](#rcs-agents-view)
+ [Meninjau agen pengujian Anda](#rcs-agents-review-test-agent)
+ [Melihat status peluncuran negara](#rcs-agents-country-launch-status)
+ [Menghapus Agen AWS RCS](#rcs-agents-delete)
## 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` dan`DeleteRcsAgent`.
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. `CountryStatus`Untuk 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, lihat[Langkah 1: Buat AWS RCS Agent Anda dan kirimkan pendaftaran pengujian](rcs-getting-started.md#rcs-getting-started-create-agent).
------
#### [ 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`
1. Panggil `DeleteRcsAgent` API dengan ID agen atau ARN dari AWS RCS Agent yang ingin Anda hapus.
1. Verifikasi bahwa agen telah dihapus dengan memanggil `DescribeRcsAgents` API. Agen seharusnya tidak lagi muncul dalam hasil, atau statusnya harus DIHAPUS.