Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola Agen AWS RCS di pool
Anda dapat menambahkan Agen AWS RCS sebagai identitas originasi di kumpulan telepon bersama nomor telepon SMS Anda. Ketika pool berisi nomor telepon AWS RCS Agent dan SMS, AWS End User Messaging mencoba pengiriman RCS terlebih dahulu dan secara otomatis kembali ke SMS jika pengiriman RCS tidak memungkinkan. Untuk detail tentang cara kerja fallback, lihat. [RCS ke SMS fallback menggunakan kolam telepon](rcs-sms-fallback.md)
**catatan**
Saat Anda menambahkan AWS RCS Agent ke pool, gunakan `ZZ` sebagai kode negara ISO. `ZZ`Kode tersebut menunjukkan bahwa agen RCS tidak spesifik negara di tingkat pool. Perutean khusus negara ditangani melalui pendaftaran peluncuran negara agen. Sebuah pool dapat berisi nomor telepon dari beberapa negara bersama agen RCS.
Kode negara ISO disediakan pada waktu pembuatan kumpulan tetapi tidak disimpan di kolam renang. Jika Anda menelepon`DescribePools`, kode negara ISO tidak muncul dalam respons.
## Membuat pool dengan AWS RCS Agent
Anda dapat membuat kumpulan baru yang menyertakan AWS RCS Agent menggunakan konsol AWS End User Messaging atau `CreatePool` API.
------
#### [ Console ]
**Untuk membuat pool dengan AWS RCS Agent menggunakan konsol**
1. Buka konsol AWS End User Messaging.
1. Di panel navigasi, pilih **Kolam telepon**.
1. Pilih **Buat kolam**.
1. Untuk **identitas Origination**, pilih AWS RCS Agent Anda. Pool mewarisi konfigurasinya dari identitas originasi yang Anda pilih.
1. Konfigurasikan pengaturan pool sesuai kebutuhan, lalu pilih **Create pool**.
1. Setelah pool dibuat, tambahkan nomor telepon SMS Anda ke kolam untuk mengaktifkan fallback SMS. Semua identitas originasi di pool harus memiliki konfigurasi yang cocok. Lihat perinciannya di [Persyaratan konfigurasi kolam untuk RCS](#phone-pool-rcs-config).
------
#### [ AWS CLI ]
Gunakan `CreatePool` API untuk membuat pool dengan AWS RCS Agent Anda sebagai identitas originasi awal. Tentukan AWS RCS Agent ARN sebagai identitas originasi saat membuat pool.
Contoh berikut membuat pool menggunakan AWS CLI:
```
aws pinpoint-sms-voice-v2 create-pool \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ \
--message-type TRANSACTIONAL
```
Setelah pool dibuat, gunakan `AssociateOriginationIdentity` API untuk menambahkan nomor telepon SMS ke pool untuk fallback.
------
## Menambahkan Agen AWS RCS ke pool yang ada
Jika Anda sudah memiliki kumpulan dengan nomor telepon SMS, Anda dapat menambahkan AWS RCS Agent ke pool untuk mengaktifkan pesan RCS dengan fallback SMS. Anda juga dapat menambahkan nomor telepon SMS tambahan ke kumpulan yang sudah berisi Agen AWS RCS.
**penting**
Sebelum menambahkan identitas originasi ke pool yang ada, verifikasi bahwa konfigurasi pool cocok dengan identitas yang Anda tambahkan. Semua identitas originasi di kolam harus memiliki metadata yang identik. Jika ada ketidakcocokan, operasi gagal dengan a`ConflictException`. Untuk detail tentang bidang mana yang harus cocok dan cara mengatasi ketidakcocokan, lihat[Persyaratan konfigurasi kolam untuk RCS](#phone-pool-rcs-config).
------
#### [ Console ]
Sebelum menambahkan AWS RCS Agent ke pool menggunakan konsol, periksa halaman detail pool untuk meninjau konfigurasi saat ini. Konfirmasikan bahwa jenis pesan pool, kode negara ISO, dan pengaturan lainnya kompatibel dengan AWS RCS Agent yang ingin Anda tambahkan.
**Untuk menambahkan AWS RCS Agent ke pool yang ada menggunakan konsol**
1. Buka konsol AWS End User Messaging.
1. Di panel navigasi, pilih **Kolam telepon**.
1. Pilih kumpulan tempat Anda ingin menambahkan AWS RCS Agent.
1. Tinjau konfigurasi pool di halaman detail. Konfirmasikan bahwa jenis pesan dan pengaturan lainnya cocok dengan AWS RCS Agent yang ingin Anda tambahkan.
1. Di bagian **Identitas Originasi**, pilih **Tambahkan identitas originasi**.
1. Pilih AWS RCS Agent Anda dari daftar dan pilih **Tambah**.
------
#### [ AWS CLI ]
Sebelum menambahkan AWS RCS Agent ke pool menggunakan CLI atau API, gunakan `DescribePools` API untuk mengambil konfigurasi pool saat ini. Verifikasi bahwa pengaturan pool cocok dengan AWS RCS Agent yang ingin Anda tambahkan.
Contoh berikut mengambil rincian pool:
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids pool-id
```
Setelah mengonfirmasi kecocokan konfigurasi, gunakan `AssociateOriginationIdentity` API untuk menambahkan AWS RCS Agent ke pool:
```
aws pinpoint-sms-voice-v2 associate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
------
## Persyaratan konfigurasi kolam untuk RCS
Semua identitas originasi di kolam harus memiliki metadata yang identik. Saat Anda menambahkan identitas originasi ke pool, AWS End User Messaging membandingkan konfigurasi identitas dengan konfigurasi pool yang ada. Jika ada ketidakcocokan, operasi gagal dengan `ConflictException` yang mencakup rincian tentang bidang tertentu yang berbeda.
Bidang konfigurasi pool terbagi dalam dua kategori: bidang yang tidak dapat diubah yang disetel saat kumpulan dibuat dan tidak dapat diubah, dan bidang yang dapat diubah yang dapat Anda perbarui setelah pembuatan.
**Bidang konfigurasi kumpulan yang tidak dapat diubah versus yang dapat diubah**
| Bidang | Mutabilitas | Catatan |
| --- | --- | --- |
| Jenis pesan | Tetap | Ditetapkan di pembuatan kolam renang. Semua identitas harus cocok. |
| Kode negara ISO | Tetap | Ditetapkan di pembuatan kolam renang. Untuk AWS RCS Agents, nilainya adalahZZ. Pools dapat berisi nomor telepon dari berbagai negara. |
| Perlindungan penghapusan | bisa berubah | Dapat diubah setelah pembuatan. Harus konsisten di seluruh identitas. |
| Daftar opt-out | bisa berubah | Dapat diubah setelah penciptaan. Harus konsisten di seluruh identitas. |
Bidang konfigurasi berikut harus cocok di semua identitas originasi dalam kumpulan:
+ **Jenis pesan** — Semua identitas harus dikonfigurasi untuk jenis pesan yang sama (misalnya, TRANSAKSIONAL atau PROMOSI).
+ **Kode negara ISO** - Ditetapkan pada pembuatan kolam renang. Untuk Agen AWS RCS, gunakan `ZZ` sebagai kode negara ISO. Pools dapat berisi nomor telepon dari berbagai negara.
+ **Perlindungan penghapusan - Pengaturan perlindungan** penghapusan harus konsisten di seluruh identitas.
+ **Daftar opt-out** — Semua identitas harus dikaitkan dengan daftar opt-out yang sama, atau tidak satupun dari mereka harus memiliki daftar opt-out.
### Memahami ConflictException kesalahan
Saat Anda mencoba menambahkan identitas originasi ke kumpulan dan konfigurasi tidak cocok, `CreatePool` API `AssociateOriginationIdentity` atau mengembalikan file. `ConflictException` Pesan pengecualian mencakup detail tentang bidang mana yang berbeda antara identitas dan kumpulan.
Misalnya, jika Anda mencoba menambahkan nomor telepon yang dikonfigurasi untuk pesan PROMOSI ke kumpulan yang dikonfigurasi untuk pesan TRANSAKSIONAL, pesan kesalahan menunjukkan bahwa jenis pesan tidak cocok.
Untuk menyelesaikan`ConflictException`:
1. Tinjau pesan kesalahan untuk mengidentifikasi bidang mana yang berbeda.
1. Perbarui identitas originasi atau konfigurasi kumpulan sehingga bidang cocok.
1. Coba lagi `AssociateOriginationIdentity` atau `CreatePool` operasi.
**catatan**
Jika Anda tidak dapat menyelesaikan ketidakcocokan konfigurasi, pertimbangkan untuk membuat kumpulan terpisah untuk identitas originasi. Setiap pool dapat memiliki konfigurasi sendiri, dan Anda dapat menggunakan pool yang berbeda untuk kasus penggunaan yang berbeda.
## Menghapus Agen AWS RCS dari pool
Anda dapat menghapus AWS RCS Agent dari pool menggunakan konsol AWS End User Messaging atau `DisassociateOriginationIdentity` API. Menghapus Agen AWS RCS dari kumpulan menonaktifkan pengiriman RCS untuk pesan yang dikirim melalui kumpulan itu. Pesan yang dikirim ke pool setelah agen dihapus dikirim melalui SMS saja (menggunakan nomor telepon yang tersisa di kolam).
------
#### [ Console ]
**Untuk menghapus Agen AWS RCS dari kumpulan menggunakan konsol**
1. Buka konsol AWS End User Messaging.
1. Di panel navigasi, pilih **Kolam telepon**.
1. Pilih pool yang berisi AWS RCS Agent yang ingin Anda hapus.
1. Di bagian **identitas Origination**, pilih AWS RCS Agent.
1. Pilih **Hapus**, lalu konfirmasikan penghapusan.
------
#### [ AWS CLI ]
Gunakan `DisassociateOriginationIdentity` API untuk menghapus Agen AWS RCS dari kumpulan:
```
aws pinpoint-sms-voice-v2 disassociate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
Setelah menghapus AWS RCS Agent, pesan yang dikirim melalui pool dikirim melalui SMS saja. Untuk mengaktifkan kembali pengiriman RCS, tambahkan AWS RCS Agent kembali ke pool menggunakan API. `AssociateOriginationIdentity`
------