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á.

# Habilite a análise de fluxos de segmentos de contato para analisar Contact Lens conversas
<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 sua instância do Connect Customer 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: use a mesma chave gerenciada pelo cliente para gravações de chamadas, transcrições de bate-papo ou relatórios exportados em sua instância do Connect Customer.

  Ative a criptografia e use uma chave gerenciada pelo cliente para gravações de chamadas, transcrições de bate-papo ou relatórios exportados em sua instância do Connect Customer. 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 existente ou crie uma nova e adicione as permissões necessárias para que a função Connect Customer 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` está o ARN da função vinculada ao serviço associada à sua instância do Connect Customer. **Para encontrar o ARN da função vinculada ao serviço, no console Connect Customer, acesse **Visão geral**, Configurações de **distribuição**, função. Service-linked ** 

## 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 Connect Customer 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 Connect Customer 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 Connect Customer instance}}',
  };

  const connect = new Connect(clientConfig);

  // Build request
  const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
    InstanceId: '{{your Connect Customer 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: ativar Contact Lens para sua instância Connect Customer
<a name="enable-segment-streams-step4"></a>

Para instruções, consulte [Habilite a análise conversacional em Lente de contato Connect Customer](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.