Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pesan SMS dua arah di SMS Pesan Pengguna AWS Akhir
AWS End User Messaging SMS mencakup dukungan untuk SMS dua arah. Saat Anda menyiapkan SMS dua arah, Anda dapat menerima pesan masuk dari pelanggan Anda. Anda juga dapat menggunakan pesan dua arah bersama dengan AWS layanan lain, seperti Lambda dan Amazon Lex, untuk menciptakan pengalaman pesan teks interaktif.
Ketika salah satu pelanggan Anda mengirim pesan ke nomor telepon Anda, badan pesan dikirim ke topik Amazon SNS atau Amazon Connect untuk diproses.
SMS dua arah hanya tersedia di negara dan wilayah tertentu. Untuk informasi selengkapnya tentang dukungan SMS dua arah menurut negara atau wilayah, lihat[Kemampuan dan keterbatasan negara SMS dan MMS](phone-numbers-sms-support-by-country.md).
Pengirim IDs tidak mendukung pesan SMS dua arah.
**catatan**
SMS dua arah hanya tersedia di negara dan wilayah tertentu. Untuk informasi selengkapnya tentang dukungan SMS dua arah menurut negara atau wilayah, lihat[Kemampuan dan keterbatasan negara SMS dan MMS](phone-numbers-sms-support-by-country.md).
MMS dua arah tidak didukung tetapi nomor telepon Anda masih dapat menerima pesan SMS masuk sebagai tanggapan atas pesan MMS keluar.
Amazon Connect untuk SMS dua arah tersedia dalam [subtipe pesan Obrolan: SMS](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) yang Wilayah AWS tercantum dalam panduan *administrator Amazon Connect*.
**Topics**
+ [Mengatur pesan SMS dua arah untuk nomor telepon](two-way-sms-phone-number.md)
+ [Siapkan pesan SMS dua arah untuk kumpulan telepon](two-way-sms-pool.md)
+ [Kebijakan IAM untuk topik Amazon SNS](two-way-sms-iam-policy.md)
+ [Kebijakan topik untuk topik Amazon SNS](two-way-sms-iam-policy-auto.md)
+ [Kebijakan IAM untuk Amazon Connect](two-way-connect-iam-policy.md)
+ [Contoh payload pesan SMS dua arah](two-way-sms-payload.md)
# Mengatur pesan SMS dua arah untuk nomor telepon di SMS Pesan Pengguna AWS Akhir
AWS End User Messaging SMS mencakup dukungan untuk SMS dua arah. Ketika Anda mengatur SMS dua arah, Anda dapat menerima pesan masuk dari pelanggan Anda. Anda juga dapat menggunakan pesan dua arah bersama dengan yang lain Layanan AWS, seperti Lambda dan Amazon Lex, untuk menciptakan pengalaman pesan teks interaktif.
Ketika salah satu pelanggan Anda mengirim pesan ke nomor telepon Anda, badan pesan dikirim ke topik Amazon SNS atau instans Amazon Connect untuk diproses.
**catatan**
SMS dua arah hanya tersedia di negara dan wilayah tertentu. Untuk informasi selengkapnya tentang dukungan SMS dua arah menurut negara atau wilayah, lihat[Kemampuan dan keterbatasan negara SMS dan MMS](phone-numbers-sms-support-by-country.md).
Amazon Connect untuk SMS dua arah tersedia dalam [subtipe pesan obrolan: SMS yang Wilayah AWS tercantum di Panduan](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) *Administrator Amazon Connect*.
MMS dua arah tidak didukung tetapi nomor telepon Anda masih dapat menerima pesan SMS masuk sebagai tanggapan atas pesan MMS keluar.
------
#### [ Two-way SMS messaging (Console) ]
Untuk mengaktifkan SMS dua arah menggunakan konsol SMS AWS End User Messaging, ikuti langkah-langkah berikut:
**Aktifkan SMS dua arah**
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 Nomor **telepon**.
1. Pada halaman **Nomor telepon**, pilih nomor telepon.
1. Pada tab **SMS dua arah**, pilih tombol **Edit pengaturan**.
1. Pada halaman **Edit pengaturan**, pilih **Aktifkan pesan dua arah**.
1. Untuk **tipe Tujuan**, pilih **Amazon SNS** atau **Amazon** Connect.
+ **Untuk Amazon SNS, pilih topik **Amazon SNS Baru atau topik **Amazon SNS**** yang ada, lalu **untuk peran saluran dua arah**, pilih Pilih peran **IAM yang ada** atau Gunakan kebijakan topik Amazon SNS.**
+ **Topik Amazon SNS Baru** - Jika Anda memilih opsi ini, SMS Pesan Pengguna AWS Akhir membuat topik di akun Anda. Topik dibuat secara otomatis dengan semua izin yang diperlukan. Untuk informasi selengkapnya tentang topik Amazon SNS, lihat [Mengonfigurasi Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) di Panduan Pengembang Layanan Pemberitahuan [Sederhana Amazon](https://docs.aws.amazon.com/sns/latest/dg/).
+ **Topik Amazon SNS yang ada** - Jika Anda memilih opsi ini, Anda harus memilih topik Amazon SNS yang ada dari dropdown tujuan pesan **masuk**.
+ Untuk **peran saluran dua arah**, pilih salah satu:
+ **Pilih peran IAM yang ada** — Pilih kebijakan IAM yang ada untuk diterapkan pada topik Amazon SNS. Misalnya kebijakan Amazon SNS lihat. [Kebijakan IAM untuk topik Amazon SNS](two-way-sms-iam-policy.md)
+ **Gunakan kebijakan topik Amazon SNS** — Topik Amazon SNS memerlukan kebijakan topik Amazon SNS yang sesuai untuk memberikan akses AWS ke SMS Pesan Pengguna Akhir. Misalnya kebijakan Amazon SNS, lihat. [Kebijakan topik untuk topik Amazon SNS](two-way-sms-iam-policy-auto.md)
+ Untuk Amazon Connect, dalam **peran saluran dua arah, pilih Pilih peran** **IAM yang ada**.
+ Di menu **tarik-turun peran IAM** yang ada, pilih peran IAM yang ada sebagai tujuan pesan. Misalnya kebijakan IAM, lihat[Kebijakan IAM untuk Amazon Connect](two-way-connect-iam-policy.md).
1. Pilih **Simpan perubahan**.
1. *(Opsional)* Jika Anda memilih Amazon Connect sebagai **tipe Tujuan**, maka di jendela **Impor Nomor Telepon ke Amazon Connect**:
1. Untuk menu tarik-turun **tujuan Pesan masuk**, pilih instans Amazon Connect yang akan menerima pesan masuk.
1. Pilih **Impor Nomor Telepon**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Anda dapat menggunakan [update-phone-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-phone-number.html)perintah untuk mengaktifkan SMS dua arah.
Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id PhoneNumber \
> --two-way-enabled True \
> --two-way-channel-arn TwoWayARN \
> --two-way-channel-role TwoChannelWayRole
```
Di perintah sebelumnya, lakukan perubahan berikut:
+ Ganti *PhoneNumber* dengan PhoneNumber ID atau Nama Sumber Daya Amazon (ARN) dari nomor telepon.
+ Ganti *TwoWayARN* dengan Amazon Resource Name (ARN) untuk menerima pesan SMS yang masuk. Misalnya kebijakan Amazon SNS, lihat. [Kebijakan topik untuk topik Amazon SNS](two-way-sms-iam-policy-auto.md) Untuk menetapkan Amazon Connect sebagai tujuan masuk yang disetel *TwoWayARN* ke`connect.region.amazonaws.com`. Ganti *region* dengan instans Amazon Connect yang di-host. Wilayah AWS
+ Ganti *TwoChannelWayRole* dengan Amazon Resource Name (ARN) dari peran IAM yang akan digunakan. Misalnya kebijakan izin SNS, lihat [Kebijakan IAM untuk topik Amazon SNS](two-way-sms-iam-policy.md) dan misalnya kebijakan Amazon Connect, lihat[Kebijakan IAM untuk Amazon Connect](two-way-connect-iam-policy.md). Parameter ini hanya diperlukan jika Anda memilih untuk menggunakan kebijakan izin IAM.
------
# Siapkan pesan SMS dua arah untuk kumpulan telepon di SMS Pesan Pengguna AWS Akhir
Gunakan konsol SMS AWS End User Messaging atau AWS CLI untuk mengaktifkan SMS dua arah untuk kumpulan ponsel Anda.
------
#### [ Two-way SMS messaging (Console) ]
Untuk mengaktifkan SMS dua arah menggunakan konsol SMS AWS End User Messaging, ikuti langkah-langkah berikut:
**Aktifkan SMS dua arah**
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 kolam telepon.
1. Pada tab **SMS dua arah**, pilih **Edit pengaturan**.
1. Pada halaman **Edit pengaturan**, **aktifkan Aktifkan pesan dua arah**.
1. Untuk **tipe Tujuan**, pilih **Amazon SNS** atau **Amazon** Connect.
+ **Untuk Amazon SNS, pilih topik **Amazon SNS Baru atau topik **Amazon SNS**** yang ada, lalu **untuk peran saluran dua arah**, pilih Pilih peran **IAM yang ada** atau Gunakan kebijakan topik Amazon SNS.**
+ **Topik Amazon SNS Baru** - Jika Anda memilih opsi ini, SMS Pesan Pengguna AWS Akhir membuat topik di akun Anda. Topik dibuat secara otomatis dengan semua izin yang diperlukan. *Untuk informasi selengkapnya tentang topik Amazon SNS, lihat [Mengonfigurasi Amazon SNS di panduan pengembang](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) Amazon SNS.*
+ **Topik Amazon SNS yang ada** - Jika Anda memilih opsi ini, Anda harus memilih topik Amazon SNS yang ada dari dropdown tujuan pesan **masuk**.
+ Untuk **peran saluran dua arah**, pilih salah satu:
+ **Pilih peran IAM yang ada** — Pilih kebijakan IAM yang ada untuk diterapkan pada topik Amazon SNS. Misalnya kebijakan Amazon SNS lihat. [Kebijakan IAM untuk topik Amazon SNS](two-way-sms-iam-policy.md)
+ **Gunakan kebijakan topik Amazon SNS** — Topik Amazon SNS memerlukan kebijakan topik Amazon SNS yang sesuai untuk memberikan akses AWS ke SMS Pesan Pengguna Akhir. Misalnya kebijakan Amazon SNS, lihat. [Kebijakan topik untuk topik Amazon SNS](two-way-sms-iam-policy-auto.md)
+ Untuk Amazon Connect dalam **peran saluran dua arah, pilih Pilih peran** **IAM yang ada**.
+ Di menu **tarik-turun peran IAM** yang ada, pilih peran IAM yang ada sebagai tujuan pesan. Misalnya kebijakan IAM, lihat[Kebijakan IAM untuk Amazon Connect](two-way-connect-iam-policy.md).
1. Pilih **Simpan perubahan**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Anda dapat menggunakan perintah [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) untuk mengaktifkan SMS dua arah.
Di baris perintah, masukkan perintah berikut:
```
$ aws pinpoint-sms-voice-v2 update-pool \
> --pool-id poolid \
> --two-way-channel-arn TwoWayARN \
> --two-way-channel-role TwoChannelWayRole
```
Di perintah sebelumnya, lakukan perubahan berikut:
+ Ganti *poolid* dengan PhonePool ID atau Nama Sumber Daya Amazon (ARN) dari nomor telepon.
+ Ganti *TwoWayARN* dengan Amazon Resource Name (ARN) untuk menerima pesan SMS yang masuk. Misalnya kebijakan Amazon SNS, lihat. [Kebijakan topik untuk topik Amazon SNS](two-way-sms-iam-policy-auto.md) Untuk menetapkan Amazon Connect sebagai tujuan masuk yang disetel *TwoWayARN* ke`connect.region.amazonaws.com`. Ganti *region* dengan instans Amazon Connect yang di-host. Wilayah AWS
+ Ganti *TwoChannelWayRole* dengan Amazon Resource Name (ARN) dari peran IAM yang akan digunakan. Misalnya kebijakan izin SNS, lihat [Kebijakan IAM untuk topik Amazon SNS](two-way-sms-iam-policy.md) dan misalnya kebijakan Amazon Connect, lihat[Kebijakan IAM untuk Amazon Connect](two-way-connect-iam-policy.md). Parameter ini hanya diperlukan jika Anda memilih untuk menggunakan kebijakan izin IAM.
------
# Kebijakan IAM untuk topik Amazon SNS
Jika Anda ingin SMS Pesan Pengguna AWS Akhir menggunakan peran IAM yang ada atau jika Anda membuat peran baru, lampirkan kebijakan berikut ke peran tersebut sehingga SMS Pesan Pengguna AWS Akhir dapat menerimanya. Untuk informasi tentang cara mengubah hubungan kepercayaan suatu peran, lihat [Memodifikasi Peran](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) dalam panduan [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
Berikut ini adalah **kebijakan kepercayaan** untuk peran IAM. Dalam kebijakan IAM berikut, lakukan perubahan berikut:
+ Ganti *accountId* dengan ID unik untuk AWS akun Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoice",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
}
}
}
]
}
```
------
Berikut ini adalah **kebijakan izin** untuk peran IAM. `SMSVoiceAllowSNSPublish`Sid adalah kebijakan izin untuk memungkinkan penerbitan ke topik Amazon SNS dan `SMSVoiceAllowEncryptedSNSTopics` Sid adalah opsi untuk topik Amazon SNS terenkripsi.
Dalam kebijakan izin IAM berikut, lakukan perubahan berikut:
+ Ganti *partition* dengan AWS partisi tempat Anda menggunakan AWS End User Messaging SMS.
+ Ganti *region* dengan Wilayah AWS yang Anda gunakan AWS End User Messaging SMS di.
+ Ganti *accountId* dengan ID unik untuk Anda Akun AWS.
+ Ganti *snsTopicArn* dengan topik Amazon SNS yang akan menerima pesan.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoiceAllowSNSPublish",
"Effect": "Allow",
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:snsTopicArn",
"Condition": {
"StringEquals": {
"aws:ResourceAccount": "111122223333"
}
}
},
{
"Sid": "SMSVoiceAllowEncryptedSNSTopics",
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey*"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"kms:EncryptionContext:aws:sns:topicArn": "arn:aws:sns:us-east-1:111122223333:snsTopicArn",
"aws:CalledViaLast": "sns.amazonaws.com"
}
}
}
]
}
```
------
# Kebijakan topik untuk topik Amazon SNS
Topik Amazon SNS memerlukan kebijakan topik yang sesuai untuk memberikan akses ke SMS Pesan Pengguna AWS Akhir jika tidak disediakan dalam parameter. *TwoChannelWayRole*
```
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "snsTopicArn"
}
```
Pada contoh sebelumnya, lakukan perubahan berikut:
+ Ganti *snsTopicArn* dengan topik Amazon SNS yang akan mengirim dan menerima pesan.
**catatan**
Topik Amazon SNS FIFO tidak didukung.
Meskipun data SMS AWS End User Messaging dienkripsi, Anda dapat menggunakan topik Amazon SNS yang dienkripsi AWS KMS menggunakan kunci untuk tingkat keamanan tambahan. Keamanan tambahan ini dapat membantu jika aplikasi Anda menangani data pribadi atau sensitif.
Anda perlu melakukan beberapa langkah penyiapan tambahan untuk menggunakan topik Amazon SNS terenkripsi dengan pesan dua arah.
Pernyataan contoh berikut menggunakan, opsional tetapi direkomendasikan, `SourceAccount` dan `SourceArn` kondisi untuk menghindari masalah wakil yang membingungkan dan hanya akun pemilik SMS AWS End User Messaging yang memiliki akses. Untuk informasi lebih lanjut tentang masalah wakil yang bingung, lihat [Masalah wakil yang bingung](https://docs.aws.amazon.com//IAM/latest/UserGuide/confused-deputy.html) di *[panduan pengguna IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html)*.
Pertama, kunci yang Anda gunakan harus *simetris*. Topik Amazon SNS terenkripsi tidak mendukung kunci asimetris. AWS KMS
Kedua, kebijakan kunci harus dimodifikasi agar SMS AWS End User Messaging dapat menggunakan kunci tersebut. Tambahkan izin berikut ke kebijakan kunci yang ada:
```
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:region:accountId:*"
}
}
}
```
Untuk informasi selengkapnya tentang mengedit kebijakan utama, lihat [Mengubah kebijakan kunci](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) di *Panduan AWS Key Management Service Pengembang*.
Untuk informasi selengkapnya tentang mengenkripsi topik Amazon SNS AWS KMS menggunakan kunci, [lihat Mengaktifkan kompatibilitas antara sumber peristiwa AWS dari layanan dan topik terenkripsi di Panduan Pengembang Layanan](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) *Pemberitahuan Sederhana Amazon*.
# Kebijakan IAM untuk Amazon Connect
Jika Anda ingin SMS Pesan Pengguna AWS Akhir menggunakan peran IAM yang ada atau jika Anda membuat peran baru, lampirkan kebijakan berikut ke peran tersebut sehingga SMS Pesan Pengguna AWS Akhir dapat menerapkannya. Untuk informasi tentang cara mengubah hubungan kepercayaan yang ada dari suatu peran, lihat [Memodifikasi Peran](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) dalam panduan [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
Untuk membuat kebijakan IAM baru, lakukan hal berikut:
1. Buat **kebijakan izin** baru dengan mengikuti petunjuk dalam [Membuat kebijakan menggunakan editor JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) di Panduan Pengguna IAM.
1. Pada langkah 4 gunakan **kebijakan izin** yang didefinisikan di bawah ini.
1. Buat **kebijakan kepercayaan** baru dengan mengikuti petunjuk dalam [Membuat peran menggunakan kebijakan kepercayaan khusus](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) di Panduan Pengguna IAM.
1. Pada langkah 4 gunakan **kebijakan kepercayaan** yang didefinisikan di bawah ini.
1. Pada langkah 11 tambahkan **kebijakan izin** yang Anda buat di langkah sebelumnya.
Berikut ini adalah **kebijakan izin** untuk peran IAM untuk memungkinkan penerbitan ke Amazon Connect.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"connect:SendChatIntegrationEvent"
],
"Resource": [
"*"
]
}
]
}
```
------
Berikut ini adalah **kebijakan kepercayaan** untuk peran IAM, buat perubahan berikut:
+ Ganti *accountId* dengan ID unik untuk Anda Akun AWS.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoice",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
}
}
}
]
}
```
------
# Contoh payload pesan SMS dua arah untuk topik Amazon SNS
Saat nomor Anda menerima pesan SMS, SMS Pesan Pengguna AWS Akhir mengirimkan payload JSON ke topik Amazon SNS yang Anda tentukan. Payload JSON berisi pesan dan data terkait, seperti pada contoh berikut:
```
{
"originationNumber":"+14255550182",
"destinationNumber":"+12125550101",
"messageKeyword":"JOIN",
"messageBody":"EXAMPLE",
"inboundMessageId":"cae173d2-66b9-564c-8309-21f858e9fb84",
"previousPublishedMessageId":"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}
```
Payload pesan masuk berisi informasi berikut:
****
| Properti | Deskripsi |
| --- | --- |
| `originationNumber` | Nomor telepon yang mengirim pesan masuk kepada Anda (dengan kata lain, nomor telepon pelanggan Anda). |
| `destinationNumber` | Nomor telepon tempat pelanggan mengirim pesan (nomor telepon khusus Anda). |
| `messageKeyword` | Kata kunci terdaftar yang terkait dengan nomor telepon khusus Anda. |
| `messageBody` | Pesan yang dikirimkan pelanggan kepada Anda. |
| `inboundMessageId` | Pengenal unik untuk pesan yang masuk. |
| `previousPublishedMessageId` | Pengidentifikasi unik dari pesan yang ditanggapi pelanggan. |