As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Habilitar fluxos de segmentos de análise de contato para analisar conversas do Contact Lens
<a name="enable-contact-analysis-segment-streams"></a>

Os fluxos de segmentos de análise de contato não estão habilitados por padrão. Este tópico explica como habilitá-los. 

## Etapa 1: Criar um fluxo do Kinesis
<a name="enable-segment-streams-step1"></a>

Crie o fluxo de dados na mesma conta e região em que a instância do Amazon Connect reside. Para obter instruções, consulte [Step 1: Create a Data Stream](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html) no *Guia do desenvolvedor do Amazon Kinesis Data Streams*.

**dica**  
Recomendamos criar um fluxo separado para cada tipo de dados. Embora seja possível usar o mesmo fluxo para análise de contato, fluxos de segmentos, eventos de atendentes e registros de contatos, é muito mais fácil gerenciar e obter dados do fluxo usando um fluxo separado para cada um. Para obter mais informações, consulte o [Guia do desenvolvedor do Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). 

## Etapa 2: Configurar a criptografia do lado do servidor para o stream do Kinesis (opcional, mas recomendado)
<a name="enable-segment-streams-step2"></a>

Há várias maneiras de fazer isso. 
+ Opção 1: Usar o Kinesis Chave gerenciada pela AWS (`aws/kinesis`). Isso funciona sem nenhuma configuração adicional de sua parte.
+ Opção 2: Usar a mesma chave gerenciada pelo cliente para gravações de chamadas, transcrições de chat ou relatórios exportados na instância do Amazon Connect.

  Habilite a criptografia e use a mesma chave gerenciada pelo cliente para gravações de chamadas, transcrições de chat ou relatórios exportados na instância do Amazon Connect. Em seguida, escolha a mesma chave do KMS para o fluxo de dados do Kinesis. Essa chave já tem a permissão (concessão) necessária para ser usada.
+ Opção 3: Usar uma chave gerenciada pelo cliente.

  Use uma chave gerenciada pelo cliente que você já tenha ou crie uma e adicione as permissões requeridas para que a função do Amazon Connect use a chave. Para adicionar permissões usando o AWS KMS , consulte o seguinte exemplo:

  ```
  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
  ```

  Onde `grantee-principal` é o ARN da função vinculada ao serviço associada à instância do Amazon Connect. Para encontrar o ARN da função vinculada ao serviço, no console do Amazon Connect, acesse **Visão geral**, **Configurações de distribuição**, **Função vinculada ao serviço**. 

## Etapa 3: Associar o fluxo do Kinesis
<a name="enable-segment-streams-step3"></a>

Use a [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)API Amazon Connect para associar os seguintes tipos de recursos:
+ Para contatos de voz, use `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`
+ Para contatos de chat, use `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS`

**nota**  
`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` está obsoleto, mas continua compatível e se aplica somente aos contatos de voz. Use `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` para contatos de voz daqui para frente.  
Se você já associou um fluxo a `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS`, nenhuma ação será necessária para atualizar o fluxo para `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS`.

Especifique o fluxo do Kinesis em que os segmentos de análise de contato em tempo real serão publicados. Você precisará do ID da instância e do ARN do fluxo do Kinesis. O seguinte código mostra um exemplo:

```
// 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>

O exemplo a seguir é para contatos de chat.

**dica**  
Se você não incluir a AWS região (`--region`), ela usará a região padrão com base no perfil da CLI.  
O valor do parâmetro `--storage-config` não deve ser incluído entre aspas simples ('). Caso contrário, isso gerará um erro.

```
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>

O exemplo a seguir é para contatos de voz.

```
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'));
```

## Etapa 4: habilitar o Contact Lens para a instância do Amazon Connect
<a name="enable-segment-streams-step4"></a>

Para instruções, consulte [Habilitar a analytics de conversação no Amazon Connect Contact Lens](enable-analytics.md).

## Etapa 5 (opcional): Analisar um fluxo de segmentos de exemplo
<a name="enable-segment-streams-step5"></a>

Recomendamos que você analise um fluxo de segmentos de exemplo de [voz](sample-real-time-contact-analysis-segment-stream.md) ou [chat](chat-sample-real-time-contact-analysis-segment-stream.md) para se familiarizar com sua aparência.