Aktifkan streaming pesan obrolan waktu nyata

Amazon Connect Chat menyediakan APIsyang memungkinkan Anda berlangganan streaming pesan obrolan waktu nyata. Dengan menggunakan iniAPIs, Anda dapat:

• Streaming pesan obrolan secara real time saat kontak obrolan baru dibuat.

• Perluas fungsionalitas Amazon Connect Chat saat ini untuk mendukung kasus penggunaan seperti membangun integrasi dengan SMS solusi dan aplikasi perpesanan pihak ketiga, mengaktifkan notifikasi push seluler, dan membuat dasbor analitik untuk memantau dan melacak aktivitas pesan obrolan.

Cara APIs kerja streaming pesan

Streaming pesan Amazon Connect APIs dipicu ketika peristiwa tertentu terjadi dalam kontak Obrolan Amazon Connect. Misalnya, ketika pelanggan mengirim pesan obrolan baru, acara mengirimkan muatan ke titik akhir tertentu yang berisi data tentang pesan yang baru saja dikirim. Pesan dipublikasikan menggunakan Amazon Simple Notification Service (AmazonSNS) ke titik akhir tertentu.

Topik ini menjelaskan cara mengatur streaming pesan real-time menggunakan Amazon Connect dan AmazonSNS. Langkah-langkahnya adalah:

1. Gunakan SNS konsol Amazon untuk membuat SNS topik standar baru dan mengatur pesan.

2. Hubungi StartChatContactAPIuntuk memulai kontak obrolan.

3. Hubungi StartContactStreamingAPIuntuk memulai streaming pesan.

4. Hubungi CreateParticipantConnectionAPIuntuk membuat koneksi peserta.

Langkah 1: Buat SNS topik standar

1. Pergi ke SNS konsol Amazon.

2. Buat SNS topik di AWS akun Anda. Di bagian Detail, untuk Jenis, pilih Standar, masukkan nama untuk topik, lalu pilih Buat topik.

   catatan

   Saat ini, streaming pesan APIs hanya mendukung standar SNS untuk streaming pesan secara real-time. Mereka tidak mendukung topik Amazon SNS FIFO (masuk pertama, keluar pertama).

3. Setelah Anda membuat topik, Amazon Resource Name (ARN) ditampilkan di bagian Detail. Salin topik ARN ke clipboard. Anda akan menggunakan topik ARN di langkah berikutnya, dan diLangkah 3: Aktifkan streaming pesan pada kontak.

   Topiknya ARN terlihat mirip dengan contoh berikut:

   arn:aws:sns:us-east-1:123456789012:MyTopic                                
                              

4. Pilih tab Kebijakan akses, pilih Edit, lalu tambahkan kebijakan berbasis sumber daya pada SNS topik tersebut sehingga Amazon Connect memiliki izin untuk mempublikasikannya. Berikut ini adalah contoh SNS kebijakan yang dapat Anda salin dan tempel ke JSON editor, lalu sesuaikan dengan nilai Anda:

   {
      "Version":"2012-10-17",
      "Statement":[
         {
            "Effect":"Allow",
            "Principal":{
               "Service":"connect.amazonaws.com"
            },
            "Action":"sns:Publish",
            "Resource":"YOUR_SNS_TOPIC_ARN",
            "Condition":{
               "StringEquals":{
                  "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
               },
               "ArnEquals":{
                  "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
               }
            }
         }
      ]
   }      

   catatan

   Kebijakan Access default dilengkapi dengan ketentuan yang diterapkan sourceOwner seperti:

   "Condition": {
           "StringEquals": {
             "AWS:SourceOwner": "921772911154"
           }
         }    

   Pastikan Anda menghapusnya dan menggantinya denganSourceAccount, misalnya:

   "Condition":{
               "StringEquals":{
                  "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
               },
               "ArnEquals":{
                  "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
               }
            } 

   Ini mencegah masalah wakil lintas layanan yang membingungkan.

