Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Akses Contact Lens analitik untuk kontak suara dan obrolan menggunakan Amazon Kinesis Data Streams
Aliran segmen analisis kontak memungkinkan Anda mengakses Contact Lens analitik untuk kontak suara dan obrolan. Streaming mengatasi batasan penskalaan analitik [panggilan dan obrolan](contact-lens-api.md) yang ada. APIs Untuk kontak suara, ini juga menyediakan akses ke segmen data yang disebut `Utterance` yang memungkinkan Anda mengakses sebagian transkrip. Ini memungkinkan Anda memenuhi persyaratan latensi sangat rendah untuk membantu agen dalam panggilan langsung.
Bagian ini menjelaskan cara mengintegrasikan dengan Amazon Kinesis Data Streams untuk streaming.
Melalui streaming, Anda dapat menerima jenis acara berikut:
+ Acara MULAI diterbitkan pada awal sesi analisis kontak.
+ Acara SEGMENTS diterbitkan selama sesi analisis kontak. Peristiwa ini berisi daftar segmen dengan informasi yang dianalisis.
+ Acara SELESAI atau GAGAL diterbitkan pada akhir sesi analisis kontak.
**Topics**
+ [Aktifkan aliran segmen analisis kontak](enable-contact-analysis-segment-streams.md)
+ [Suara: Model data untuk aliran segmen analitik percakapan](real-time-contact-analysis-segment-streams-data-model.md)
+ [Obrolan: Model data untuk aliran segmen analitik percakapan](chat-real-time-contact-analysis-segment-streams-data-model.md)
+ [Suara: Contoh aliran segmen analitik percakapan](sample-real-time-contact-analysis-segment-stream.md)
+ [Obrolan: Contoh aliran segmen analitik percakapan](chat-sample-real-time-contact-analysis-segment-stream.md)
# Aktifkan aliran segmen analisis kontak untuk menganalisis percakapan Contact Lens
Aliran segmen analisis kontak tidak diaktifkan secara default. Topik ini menjelaskan cara mengaktifkannya.
## Langkah 1: Buat aliran Kinesis
Buat aliran data di akun dan Wilayah yang sama tempat instans Amazon Connect berada. Untuk petunjuknya, lihat [Langkah 1: Membuat Aliran Data](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html) di Panduan Pengembang *Amazon Kinesis Data Streams*.
**Tip**
Sebaiknya buat aliran terpisah untuk setiap jenis data. Meskipun dimungkinkan untuk menggunakan aliran yang sama untuk aliran segmen analisis kontak, peristiwa agen, dan catatan kontak, jauh lebih mudah untuk mengelola dan mendapatkan data dari aliran saat Anda menggunakan aliran terpisah untuk masing-masing aliran. Untuk informasi selengkapnya, lihat [Panduan Developer Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html).
## Langkah 2: Siapkan enkripsi sisi server untuk aliran Kinesis (opsional tetapi disarankan)
Ada beberapa cara Anda dapat melakukan ini.
+ Opsi 1: Gunakan Kinesis Kunci yang dikelola AWS ()`aws/kinesis`. Ini berfungsi tanpa pengaturan tambahan dari Anda.
+ Opsi 2: Gunakan kunci terkelola pelanggan yang sama untuk rekaman panggilan, transkrip obrolan, atau laporan yang diekspor di instans Amazon Connect Anda.
Aktifkan enkripsi, dan gunakan kunci yang dikelola pelanggan untuk rekaman panggilan, transkrip obrolan, atau laporan yang diekspor di instans Amazon Connect Anda. Kemudian pilih kunci KMS yang sama untuk aliran data Kinesis Anda. Kunci ini sudah memiliki izin (hibah) yang diperlukan untuk digunakan.
+ Opsi 3: Gunakan kunci yang dikelola pelanggan yang berbeda.
Gunakan kunci terkelola pelanggan yang sudah ada atau buat yang baru dan tambahkan izin yang diperlukan untuk peran Amazon Connect untuk menggunakan kunci tersebut. Untuk menambahkan izin menggunakan AWS KMS hibah, lihat contoh berikut:
```
aws kms create-grant \
--key-id your key ID \
--grantee-principal arn:aws:iam::your AWS account ID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_11111111111111111111 \
--operations GenerateDataKey \
--retiring-principal arn:aws:iam::your AWS account ID:role/adminRole
```
Di `grantee-principal` mana ARN dari peran terkait layanan yang terkait dengan instans Amazon Connect Anda. **Untuk menemukan ARN peran terkait layanan, di konsol Amazon Connect, buka **Gambaran Umum**, **Pengaturan distribusi**, peran terkait layanan.**
## Langkah 3: Kaitkan aliran Kinesis
Gunakan Amazon Connect [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)API untuk mengaitkan jenis sumber daya berikut:
+ Untuk kontak suara, gunakan `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`
+ Untuk kontak obrolan, gunakan `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS`
**catatan**
`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS`tidak digunakan lagi, tetapi masih didukung dan hanya berlaku untuk kontak suara. Gunakan `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` untuk kontak suara yang bergerak maju.
Jika sebelumnya Anda telah mengaitkan aliran dengan`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS`, tidak ada tindakan yang diperlukan untuk memperbarui aliran ke`REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`.
Tentukan aliran Kinesis di mana segmen analisis kontak real-time akan dipublikasikan. Anda akan memerlukan ID instance dan ARN aliran Kinesis. Kode berikut menunjukkan contoh:
```
// Build request
const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
InstanceId: 'your Amazon Connect instance ID',
ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS',
StorageConfig: {
StorageType: 'KINESIS_STREAM',
KinesisStreamConfig: {
StreamArn: 'the ARN of your Kinesis stream',
},
}
};
```
### AWS CLI
Contoh berikut adalah untuk kontak obrolan.
**Tip**
Jika Anda tidak menyertakan AWS Region (`--region`), ia menggunakan Region default berdasarkan profil CLI.
Nilai `--storage-config` parameter tidak boleh termasuk dalam kutipan tunggal ('). Kalau tidak, itu menimbulkan kesalahan.
```
aws connect associate-instance-storage-config \
--region "us-west-2" \
--instance-id your Amazon Connect instance ID \
--resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS \
--storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=the ARN of your Kinesis stream}
```
### AWS SDK
Contoh berikut adalah untuk kontak suara.
```
import { Connect } from 'aws-sdk';
async function associate (): Promise {
const clientConfig: Connect.ClientConfiguration = {
region: 'the Region of your Amazon Connect instance',
};
const connect = new Connect(clientConfig);
// Build request
const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
InstanceId: 'your Amazon Connect instance ID',
ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS',
StorageConfig: {
StorageType: 'KINESIS_STREAM',
KinesisStreamConfig: {
StreamArn: 'the ARN of your Kinesis stream',
},
}
};
try {
// Execute request
const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise();
// Process response
console.log('raw response: ${JSON.stringify(response, null, 2)}');
} catch (err) {
console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' +
'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}');
}
}
associate().then(r => console.log('Done'));
```
## Langkah 4: Contact Lens Aktifkan instans Amazon Connect Anda
Untuk petunjuk, lihat [Aktifkan analisis percakapan di Amazon Connect Contact Lens](enable-analytics.md).
## Langkah 5 (Opsional): Tinjau aliran segmen sampel
Kami menyarankan Anda meninjau aliran segmen sampel [suara](sample-real-time-contact-analysis-segment-stream.md) atau [obrolan](chat-sample-real-time-contact-analysis-segment-stream.md) untuk membiasakan diri dengan tampilannya.
# Model data untuk aliran segmen analitik percakapan untuk menganalisis kontak suara di Contact Lens
Aliran segmen analisis kontak waktu nyata dihasilkan di JSON. Gumpalan JSON peristiwa dipublikasikan ke aliran terkait untuk setiap kontak yang mengaktifkan analisis percakapan real-time. Jenis peristiwa berikut dapat dipublikasikan untuk sesi analisis percakapan untuk kontak suara:
+ ACARA YANG DIMULAI—Setiap sesi analisis percakapan menerbitkan satu acara STARTED di awal sesi.
+ Acara SEGMENT—Setiap sesi analisis percakapan dapat mempublikasikan nol atau lebih peristiwa SEGMENTS selama sesi berlangsung. Peristiwa ini berisi daftar segmen dengan informasi yang dianalisis. Untuk kontak suara, daftar segmen dapat mencakup segmen "`Utterance`“," `Transcript` “," `Categories` “, atau`PostContactSummary`"”.
+ Acara SELESAI atau GAGAL — Setiap sesi analisis percakapan menerbitkan satu peristiwa SELESAI atau GAGAL di akhir sesi.
## Properti umum termasuk dalam semua acara untuk kontak suara
Setiap acara mencakup properti berikut:
**Versi**
Versi skema acara.
Tipe: String
**Channel**
Jenis saluran untuk kontak ini.
Tipe: String
Nilai valid: `VOICE`, `CHAT`, `TASK`
Untuk informasi selengkapnya tentang saluran, lihat[Saluran dan konkurensi untuk merutekan kontak di Amazon Connect](channels-and-concurrency.md).
**AccountId**
Pengidentifikasi akun tempat kontak ini berlangsung.
Tipe: String
**ContactId**
Pengidentifikasi kontak yang sedang dianalisis.
Tipe: String
**InstanceId**
Pengidentifikasi contoh di mana kontak ini berlangsung.
Tipe: String
**LanguageCode**
Kode bahasa yang terkait dengan kontak ini.
Tipe: String
Nilai yang valid: kode bahasa untuk salah satu [bahasa yang didukung untuk analitik panggilan Contact Lens real-time](supported-languages.md#supported-languages-contact-lens).
**EventType**
Jenis acara yang diterbitkan.
Tipe: String
Nilai valid: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED`
## Acara DIMULAI
`STARTED`peristiwa hanya mencakup properti umum:
+ Versi
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: DIMULAI
## Acara SEGMENTS
`SEGMENTS`acara meliputi properti berikut:
+ Versi
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: SEGMEN
+ Segmen: Selain properti umum, `SEGMENTS` peristiwa mencakup daftar segmen dengan informasi yang dianalisis.
Jenis: Array objek [Segmen](#segment)
+ PostContactSummary: Informasi tentang ringkasan pasca-kontak untuk segmen kontak suara.
Jenis: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html)objek
Wajib: Tidak
**Segment**
Segmen yang dianalisis untuk sesi analisis waktu nyata.
Setiap segmen adalah objek dengan properti opsional berikut. Hanya satu dari properti ini yang ada, tergantung pada jenis segmen:
+ Ucapan
+ Transkrip
+ Kategori
+ PostContactSummary
**Ucapan**
Ucapan yang dianalisis.
Wajib: Tidak
+ **Id**
Pengidentifikasi ucapan.
Tipe: String
+ ** TranscriptId**
Pengidentifikasi transkrip yang terkait dengan ucapan ini.
Tipe: String
+ **ParticipantId**
Pengidentifikasi peserta.
Tipe: String
+ ** ParticipantRole**
Peran peserta. Misalnya, apakah itu pelanggan, agen, atau sistem.
Tipe: String
+ ** PartialContent**
Isi ucapannya.
Tipe: String
+ ** BeginOffsetMillis**
Offset awal dalam kontak untuk transkrip ini.
Jenis: Integer
+ ** EndOffsetMillis**
Offset akhir dalam kontak untuk transkrip ini.
Jenis: Integer
**Transkrip**
Transkrip yang dianalisis.
Jenis: [Objek transkrip](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html)
Wajib: Tidak
**Kategori**
Aturan kategori yang cocok.
Jenis: [Kategori](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Categories.html) objek
Wajib: Tidak
**PostContactSummary**
Informasi tentang ringkasan pasca-kontak untuk segmen kontak suara.
Tipe: Objek [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html)
Wajib: Tidak
## Acara selesai
`COMPLETED`peristiwa hanya mencakup properti umum berikut:
+ Versi
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: SELESAI
## Acara GAGAL
`FAILED`peristiwa hanya mencakup properti umum berikut:
+ Versi
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: GAGAL
# Model data untuk aliran segmen analitik percakapan untuk menganalisis obrolan di Contact Lens
Aliran segmen analisis percakapan untuk kontak obrolan dihasilkan di JSON. Gumpalan JSON peristiwa dipublikasikan ke aliran terkait untuk setiap kontak yang mengaktifkan analisis percakapan real-time. Jenis peristiwa berikut dapat dipublikasikan untuk sesi analisis percakapan untuk kontak obrolan:
+ ACARA YANG DIMULAI—Setiap sesi analisis percakapan menerbitkan satu acara STARTED di awal sesi.
+ Acara SEGMENT—Setiap sesi analisis percakapan dapat mempublikasikan nol atau lebih peristiwa SEGMENTS selama sesi berlangsung. Peristiwa ini berisi daftar segmen dengan informasi yang dianalisis. Untuk kontak obrolan, daftar segmen dapat mencakup segmen “`Attachments``Transcript`,” "`Categories`,” “`Events`,””`Issues`, “,” atau `PostContactSummary` "”.
+ Acara SELESAI atau GAGAL — Setiap sesi analisis percakapan menerbitkan satu peristiwa SELESAI atau GAGAL di akhir sesi.
## Properti umum termasuk dalam semua acara untuk kontak obrolan
Setiap acara mencakup properti berikut:
**Versi**
Versi skema acara. Untuk kontak obrolan, ini adalah 2.0.0.
Tipe: String
**Channel**
Jenis saluran untuk kontak ini.
Tipe: String
Nilai valid: `VOICE`, `CHAT`, `TASK`
Untuk informasi selengkapnya tentang saluran, lihat[Saluran dan konkurensi untuk merutekan kontak di Amazon Connect](channels-and-concurrency.md).
**AccountId**
Pengidentifikasi akun tempat kontak ini berlangsung.
Tipe: String
**InstanceId**
Pengidentifikasi contoh di mana kontak ini berlangsung.
Tipe: String
**ContactId**
Pengidentifikasi kontak yang sedang dianalisis.
Tipe: String
**StreamingEventType**
Jenis acara yang diterbitkan.
Tipe: String
Nilai valid: `STARTED`, `SEGMENTS`, `COMPLETED`, `FAILED`
**StreamingSettings**
Contact LensPengaturan untuk kontak ini
Tipe: Objek [StreamingSettings](#streamingsettingsobject)
## StreamingSettings objek
**LanguageCode**
Kode bahasa yang terkait dengan kontak ini.
Tipe: String
Nilai yang valid: kode bahasa untuk salah satu [bahasa yang didukung untuk analitik panggilan Contact Lens real-time](supported-languages.md#supported-languages-contact-lens).
**Output**
Jenis Contact Lens output diaktifkan untuk kontak ini.
Tipe: String
Nilai valid: `Raw`, `Redacted`, `RedactedAndRaw`
**RedactionTypes**
Jenis redaksi diaktifkan untuk kontak ini.
Jenis: Array dari String
Nilai yang valid: `PII`
**RedactionTypesMetadata**
Metadata redaksi untuk setiap jenis redaksi.
Jenis: RedactionType string ke [RedactionMetadata](#redactionmetadata)objek
Nilai yang valid: `PII`
## RedactionMetadata objek
Memberikan informasi tentang pengaturan redaksi.
**RedactionMaskMode**
Pengaturan penggantian redaksi data
Tipe: String
Nilai valid: `PII`, `EntityType`
## Acara DIMULAI
`STARTED`peristiwa hanya mencakup properti umum:
+ Versi
+ Channel
+ AccountId
+ ContactId
+ StreamingEventType: DIMULAI
+ StreamingSettings
## Acara SEGMENTS
`SEGMENTS`acara meliputi properti berikut:
+ Versi
+ Channel
+ AccountId
+ OutputType
+ Jenis Contact Lens output dari segmen saat ini
+ Tipe: String
+ Nilai valid: `Raw`, `Redacted`
+ ContactId
+ StreamingEventType: SEGMEN
+ StreamingSettings
+ Segmen
+ Daftar segmen dengan informasi yang dianalisis.
+ Jenis: Array objek [Segmen](#chat-segment)
**Segment**
Segmen yang dianalisis untuk sesi analisis waktu nyata.
Setiap segmen adalah objek dengan properti opsional berikut. Hanya satu dari properti ini yang ada, tergantung pada jenis segmen:
+ [Lampiran](#chat-attachments)
+ [Kategori](#chat-category)
+ [Peristiwa](#chat-event)
+ [Masalah](#chat-issues)
+ [Transkrip](#chat-transcript)
+ [PostContactSummary](#chat-postcontactsummary)
**Lampiran**
Lampiran yang dianalisis.
Wajib: Tidak
Tipe: Objek [RealTimeContactAnalysisSegmentAttachments](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentAttachments.html)
**Kategori**
Aturan kategori yang cocok.
Tipe: Objek [RealTimeContactAnalysisSegmentCategories](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentCategories.html)
Wajib: Tidak
**Peristiwa**
Jenis segmen yang menjelaskan peristiwa kontak.
Tipe: Objek [RealTimeContactAnalysisSegmentEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentEvent.html)
Wajib: Tidak
**Masalah**
Jenis segmen yang berisi daftar masalah yang terdeteksi.
Tipe: Objek [RealTimeContactAnalysisSegmentIssues](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentIssues.html)
Wajib: Tidak
**Transkrip**
Segmen transkrip yang dianalisis.
Tipe: Objek [RealTimeContactAnalysisSegmentTranscript](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentTranscript.html)
Wajib: Tidak
**PostContactSummary**
Informasi tentang ringkasan pasca-kontak untuk segmen kontak real-time untuk obrolan.
Tipe: Objek [RealTimeContactAnalysisSegmentPostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentPostContactSummary.html)
Wajib: Tidak
## Acara selesai
`COMPLETED`peristiwa hanya mencakup properti umum berikut:
+ Versi
+ Channel
+ AccountId
+ InstanceId
+ ContactId
+ StreamingEventType: SELESAI
+ StreamingSettings
## Acara GAGAL
`FAILED`peristiwa hanya mencakup properti umum berikut:
+ Versi
+ Channel
+ AccountId
+ InstanceId
+ ContactId
+ StreamingEventType: GAGAL
+ StreamingSettings
# Contoh aliran segmen analisis percakapan untuk menganalisis panggilan menggunakan Contact Lens
Topik ini menyediakan contoh aliran segmen untuk peristiwa STARTED, SEGMENTS, COMPLETED, dan FAILED yang dapat terjadi selama kontak suara.
## Contoh acara DIMULAI
+ EventType: DIMULAI
+ Diterbitkan di awal sesi analisis percakapan.
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "STARTED"
}
```
## Contoh acara SEGMENTS
+ EventType: SEGMEN
+ Diterbitkan selama sesi analisis percakapan. Acara ini berisi daftar segmen dengan informasi yang dianalisis. Daftar segmen dapat mencakup segmen “`Utterance`,” `Categories` "”`Transcript`, “” atau `PostContactSummary` “”.
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "SEGMENTS",
"Segments": [
{
"Utterance": {
"Id": "7b48ca3d-73d3-443a-bf34-a9e8fcc01747",
"TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"PartialContent": "Hello, thank you for calling Example Corp. My name is Adam.",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22980
}
},
{
"Utterance": {
"Id": "75acb743-2154-486b-aaeb-c960ae290e88",
"TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"PartialContent": "How can I help you?",
"BeginOffsetMillis": 23000,
"EndOffsetMillis": 24598
}
},
{
"Transcript": {
"Id": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"Content": "Hello, thank you for calling Example Corp. My name is Adam. How can I help you?",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 24598,
"Sentiment": "NEUTRAL"
}
},
{
"Transcript": {
"Id": "4295e927-43aa-4447-bbfc-8fccc2027530",
"ParticipantId": "CUSTOMER",
"ParticipantRole": "CUSTOMER",
"Content": "I'm having trouble submitting the application, number AX876293 on the portal. I tried but couldn't connect to my POC on the portal. So, I'm calling on this toll free number",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690,
"Sentiment": "NEGATIVE",
"IssuesDetected": [
{
"CharacterOffsets": {
"BeginOffsetChar": 0,
"EndOffsetChar": 81
}
}
]
}
},
{
"Categories": {
"MatchedCategories": [
"CreditCardRelated",
"CardBrokenIssue"
],
"MatchedDetails": {
"CreditCardRelated": {
"PointsOfInterest": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
},
"CardBrokenIssue": {
"PointsOfInterest": [
{
"BeginOffsetMillis": 25000,
"EndOffsetMillis": 29690
}
]
}
}
}
},
{
"PostContactSummary": {
"Content": "Customer contacted Example Corp because of an issue with their application",
"Status": "COMPLETED"
}
}
]
}
```
## Contoh acara SELESAI
+ EventType: SELESAI
+ Diterbitkan di akhir sesi analisis percakapan jika analisis berhasil diselesaikan.
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "COMPLETED"
}
```
## Contoh acara GAGAL
+ EventType: GAGAL
+ Diterbitkan di akhir sesi analisis percakapan jika analisis gagal.
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "FAILED"
}
```
# Contoh aliran analitik percakapan untuk menganalisis obrolan Contact Lens
Topik ini menyediakan contoh aliran segmen untuk peristiwa MULAI, SEGMEN, SELESAI, dan GAGAL yang terjadi selama kontak obrolan.
## Contoh acara DIMULAI
+ EventType: DIMULAI
+ Diterbitkan di awal sesi analisis percakapan.
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "STARTED",
"StreamingSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": [
"PII"
],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```
## Contoh acara SEGMENTS
+ EventType: [SEGMEN](chat-real-time-contact-analysis-segment-streams-data-model.md#chat-segment-streams-data-model-segments-event)
+ Diterbitkan selama sesi analisis percakapan. Acara ini berisi daftar [RealtimeContactAnalysisSegment](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealtimeContactAnalysisSegment.html)objek dengan informasi yang dianalisis. Daftar segmen dapat mencakup`"Transcript"`,,`"Categories"`,`"Issue"`, `"Event"``"Attachment"`, atau “PostContactSummary” segmen.
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"OutputType": "Redacted",
"StreamingEventType": "SEGMENTS",
"StreamingSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": [
"PII"
],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
},
"Segments": [{
"Transcript": {
"Id": "07a2d668-5c9e-4f69-b2fe-986261b0743a",
"ParticipantId": "a309ac1e-ca87-44ca-bb5d-197eca8ed77a",
"ParticipantRole": "AGENT",
"DisplayName": "[PII]",
"Content": "Hello, thank you for contacting Example Corp. My name is Ray.",
"ContentType": "text/markdown",
"Time": {
"AbsoluteTime": "2024-03-14T19:39:26.715Z"
},
"Sentiment": "NEUTRAL"
}
}, {
"Categories": {
"MatchedDetails": {
"Hi": {
"PointsOfInterest": [{
"TranscriptItems": [{
"Id": "5205b050-8aa9-4645-a381-a308801649ab",
"CharacterOffsets": {
"BeginOffsetChar": 0,
"EndOffsetChar": 40
}
}]
}]
}
}
}
}, {
"Issues": {
"IssuesDetected": [{
"TranscriptItems": [{
"Content": "I have an issue with my bank account",
"Id": "0e5574a7-2aeb-4eab-8bb5-3a7f66a2284a",
"CharacterOffsets": {
"BeginOffsetChar": 7,
"EndOffsetChar": 43
}
}]
}]
}
}, {
"Attachments": {
"Id": "06ddc1eb-2302-4a8e-a73f-37687fe41aa9",
"ParticipantId": "7810b1de-cca8-4153-b522-2498416255af",
"ParticipantRole": "CUSTOMER",
"DisplayName": "Customer",
"Attachments": [{
"AttachmentName": "Lily.jpg",
"ContentType": "image/jpeg",
"AttachmentId": "343e34da-391a-4541-8b7e-3909d931fcfa",
"Status": "APPROVED"
}],
"Time": {
"AbsoluteTime": "2024-03-14T19:39:26.715Z"
}
}
}, {
"Event": {
"Id": "fbe61c5f-d0d8-4345-912a-4e81f5734d3b",
"ParticipantId": "7810b1de-cca8-4153-b522-2498416255af",
"ParticipantRole": "CUSTOMER",
"DisplayName": "Customer",
"EventType": "application/vnd.amazonaws.connect.event.participant.left",
"Time": {
"AbsoluteTime": "2024-03-14T19:40:00.614Z"
}
}
},
{
"PostContactSummary": {
"Content": "Customer contacted Example Corp because of an issue with their bank account",
"Status": "COMPLETED"
}
}]
}
```
## Contoh acara SELESAI
+ EventType: SELESAI
+ Diterbitkan di akhir sesi analisis percakapan jika analisis berhasil diselesaikan.
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "COMPLETED",
"StreamingEventSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": ["PII"],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```
## Contoh acara GAGAL
+ EventType: GAGAL
+ Diterbitkan di akhir sesi analisis percakapan jika analisis gagal.
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "FAILED",
"StreamingEventSettings": {
"LanguageCode": "en-US",
"Output": "RedactedAndRaw",
"RedactionTypes": ["PII"],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```