View a markdown version of this page

Mengelola Agen AWS RCS di pool - AWS SMS Pesan Pengguna Akhir
Membuat pool dengan AWS RCS AgentMenambahkan Agen AWS RCS ke pool yang adaPersyaratan konfigurasi kolam untuk RCSMenghapus Agen AWS RCS dari pool

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

catatan

Saat Anda menambahkan AWS RCS Agent ke pool, gunakan ZZ sebagai kode negara ISO. ZZKode 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 meneleponDescribePools, 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.

  2. Di panel navigasi, pilih Kolam telepon.

  3. Pilih Buat kolam.

  4. Untuk identitas Origination, pilih AWS RCS Agent Anda. Pool mewarisi konfigurasinya dari identitas originasi yang Anda pilih.

  5. Konfigurasikan pengaturan pool sesuai kebutuhan, lalu pilih Create pool.

  6. 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.

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 aConflictException. Untuk detail tentang bidang mana yang harus cocok dan cara mengatasi ketidakcocokan, lihatPersyaratan konfigurasi kolam untuk RCS.

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.

  2. Di panel navigasi, pilih Kolam telepon.

  3. Pilih kumpulan tempat Anda ingin menambahkan AWS RCS Agent.

  4. Tinjau konfigurasi pool di halaman detail. Konfirmasikan bahwa jenis pesan dan pengaturan lainnya cocok dengan AWS RCS Agent yang ingin Anda tambahkan.

  5. Di bagian Identitas Originasi, pilih Tambahkan identitas originasi.

  6. 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 menyelesaikanConflictException:

  1. Tinjau pesan kesalahan untuk mengidentifikasi bidang mana yang berbeda.

  2. Perbarui identitas originasi atau konfigurasi kumpulan sehingga bidang cocok.

  3. 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.

  2. Di panel navigasi, pilih Kolam telepon.

  3. Pilih pool yang berisi AWS RCS Agent yang ingin Anda hapus.

  4. Di bagian identitas Origination, pilih AWS RCS Agent.

  5. 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