View a markdown version of this page

Aktifkan streaming pesan obrolan real-time di Connect Customer - Pelanggan Amazon Connect
Cara kerja API streaming pesanLangkah 1: Buat topik SNS 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 real-time di Connect Customer

Connect Customer Chat menyediakan API 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, lihatAktifkan streaming pesan untuk AI-powered obrolan.

Cara kerja API streaming pesan

API streaming pesan Connect Custom er dipicu ketika peristiwa tertentu terjadi dalam kontak Connect Customer Chat. Misalnya, ketika pelanggan mengirim pesan obrolan baru, acara mengirimkan payload ke titik akhir tertentu yang berisi data tentang pesan yang baru saja dikirim. Pesan dipublikasikan menggunakan Amazon Simple Notification Service (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.

  2. Panggil StartChatContact API untuk memulai kontak obrolan.

  3. Panggil StartContactStreaming API untuk memulai streaming pesan.

  4. Panggil CreateParticipantConnection API untuk membuat koneksi peserta.

Langkah 1: Buat topik SNS standar

  1. Buka konsol Amazon SNS.

  2. Buat topik SNS 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).

  3. 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 diLangkah 3: Aktifkan streaming pesan pada kontak.

    Topik ARN terlihat mirip dengan contoh berikut: 

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

  4. 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 denganSourceAccount, misalnya:

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

    Ini mencegah masalah wakil yang membingungkan lintas layanan.

  5. 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 er API untuk memulai kontak obrolan.

    Untuk informasi tentang cara membuat klien SDK untuk memanggil Connect Customer API, lihat topik berikut:

  2. Pantau ContactId dan ParticipantToken dari StartChatContact 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 untuk mengaktifkan streaming pesan real-time ke topik SNS Anda.

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

    • Saat menelep StartContactStreaming on, Anda harus memberikan Nama Sumber Daya Amazon (ARN) dari topik SNS (lihatLangkah 1: Buat topik SNS standar).

      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 gil API untuk menerima pesan awal.

Langkah 4: Buat koneksi peserta

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.

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

  3. Penggunaan StopContactStreaming bersifat opsional dan tidak diperlukan jika obrolan ter putus 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.