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

Menyiapkan aliran acara Connect Customer Cases

Topik ini menjelaskan cara mengatur dan menggunakan aliran peristiwa kasus. Beberapa langkah orientasi mengharuskan Anda memanggil Connect Customer Cases API.

Langkah 1: Buat instance Connect Customer dan aktifkan Profil Pelanggan

Langkah 2: Tambahkan domain Cases ke instance Connect Customer Anda

Untuk petunjuk, lihat Aktifkan Kasus menggunakan konsol Connect Customer.

Jika Anda ingin menambahkan domain kasus menggunakan API, lihat API di Refer CreateDomain ensi API Connect Customer Cases.

Langkah 3: Buat templat kasus

Buat templat kasus. Pada Langkah 6: Test case event stream, Anda akan menggunakan template.

Jika Anda ingin membuat template kasus menggunakan API, lihat API di Refer CreateTemplate ensi API Connect Customer Cases.

Langkah 4: Aktifkan aliran peristiwa kasus dan pengaturan untuk menerima peristiwa ke dalam antrian SQS

Jalankan perintah berikut untuk mengaktifkan aliran peristiwa kasus untuk domain Kasus Anda. Setelah perintah ini berjalan, ketika kasus dibuat atau diperbarui, suatu peristiwa dipublikasikan ke bus default EventBridge layanan di akun Anda (itu harus Wilayah AWS sama dengan domain Kasus Anda).

aws connectcases put-case-event-configuration --domain-id dad5efb6-8485-4a55-8241-98a88EXAMPLE --event-bridge enabled=true

Secara default, acara yang diterbitkan oleh Connect Customer Cases hanya berisi metadata tentang kasus tersebut, sepertitemplateId,caseId,caseArn,approximateChangeTime, dan lainnya. Anda dapat menjalankan perintah berikut untuk mendapatkan informasi lebih lanjut tentang kasus (pada saat acara dibuat) untuk disertakan dalam acara.

# You can include any other field defined in your cases domain in the fields section.
# To list the fields that are defined in your cases domain, call the Cases ListFields API.
# To include case fields that you create (custom fields) in the event, enter the custom field ID.
aws connectcases put-case-event-configuration --domain-id YOUR_CASES_DOMAIN_ID --event-bridge "{
    \"enabled\": true, 
    \"includedData\": {
       \"caseData\": {
          \"fields\": [
          {
          \"id\": \"status\"
          },
          {
          \"id\": \"title\"
          },
          {
          \"id\": \"customer_id\"
          },
         {
          \"id\": \"your custom field ID\"
          }
        ]
      },
      \"relatedItemData\": {
      \"includeContent\": true
      }
    }
  }"

Selanjutnya, buat antrian Amazon SQS dan tetapkan itu sebagai target untuk peristiwa Connect Customer Cases di EventBridge bus Anda sehingga semua peristiwa kasus dikirimkan ke antrian SQS untuk diproses nanti.

# Create an SQS queue
aws sqs create-queue --queue-name case-events-queue --attributes "{\"Policy\": \"{ \\\"Version\\\": \\\"2012-10-17\\\", \\\"Statement\\\": [{ \\\"Sid\\\": \\\"case-event-subscription\\\", \\\"Effect\\\": \\\"Allow\\\", \\\"Principal\\\": { \\\"Service\\\": \\\"events.amazonaws.com\\\"}, \\\"Action\\\": \\\"SQS:SendMessage\\\", \\\"Resource\\\": \\\"*\\\"}]}\"}"

# Create an rule on the EventBridge default bus that represents the case events
aws events put-rule --name case-events-to-sqs-queue --event-pattern "{\"source\": [\"aws.cases\"], \"detail-type\": [\"Amazon Connect Cases Change\"]}" --state ENABLED

# Ask event bridge to publish case events to the SQS queue.
aws events put-targets --rule case-events-to-sqs-queue --target "[{
\"Id\": \"target-1\",
\"Arn\": \"arn:aws:sqs:The AWS Region of your Amazon Connect instance:your AWS account ID:case-events-queue\"
}]" 

Langkah 5: Aliran acara kasus uji

Gunakan aplikasi Connect Customer agent untuk:

Arahkan ke konsol Amazon SQS dan periksa apakah peristiwa kasus (tipe:CASE.CREATED) untuk kasus yang baru dibuat tersedia di Antrian SQS Anda. Demikian pula, Anda dapat memodifikasi kasus yang dibuat di atas dan mendapatkan peristiwa kasus yang sesuai (type:CASE.UPDATED) dalam antrian SQS Anda. Anda dapat mengaitkan kontak dengan kasus, dan meninggalkan komentar pada kasus tersebut untuk mendapatkan peristiwa kasus untuk tindakan tersebut juga.

Langkah 6: Gunakan kasus untuk aliran peristiwa kasus

Aliran peristiwa kasus mempublikasikan peristiwa setiap kali kasus dibuat, kasus diperbarui, kontak dikaitkan dengan kasus, dan komentar ditambahkan pada kasus. Anda dapat menggunakan acara ini untuk:

Misalnya, Anda dapat menggunakan target SQS aktif EventBridge (seperti yang ditunjukkan pada langkah 4) untuk menyimpan sementara peristiwa kasus dalam antrian SQS, dan menggunakan fungsi Lambda untuk memproses peristiwa di SQS untuk membangun aplikasi khusus seperti mengirim email ke pelanggan ketika kasus mereka diperbarui, secara otomatis menyelesaikan tugas apa pun yang terkait dengan kasus, dan banyak lagi. Demikian pula, Anda dapat menggunakan target Firehose pada EventBridge untuk menyimpan peristiwa kasus ke dalam bucket S3 dan kemudian menggunakan AWS Glue untuk ETL, Athena untuk analitik ad-hoc, dan Quick untuk dasbor.