Aktifkan streaming pesan obrolan waktu nyata di Amazon Connect - Amazon Connect
Cara APIs kerja streaming pesanLangkah 1: Buat SNS topik standarLangkah 2: Memulai kontak obrolanLangkah 3: Aktifkan streaming pesan pada kontakLangkah 4: Buat koneksi pesertaLangkah selanjutnya

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Aktifkan streaming pesan obrolan waktu nyata di Amazon Connect

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:

  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

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.