Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Kumpulan telepon di SMS Pesan Pengguna AWS Akhir
Pool telepon, juga disebut hanya pool, adalah kumpulan nomor telepon atau pengirim IDs yang berbagi pengaturan yang sama yang dapat Anda gunakan untuk mengirim pesan. Ketika Anda mengirim pesan melalui kumpulan telepon, ia memilih identitas originasi yang sesuai untuk mengirim pesan sebagai. Jika identitas originasi di kumpulan telepon gagal, kumpulan telepon akan gagal ke identitas originasi lain jika berada di kumpulan telepon yang sama.
**catatan**
Kumpulan telepon dapat dikaitkan dengan konfigurasi Notify untuk menggunakan nomor telepon khusus Anda sendiri di samping identitas yang AWS dikelola untuk pesan templat. Untuk informasi selengkapnya, lihat [Menggunakan nomor khusus dengan Notify](notify-dedicated-numbers.md).
Saat membuat pool, Anda dapat mengonfigurasi identitas originasi tertentu. Identitas ini mencakup kata kunci, jenis pesan, daftar opt-out, konfigurasi dua arah, dan konfigurasi opt-out yang dikelola sendiri. Misalnya, dengan menggunakan pool, Anda dapat mengaitkan daftar nomor telepon tujuan yang dipilih keluar dengan nomor telepon Anda untuk negara tertentu. Dengan demikian, Anda dapat mencegah pesan dikirim ke pengguna yang telah memilih untuk tidak menerima pesan dari Anda.
Konfigurasi setiap nomor telepon yang Anda tambahkan ke sebuah pool harus sesuai dengan konfigurasi nomor telepon pertama yang Anda tentukan saat membuat pool. Misalnya, jika Anda membuat kumpulan yang berisi nomor telepon yang mengaktifkan pesan dua arah, nomor lain yang Anda tambahkan ke kumpulan juga harus mengaktifkan pesan dua arah.
Anda juga dapat menambahkan Agen AWS RCS sebagai identitas originasi di kolam bersama nomor telepon dan pengirim Anda. IDs Saat Agen AWS RCS berada di pool, pool memungkinkan RCS-to-SMS fallback otomatis — jika pengiriman RCS gagal, layanan akan mencoba ulang pesan secara otomatis melalui SMS menggunakan identitas originasi lain di kumpulan yang sama. Untuk informasi selengkapnya tentang mengonfigurasi fallback RCS dengan pool, lihat. [RCS ke SMS fallback menggunakan kolam telepon](rcs-sms-fallback.md)
**Topics**
+ [Buat kolam telepon](phone-pool-create.md)
+ [Menambahkan nomor telepon atau ID pengirim](phone-pool-add-number.md)
+ [Lihat semua kolam telepon](phone-pool-list.md)
+ [Hapus kolam telepon](phone-pool-delete.md)
+ [Mengubah daftar opt-out pool](phone-pool-manage-opt-out-list.md)
+ [Perbarui rute bersama](phone-pool-shared-routes.md)
+ [Menggunakan perlindungan penghapusan kolam telepon](phone-pool-deletion-protection.md)
+ [Kelola tag untuk kolam telepon](phone-pool-tags.md)
+ [Daftar kolam telepon bersama](phone-pool-shared.md)
+ [Mengelola Agen AWS RCS di pool](phone-pool-rcs-agents.md)
# Buat kumpulan telepon di SMS Pesan Pengguna AWS Akhir
Saat Anda membuat kumpulan telepon baru, itu akan mewarisi semua pengaturan dari nomor telepon pertama atau ID pengirim yang ditambahkan. Misalnya, jika Anda membuat kumpulan dan nomor telepon pertama yang ditambahkan memiliki pesan dua arah yang diaktifkan, nomor telepon lain yang Anda tambahkan ke kumpulan juga harus mengaktifkan pesan dua arah.
------
#### [ Create a phone pool (Console) ]
Untuk membuat pool menggunakan konsol SMS AWS End User Messaging, ikuti langkah-langkah berikut:
**Untuk membuat pool (Console)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **kolam Telepon**, pilih **Buat kolam telepon**.
1. Di bawah bagian **pengaturan Pool****, untuk nama Pool** masukkan nama untuk pool Anda.
1. Pilih salah satu opsi berikut:
+ **Nomor telepon** — Di bagian **Nomor telepon yang tersedia untuk asosiasi**, pilih nomor telepon untuk dikaitkan dengan kumpulan.
+ **Nomor simulator** (Opsional) - Jika Anda tidak memiliki nomor telepon dan ingin meminta nomor telepon simulator, pilih Nomor **telepon dan di bagian Nomor** **telepon yang tersedia untuk asosiasi**, lakukan hal berikut:
+ Pilih **Minta nomor simulator**.
+ Di **nomor simulator Permintaan**, pilih negara Anda dari daftar dropdown.
+ Pilih **nomor Permintaan**.
+ Di **Nomor telepon yang tersedia untuk asosiasi**, pilih nomor telepon simulator baru.
+ **ID Pengirim** — Di bagian **Pengirim yang IDs tersedia untuk asosiasi**, pilih ID pengirim untuk dikaitkan dengan kumpulan.
1. (Opsional) Perluas **Tag** dan pilih **Tambahkan tag baru**.
1. Masukkan pasangan kunci/nilai kosong baru.
1. (Opsional) Pilih **Tambahkan tag baru** untuk menambahkan tag lain.
1. Pilih **Buat kolam telepon**.
------
#### [ Create a phone pool (AWS CLI) ]
Anda dapat menggunakan perintah [create-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-pool.html) untuk membuat pool baru.
Anda juga dapat menambahkan nomor telepon ke kolam ketika Anda menggunakan `RequestPhoneNumber` API untuk membeli nomor telepon. Untuk informasi selengkapnya, lihat [Minta nomor telepon di SMS Pesan Pengguna AWS Akhir](phone-numbers-request.md).
**Untuk membuat kolam menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 create-pool \
> --origination-identity originationIdentity \
> --iso-country-code XX \
> --message-type TRANSACTIONAL
```
Di perintah sebelumnya, lakukan perubahan berikut:
+ Ganti *originationIdentity* dengan ID unik atau Nama Sumber Daya Amazon (ARN) dari nomor telepon atau ID pengirim yang ingin Anda tambahkan ke kumpulan.
**Tip**
Anda dapat menemukan ID dan ARN nomor telepon dengan menggunakan operasi. [describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html) Anda dapat menemukan ID dan ARN dari ID pengirim dengan menggunakan operasi. [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html)
+ Ganti *XX* dengan pengenal ISO-3166 alpha-2 negara untuk. *originationIdentity*
+ Jika Anda berencana untuk menggunakan pool untuk mengirim pesan pemasaran atau promosi, ganti *TRANSACTIONAL* dengan`PROMOTIONAL`. Jika tidak sesuai, gunakan `TRANSACTIONAL`.
------
# Tambahkan nomor telepon atau ID pengirim ke kumpulan telepon
Ikuti petunjuk berikut untuk menambahkan nomor telepon atau ID pengirim ke kumpulan telepon. Konfigurasi setiap nomor telepon atau ID pengirim yang Anda tambahkan ke kumpulan harus sesuai dengan konfigurasi kumpulan telepon. Misalnya, jika Anda membuat kumpulan dan nomor telepon pertama yang ditambahkan memiliki pesan dua arah yang diaktifkan, nomor telepon lain yang Anda tambahkan ke kumpulan juga harus mengaktifkan pesan dua arah.
------
#### [ Add a phone number or sender ID to a pool (Console) ]
Untuk menambahkan nomor telepon atau ID pengirim ke kumpulan menggunakan konsol SMS Pesan Pengguna AWS Akhir, ikuti langkah-langkah berikut:
**Tambahkan nomor telepon atau ID pengirim (Konsol)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih pool telepon untuk menambahkan identitas originasi.
1. Pada tab **Associated pool originators**, pilih **Add originator**.
1. Pilih salah satu opsi berikut:
+ **Nomor telepon** — Jika Anda memilih opsi ini, di bawah bagian **Nomor telepon yang tersedia untuk asosiasi**, lakukan hal berikut:
+ Pilih nomor telepon untuk ditambahkan ke kolam telepon.
+ **ID Pengirim** - Jika Anda memilih opsi ini, di bawah bagian **Pengirim IDs tersedia untuk asosiasi**, lakukan hal berikut:
+ Pilih ID pengirim untuk menambahkan kumpulan telepon.
1. Pilih **Tambahkan pencetus ke kolam**.
------
#### [ Add a phone number or sender ID to a pool (AWS CLI) ]
Anda dapat menggunakan [associate-origination-identity](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/associate-origination-identity.html)CLI untuk menambahkan nomor telepon atau pengirim IDs ke kolam yang ada.
Konfigurasi setiap nomor telepon atau ID pengirim yang Anda tambahkan ke kumpulan harus sesuai dengan konfigurasi nomor telepon pertama atau ID pengirim yang Anda tentukan saat membuat kumpulan. Misalnya, jika Anda membuat kumpulan yang berisi nomor telepon yang mengaktifkan pesan dua arah, nomor lain yang Anda tambahkan ke kumpulan juga harus mengaktifkan pesan dua arah.
**Untuk menambahkan nomor telepon atau ID pengirim ke kumpulan menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 associate-origination-identity \
> --pool-id poolId \
> --origination-identity originationIdentity \
> --iso-country-code US
```
Di perintah sebelumnya, lakukan perubahan berikut:
+ Ganti *poolId* dengan ID atau Nama Sumber Daya Amazon (ARN) dari kumpulan tempat Anda ingin menambahkan identitas originasi.
+ Ganti *originationIdentity* dengan ID unik atau Nama Sumber Daya Amazon (ARN) dari nomor telepon atau ID pengirim yang ingin Anda tambahkan ke kumpulan.
+ Ganti *\$112065550142* dengan identitas originasi yang ingin Anda tambahkan ke kolam. Nilai ini bisa berupa kode pendek, nomor telepon, atau ID pengirim.
+ Ganti *US* dengan kode dua huruf ISO-3166 alpha-2 untuk negara identitas originasi.
------
#### [ List origination identities (AWS CLI) ]
Anda dapat menggunakan [list-pool-origination-identities](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-pool-origination-identities.html)CLI untuk melihat informasi tentang semua identitas originasi yang telah ditambahkan ke kumpulan tertentu.
**Untuk melihat daftar originasi IDs di kolam menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 list-pool-origination-identities \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
Pada perintah sebelumnya, ganti *poolId* dengan ID atau Amazon Resource Name (ARN) dari pool.
------
# Lihat semua kumpulan telepon di AWS End User Messaging SMS
Anda dapat menggunakan CLI [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) untuk melihat informasi tentang pool yang ada.
Operasi ini dapat memberikan daftar lengkap semua kumpulan di akun SMS Pesan Pengguna AWS Akhir Anda, informasi tentang kumpulan tertentu, atau daftar kumpulan yang difilter berdasarkan kriteria yang Anda tentukan.
**Untuk mengambil daftar semua kumpulan Anda menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 describe-pools
```
Untuk menemukan informasi tentang kumpulan tertentu, gunakan `PoolId` parameter.
**Untuk mendapatkan informasi tentang kumpulan tertentu menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --pool-id poolId
```
Pada perintah sebelumnya, ganti *poolId* dengan ID atau Amazon Resource Name (ARN) dari pool.
Untuk melihat daftar kumpulan yang difilter, gunakan `Filters` parameter. Anda dapat menggunakan nilai filter berikut:
+ `status`— Status kolam saat ini, seperti`ACTIVE`.
+ `message-type`— Jenis pesan yang digunakan kolam untuk mengirim. Nilai yang mungkin adalah `TRANSACTIONAL` atau`PROMOTIONAL`.
+ `two-way-enabled`— Boolean yang menunjukkan apakah pesan SMS dua arah diaktifkan untuk nomor di kolam renang.
+ `self-managed-opt-outs-enabled`— Boolean yang menunjukkan apakah opt-out SMS yang dikelola sendiri diaktifkan untuk nomor di pool.
+ `opt-out-list-name`— Nama daftar opt-out yang terkait dengan pool.
+ `shared-routes-enabled`— Boolean yang menunjukkan apakah rute bersama diaktifkan untuk kumpulan.
+ `deletion-protection-enabled`— Boolean yang menunjukkan apakah nomor telepon dapat dihapus menggunakan `DeletePhoneNumber` operasi atau tidak.
Misalnya, jika Anda ingin melihat daftar kumpulan pesan transaksional yang mendukung pesan dua arah, masukkan perintah berikut di baris perintah:
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --filters Name=message-type,Values=TRANSACTIONAL \
> --filters Name=two-way-enabled,Values=true
```
# Hapus kumpulan telepon di SMS Pesan Pengguna AWS Akhir
Sebelum Anda dapat menghapus kolam, Anda harus mematikan **perlindungan Penghapusan dan menghapus semua kecuali satu pencetus** dari kumpulan telepon. Untuk informasi selengkapnya tentang cara menonaktifkan perlindungan penghapusan, lihat. [Menggunakan perlindungan penghapusan kumpulan telepon di SMS Pesan Pengguna AWS Akhir](phone-pool-deletion-protection.md) Nomor telepon dan pengirim IDs yang dikaitkan dengan kumpulan tetap berada di akun SMS Pesan Pengguna AWS Akhir Anda.
------
#### [ Delete a phone pool (Console) ]
Sebelum Anda dapat menghapus kolam, Anda harus mematikan Perlindungan penghapusan dan menghapus semua pencetus dari kumpulan telepon. Untuk menghapus kumpulan menggunakan konsol SMS AWS End User Messaging, ikuti langkah-langkah berikut:
**Untuk menghapus kolam (Konsol)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih pool yang akan dihapus.
1. Pilih **Hapus**.
1. Masuk **release** dan kemudian **Konfirmasi** untuk menghapus kolam.
------
#### [ Delete a phone pool (AWS CLI) ]
Sebelum Anda dapat menghapus kolam, Anda harus mematikan Perlindungan penghapusan dan menghapus semua pencetus dari kumpulan telepon. Anda dapat menggunakan [delete-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-pool.html) API untuk menghapus pool.
**Untuk menghapus kolam menggunakan AWS CLI**
+ Untuk menghapus kolam, masukkan perintah berikut di baris perintah:
```
$ aws pinpoint-sms-voice-v2 delete-pool \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
Pada perintah sebelumnya, ganti *pool-78ec067f62f94d57bd3bab991example* dengan ID unik atau Amazon Resource Name (ARN) dari pool. Anda dapat menemukan kedua nilai ini dengan menggunakan operasi [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html).
------
# Mengubah daftar opt-out pool di SMS Pesan Pengguna AWS Akhir
Daftar *opt-out adalah daftar* nomor telepon tujuan yang seharusnya tidak memiliki pesan yang dikirim kepada mereka. Ketika Anda mengirim pesan SMS, identitas tujuan secara otomatis ditambahkan ke daftar opt-out jika mereka membalas nomor originasi Anda dengan kata kunci STOP (kecuali jika Anda mengaktifkan opsi opt-out yang dikelola sendiri). Jika Anda mencoba mengirim pesan ke nomor tujuan yang ada di daftar opt-out, dan daftar opt-out dikaitkan dengan kumpulan yang digunakan untuk mengirim pesan, SMS Pesan Pengguna AWS Akhir tidak mencoba mengirim pesan.
Secara default, ketika kumpulan dibuat, kumpulan tersebut ditetapkan ke daftar opt-out *Default*. Pools dapat berbagi daftar opt-out yang sama. Saat Anda mengubah daftar opt-out pool, penerima yang sebelumnya memilih keluar mungkin tidak ada dalam daftar baru dan mulai menerima pesan. Untuk informasi selengkapnya tentang menambahkan atau menghapus nomor telepon tujuan dari daftar opt-out, lihat. [Menambahkan nomor telepon tujuan ke daftar opt-out di SMS Pesan Pengguna AWS Akhir](opt-out-list-add-phone-number.md)
------
#### [ Change opt-out list (Console) ]
Untuk mengubah daftar opt-out menggunakan konsol SMS AWS End User Messaging, ikuti langkah-langkah berikut:
**Ubah daftar opt-out**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih pool.
1. Pada tab **Daftar keluar**, pilih **Edit** pengaturan.
+ **Buat daftar opt-out baru — Buat daftar** opt-out kosong baru dan masukkan nama yang ramah.
+ **Pilih daftar opt-out yang ada — Pilih daftar** opt-out yang dibuat sebelumnya dari dropdown.
1. (Opsional) Untuk mengaktifkan opt-out yang dikelola sendiri, pilih **Aktifkan** opt-out yang dikelola sendiri.
1. Pilih **Simpan perubahan**.
------
#### [ Change opt-out list (AWS CLI) ]
Anda dapat menggunakan perintah [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) untuk mengubah daftar opt-out yang digunakan oleh pool.
Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 update-pool --pool-id poolid --opt-out-list-name OptOutListName
```
Di perintah sebelumnya, lakukan perubahan berikut:
+ Ganti *poolid* dengan PooLid atau Amazon Resource Name (ARN) dari pool.
+ Ganti *OptOutListName* dengan Nama Sumber Daya Amazon (ARN) atau nama daftar opt-out.
------
# Perbarui rute bersama di SMS Pesan Pengguna AWS Akhir
Di beberapa negara, AWS End User Messaging SMS mempertahankan kumpulan identitas originasi bersama. Saat Anda mengaktifkan rute bersama, SMS Pesan Pengguna AWS Akhir berupaya menyampaikan pesan Anda menggunakan salah satu identitas bersama. Identitas originasi dapat berupa ID pengirim, kode panjang atau kode pendek dan dapat bervariasi di setiap negara. Ketika rute bersama menggunakan ID pengirim sebagai identitas originasi, ID pengirim akan menjadi ID pengirim generik, seperti. `NOTICE` Identitas bersama tidak tersedia di beberapa negara, termasuk Amerika Serikat.
**catatan**
Rute bersama dapat dikenakan peningkatan penyaringan hilir dan rute khusus, jika tersedia, lebih disukai.
**Aktifkan rute bersama (Konsol Manajemen AWS)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih pool yang akan mengaktifkan rute bersama.
1. Pada tab **Rute bersama**, pilih tombol **Edit pengaturan**.
1. Pilih **Aktifkan rute bersama**, lalu **Simpan perubahan**.
# Menggunakan perlindungan penghapusan kumpulan telepon di SMS Pesan Pengguna AWS Akhir
Saat Anda mengaktifkan perlindungan penghapusan, Anda tidak akan dapat menghapus kumpulan sampai perlindungan penghapusan dinonaktifkan. Secara default perlindungan penghapusan dinonaktifkan.
**Aktifkan perlindungan penghapusan (Konsol)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih kumpulan telepon yang akan mengaktifkan penghapusan.
1. Pada tab **Perlindungan penghapusan**, pilih **Edit** pengaturan.
1. Pilih **Aktifkan perlindungan penghapusan** dan kemudian **Simpan** perubahan.
# Kelola tag SMS Pesan Pengguna AWS Akhir untuk kumpulan telepon
Tag adalah pasangan kunci dan nilai yang dapat Anda terapkan secara opsional ke AWS sumber daya Anda untuk mengontrol akses atau penggunaan. Untuk mengubah nama Pool dengan mengedit nilai pasangan kunci/nilai Name.
------
#### [ Manage tags (Console) ]
Gunakan konsol SMS AWS End User Messaging untuk menambahkan atau mengedit Tag di pool Anda.
**Kelola tag (Konsol)**
1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Di panel navigasi, di bawah **Konfigurasi**, pilih Pool **telepon**.
1. Pada halaman **Phone Pools**, pilih pool telepon untuk menambahkan tag.
1. Di bagian tab **Tanda**, pilih **Kelola tanda**.
+ **Tambahkan tag** - Di **Kelola tag**, pilih **Tambahkan tag baru** untuk membuat pasangan kunci/nilai kosong baru.
+ **Hapus tag** — Di **Kelola tag**, pilih **Hapus** di sebelah pasangan kunci/nilai.
+ **Edit tag** — Di **Kelola tag**, pilih **Kunci** atau **Nilai** dan edit teks.
1. Pilih **Simpan perubahan**.
------
#### [ Manage tags (AWS CLI) ]
Gunakan AWS CLI untuk menambah atau mengedit Tag.
```
$ aws pinpoint-sms-voice-v2 tag-resource \
--resource-arn resource-arn \
--tags tags={key1=value1,key2=value2}
```
Pada contoh sebelumnya, lakukan hal berikut:
+ Ganti *resource-arn* dengan Amazon Resource Name (ARN) yang ingin Anda tambahkan tag.
+ Ganti *key1* dan *key2* dengan kunci tag yang ingin Anda tambahkan ke sumber daya.
+ Ganti *value1* dan *value2* dengan nilai tag yang ingin Anda tambahkan untuk masing-masing kunci.
Gunakan tombol AWS CLI untuk menghapus Tag.
```
$ aws pinpoint-sms-voice-v2 untag-resource \
--resource-arn resource-arn \
--tag-keys tags={key1=value1,key2=value2}
```
Pada contoh sebelumnya, lakukan hal berikut:
+ Ganti *resource-arn* dengan Amazon Resource Name (ARN) yang ingin Anda hapus tagnya.
+ Ganti *key1* dan *key2* dengan kunci tag yang ingin Anda hapus.
+ Ganti *value1* dan *value2* dengan nilai tag yang ingin Anda hapus.
------
# Buat daftar kolam telepon bersama dengan AWS CLI
Anda dapat menggunakan CLI [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) atau konsol untuk melihat informasi tentang pool [AWS RAM yang](https://console.aws.amazon.com/ram) dibagikan dengan akun Anda. Untuk informasi selengkapnya tentang sumber daya bersama, lihat[Bekerja dengan sumber daya bersama di SMS Pesan Pengguna AWS Akhir](shared-resources.md).
**Untuk mengambil daftar pool yang dibagikan dengan Anda menggunakan AWS CLI**
+ Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 describe-pools --owner SHARED
```
Pada perintah sebelumnya, ganti *SHARED* dengan *SELF* untuk membuat daftar kumpulan yang dimiliki oleh akun Anda.
# 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`
------