5. Jika Anda menggunakan enkripsi sisi server aktifSNS, verifikasi bahwa Anda telah mengaktifkan connect.amazonaws.com izin di file. KMS key Berikut ini adalah contoh kebijakan:

   {
           "Version": "2012-10-17",
           "Id": "key-consolepolicy-3",
           "Statement": [
               {
                   "Sid": "Enable IAM User Permissions",
                   "Effect": "Allow",
                   "Principal": {
                       "AWS": "arn:aws:iam::your_accountId:root",
                       "Service": "connect.amazonaws.com"
                   },
                   "Action": "kms:*",
                   "Resource": "*"
               },
               {
                   "Sid": "Allow access for Key Administrators",
                   "Effect": "Allow",
                   "Principal": {
                       "AWS": "arn:aws:iam::your_accountId: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. Hubungi Amazon Connect StartChatContactAPIuntuk memulai kontak obrolan.

   Untuk informasi tentang cara membuat SDK klien untuk menelepon Amazon ConnectAPIs, lihat topik berikut:

   • Kelas AmazonConnectClientBuilder

   • Membuat Klien Layanan

2. Lacak ContactId dan ParticipantToken dari StartChatContactrespons karena atribut respons ini digunakan untuk memanggil obrolan lain APIs yang diperlukan untuk mengaktifkan streaming. Ini dijelaskan pada langkah selanjutnya.

Langkah 3: Aktifkan streaming pesan pada kontak

• Hubungi StartContactStreaminguntuk mengaktifkan streaming pesan real-time ke SNS topik Anda.

  • Batas: Anda dapat berlangganan hingga dua SNS topik per kontak.

  • Saat menelepon StartContactStreaming, Anda harus memberikan Amazon Resource Name (ARN) dari SNS topik (lihatLangkah 1: Buat SNS topik standar).

    Satu SNS topik ARN dapat digunakan di beberapa topik Akun AWS, tetapi harus berada di Wilayah yang sama dengan instans Amazon Connect Anda. Misalnya, jika topik Anda ARN ada di us-east-1, instans Amazon Connect Anda harus berada di us-east-1.

  • Untuk pesan obrolan awal yang tidak diterima di titik akhir streaming, Anda dapat menelepon GetTranscriptAPIuntuk menerima pesan awal.

Langkah 4: Buat koneksi peserta

• Panggil CreateParticipantConnectiondengan ConnectParticipant atribut diteruskan sebagai true.

  • Anda harus menelepon CreateParticipantConnectiondalam waktu lima menit setelah membuat obrolan.

  • Memanggil CreateParticipantConnectiondengan ConnectParticipant disetel ke true hanya berfungsi jika Anda mengaktifkan streaming Langkah 2: Memulai kontak obrolan dan peserta pemanggil. Customer

  • Langkah ini (membuat koneksi peserta) adalah opsional jika Anda telah berhasil terhubung ke kontak obrolan menggunakanWEBSOCKET.

Langkah selanjutnya

Anda siap untuk bekerja dengan streaming pesanAPIs.

1. Untuk memverifikasi itu berfungsi, periksa apakah pesan dipublikasikan ke SNS topik yang Anda buat. Anda dapat melakukan ini menggunakan CloudWatch metrik Amazon. Untuk petunjuk, lihat Memantau SNS topik Amazon menggunakan CloudWatch.

2. Karena SNS memiliki retensi terbatas, kami menyarankan Anda menyiapkan Amazon Kinesis Amazon Simple Queue Service (Amazon SQS), atau layanan lain untuk menyimpan pesan.

3. Penggunaan StopContactStreamingbersifat opsional dan tidak diperlukan jika obrolan terputus melalui alur kontak, atau jika pelanggan memutuskan koneksi obrolan. Namun, StopContactStreaming menyediakan opsi untuk menghentikan streaming pesan pada SNS topik, bahkan jika obrolan aktif dan sedang berlangsung.