Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Aktifkan streaming pesan obrolan real-time di Connect Customer
Connect Customer Chat menyediakan [ API ](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html) yang dapat Anda gunakan untuk berlangganan aliran pesan obrolan real-time. Dengan menggunakan API ini, Anda dapat:
+ Streaming pesan obrolan secara real time saat kontak obrolan baru dibuat.
+ Perluas fungsionalitas Connect Customer Chat saat ini untuk mendukung kasus penggunaan seperti membangun integrasi dengan solusi SMS dan aplikasi perpesanan pihak ketiga, mengaktifkan notifikasi push seluler, dan membuat dasbor analitik untuk memantau dan melacak aktivitas pesan obrolan.
**catatan**
Halaman ini menjelaskan cara berlangganan titik akhir SNS untuk streaming pesan obrolan secara real-time di Connect Customer. Jika Anda mencoba mengaktifkan streaming pesan untuk interaksi AI percakapan di Connect Customer, lihat[Aktifkan streaming pesan untuk AI-powered obrolan](message-streaming-ai-chat.md).
## Cara kerja API streaming pesan
API streaming pesan [ Connect Custom ](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html) er dipicu ketika peristiwa tertentu terjadi dalam kontak Connect Customer Chat. Misalnya, ketika pelanggan mengirim pesan obrolan baru, acara mengirimkan [ payload ](sns-payload.md) ke titik akhir tertentu yang berisi data tentang pesan yang baru saja dikirim. Pesan dipublikasikan menggunakan [ Amazon Simple Notification Service ](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) (Amazon SNS) ke titik akhir tertentu.
Topik ini menjelaskan cara mengatur streaming pesan real-time menggunakan Connect Customer dan Amazon SNS. Langkah-langkahnya adalah:
1. Gunakan konsol Amazon SNS untuk membuat topik SNS standar baru dan mengatur pesan.
1. Panggil [ StartChatContact ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API untuk memulai kontak obrolan.
1. Panggil [ StartContactStreaming ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html) API untuk memulai streaming pesan.
1. Panggil [ CreateParticipantConnection ](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html) API untuk membuat koneksi peserta.
## Langkah 1: Buat topik SNS standar
1. Buka konsol Amazon SNS.
1. [Buat topik SNS ](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) di AWS akun Anda. Di ** bagian ** Detail, untuk ** Jenis**, pilih ** Standar**, masukkan nama untuk topik, lalu pilih ** Buat topik**.
**catatan**
Saat ini, API streaming pesan hanya mendukung SNS standar untuk streaming pesan secara real-time. Mereka tidak mendukung topik [ Amazon SNS FIFO (pertama masuk, pertama keluar). ](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html)
1. Setelah Anda membuat topik, Nama Sumber Daya Amazon (ARN) ditampilkan di ** bagian ** Detail. Salin topik ARN ke clipboard. Gunakan topik ARN di langkah berikutnya dan di[Langkah 3: Aktifkan streaming pesan pada kontak](#step3-chat-streaming).
Topik ARN terlihat mirip dengan contoh berikut:
```
arn:aws:sns:{{us-east-1}}:{{111122223333}}:{{MyTopic}}
```
1. Pilih ** tab Kebijakan ** akses, pilih ** Edit**, lalu tambahkan kebijakan berbasis sumber daya pada topik SNS sehingga Connect Customer memiliki izin untuk menerbitkannya. Berikut ini adalah contoh kebijakan SNS yang dapat Anda salin dan tempel ke editor JSON, lalu sesuaikan dengan nilai-nilai Anda:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect":"Allow",
"Principal":{
"Service":"connect.amazonaws.com"
},
"Action":"sns:Publish",
"Resource":"arn:aws:sns:{{us-east-1}}:{{111122223333}}:{{TopicName}}",
"Condition":{
"StringEquals":{
"aws:SourceAccount":"{{111122223333}}"
},
"ArnEquals":{
"aws:SourceArn":"arn:aws:connect:{{us-east-1}}:{{111122223333}}:instance/{{InstanceId}}"
}
}
}
]
}
```
------
**catatan**
Kebijakan ** Akses default ** dilengkapi dengan kondisi yang diterapkan `sourceOwner` seperti:
```
"Condition": {
"StringEquals": {
"AWS:SourceOwner": "921772911154"
}
}
```
Pastikan Anda menghapusnya dan menggantinya dengan`SourceAccount`, misalnya:
```
"Condition":{
"StringEquals":{
"aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
},
"ArnEquals":{
"aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
}
}
```
Ini mencegah [ masalah wakil yang ](cross-service-confused-deputy-prevention.md) membingungkan lintas layanan.
1. Jika Anda menggunakan enkripsi sisi server di SNS, verifikasi bahwa Anda telah mengaktifkan `connect.amazonaws.com` izin di. KMS key Berikut ini adalah contoh kebijakan:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "key-consolepolicy-3",
"Statement": [
{
"Sid": "Enable IAM User Permissions",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::{{111122223333}}:root",
"Service": "connect.amazonaws.com"
},
"Action": "kms:*",
"Resource": "*"
},
{
"Sid": "Allow access for Key Administrators",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::{{111122223333}}:root",
"Service": "connect.amazonaws.com"
},
"Action": [
"kms:Create*",
"kms:Describe*",
"kms:Enable*",
"kms:List*",
"kms:Put*",
"kms:Update*",
"kms:Revoke*",
"kms:Disable*",
"kms:Get*",
"kms:Delete*",
"kms:TagResource",
"kms:UntagResource",
"kms:ScheduleKeyDeletion",
"kms:CancelKeyDeletion"
],
"Resource": "*"
}
]
}
```
------
## Langkah 2: Memulai kontak obrolan
1. Panggil Connect Custom [ StartChatContact ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) er API untuk memulai kontak obrolan.
Untuk informasi tentang cara membuat klien SDK untuk memanggil Connect Customer API, lihat topik berikut:
+ [Kelas AmazonConnectClientBuilder ](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/connect/AmazonConnectClientBuilder.html)
+ [Membuat Klien Layanan ](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/creating-clients.html)
1. Pantau `ContactId` dan `ParticipantToken` dari [ StartChatContact ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) respons karena atribut respons ini digunakan untuk memanggil API obrolan lain yang diperlukan untuk mengaktifkan streaming. Ini dijelaskan dalam langkah selanjutnya.
## Langkah 3: Aktifkan streaming pesan pada kontak
+ Panggil [ StartContactStreaming ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html) untuk mengaktifkan streaming pesan real-time ke topik SNS Anda.
+ **Bat ** asan: Anda dapat berlangganan hingga dua topik SNS per kontak.
+ Saat menelep [ StartContactStreaming ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html) on, Anda harus memberikan Nama Sumber Daya Amazon (ARN) dari topik SNS (lihat[Langkah 1: Buat topik SNS standar](#step1-chat-streaming)).
Satu topik SNS ARN dapat digunakan di beberapa topik Akun AWS, tetapi harus berada di Wilayah yang sama dengan instance Connect Customer Anda. Misalnya, jika topik ARN Anda ada di ** us-east-1**, instance Connect Customer Anda harus berada di ** us-east-1. **
+ Untuk pesan obrolan awal yang tidak diterima di titik akhir streaming, Anda dapat memang [ GetTranscript ](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html) gil API untuk menerima pesan awal.
## Langkah 4: Buat koneksi peserta
+ Panggilan [ CreateParticipantConnection ](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html) dengan `ConnectParticipant` atribut diteruskan sebagai true.
+ Anda harus menelepon [ CreateParticipantConnection ](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html) dalam waktu lima menit setelah membuat obrolan.
+ Mem [ CreateParticipantConnection ](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html) anggil dengan `ConnectParticipant` set ke true hanya berfungsi jika Anda mengaktifkan streaming masuk [Langkah 2: Memulai kontak obrolan](#step2-chat-streaming) dan peserta pemanggil aktif`Customer`.
+ Langkah ini (membuat koneksi peserta) adalah opsional jika Anda telah berhasil terhubung ke kontak obrolan menggunakan`WEBSOCKET`.
## Langkah selanjutnya
Anda siap untuk bekerja dengan API streaming pesan.
1. Untuk memverifikasi bahwa pesan berfungsi, periksa apakah pesan dipublikasikan ke topik SNS yang Anda buat. Anda dapat melakukan ini menggunakan CloudWatch metrik Amazon. Untuk petunjuk, lihat Meman [ tau topik Amazon SNS menggunakan CloudWatch](https://docs.aws.amazon.com/sns/latest/dg/sns-monitoring-using-cloudwatch.html).
1. Karena SNS memiliki retensi [ terbatas](https://aws.amazon.com/blogs/aws/sns-ttl-control/), kami sarankan Anda mengatur [ Amazon Simple Queue Service (Amazon SQS) ](https://aws.amazon.com/sqs/) [ Amazon Kinesis](https://aws.amazon.com/kinesis/), atau layanan lain untuk menyimpan pesan.
1. Penggunaan [ StopContactStreaming ](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactStreaming.html) bersifat opsional dan tidak diperlukan jika obrolan ter [ putus ](disconnect-hang-up.md) melalui aliran kontak, atau jika pelanggan memutuskan sambungan obrolan. Namun, `StopContactStreaming` menyediakan opsi untuk menghentikan streaming pesan pada topik SNS, bahkan jika obrolan aktif dan sedang berlangsung.