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

# Aktifkan aliran segmen analisis kontak untuk menganalisis percakapan Contact Lens
<a name="enable-contact-analysis-segment-streams"></a>

Aliran segmen analisis kontak tidak diaktifkan secara default. Topik ini menjelaskan cara mengaktifkannya. 

## Langkah 1: Buat aliran Kinesis
<a name="enable-segment-streams-step1"></a>

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)
<a name="enable-segment-streams-step2"></a>

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
<a name="enable-segment-streams-step3"></a>

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
<a name="step3-cli"></a>

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
<a name="step3-sdk"></a>

Contoh berikut adalah untuk kontak suara.

```
import { Connect } from 'aws-sdk';

async function associate (): Promise <void> {
  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
<a name="enable-segment-streams-step4"></a>

Untuk petunjuk, lihat [Aktifkan analisis percakapan di Amazon Connect Contact Lens](enable-analytics.md).

## Langkah 5 (Opsional): Tinjau aliran segmen sampel
<a name="enable-segment-streams-step5"></a>

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.