

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 redação de dados confidenciais em andamento e o processamento de mensagens
<a name="redaction-message-processing"></a>

O Connect Customer suporta o processamento de mensagens que intercepta e modifica as mensagens de bate-papo antes que elas cheguem a qualquer participante. Esse recurso permite a redação automática de dados confidenciais e o processamento personalizado de mensagens, ajudando as empresas a manter os padrões de conformidade e segurança.

## Opções de processamento
<a name="redaction-message-processing-options"></a>

A seguir estão as opções de processamento, juntamente com os recursos de cada opção:

**Built-in redação de dados confidenciais**
+ Detecta e remove automaticamente categorias configuráveis de informações confidenciais, como números e nomes de cartões de crédito
+ Suporta vários idiomas, incluindo variantes em inglês, francês, português, alemão, italiano e espanhol. Para obter uma lista dos idiomas compatíveis com a redação do Conversational Analytics, consulte. [Idiomas suportados pelos recursos do Connect Customer](supported-languages.md)
+ Opte por redigir entidades de dados selecionadas ou todas as entidades de dados confidenciais
+ Substitua por espaços reservados genéricos ([PII]) ou espaços reservados específicos da entidade ([NAME], [CREDIT\_CARD])

**Processadores de mensagens personalizados (via Lambda)**

Com um processador Lambda personalizado, você tem a liberdade de transformar mensagens da maneira que quiser. Uma cópia de cada mensagem é enviada para sua função Lambda e, se uma resposta válida for recebida dentro do tempo limite, o conteúdo da resposta se tornará a nova forma canônica dessa mensagem.

Isso permite casos de uso como:
+ Tradução de idiomas por meio de serviços de terceiros
+ Filtragem de palavrões
+ AI/LLM-powered transformação de mensagens
+ Business-specific modificações de mensagens

Para obter mais informações sobre o Lambda, consulte [O que é o Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)? no *Lambda Developer Guide*.

## Como funciona
<a name="redaction-message-processing-how-it-works"></a>

Quando o processamento de mensagens está ativado, cada mensagem de texto simples, markdown e JSON passa pelo processador configurado antes de ser entregue aos participantes. O processador pode modificar, aprovar ou rejeitar a mensagem. Se o processamento falhar, você poderá configurar se a mensagem original não processada será entregue ou suprimida.

O processamento de mensagens permanece ativo durante toda a duração do bate-papo, mesmo que um segmento de contato individual termine (por exemplo, durante uma transferência). O processamento não se aplica retroativamente às mensagens enviadas antes de ser ativado.

**nota**  
Quando a redação integrada e um processador de mensagens personalizado são ativados simultaneamente, a saída da redação se torna a entrada para o processador personalizado.

## Configurar o processamento de mensagens
<a name="redaction-message-processing-configure"></a>

Você pode ativar o processamento de mensagens usando um dos seguintes métodos:
+ **Bloco de fluxo** — Use o bloco de fluxo **Definir comportamento de gravação, análise e processamento**. Para obter mais informações, consulte [Bloco de fluxo no Connect Customer: defina o comportamento de gravação, análise e processamento](set-recording-analytics-processing-behavior.md).
+ **API** — Chame a `StartContactMediaProcessing` API para ativação programática. Para obter mais informações, consulte [StartContactMediaProcessing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactMediaProcessing.html)a *Referência da API Connect Customer*.

Para interromper o processamento de mensagens antes que o bate-papo termine, chame a `StopContactMediaProcessing` API. Para obter mais informações, consulte [StopContactMediaProcessing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactMediaProcessing.html)a *Referência da API Connect Customer*.

**nota**  
As `StopContactMediaProcessing` APIs `StartContactMediaProcessing` e são apenas para processadores de mensagens personalizados (BYOP). Built-in a redação é configurada exclusivamente por meio do bloco de fluxo.

## Habilite a redação integrada de dados confidenciais
<a name="redaction-message-processing-builtin"></a>

In-flight a redação de dados confidenciais é impulsionada pelo Conversational Analytics. Para habilitá-lo, configure o bloco **Definir fluxo de comportamento de gravação, análise e processamento** com as seguintes configurações:

1. **Selecione Ação**: Escolha`Set recording and analytics behavior`.

1. **Selecione o canal**: escolha`Chat`.

1. **Ativar análise conversacional**: selecione **Ativar análise conversacional**.

1. Em **Configurar análise conversacional** > **Redação > redação** de **In-flight mensagem: selecione **Ativar** redação** em andamento.

![O bloco de fluxo Definir comportamento de gravação, análise e processamento configurado com a análise conversacional ativada para bate-papo.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/message-processing-enable-analytics.png)


![A configuração de redação de mensagens em andamento com a redação ativada.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/message-processing-redaction-config.png)


Para obter mais informações sobre como o Conversational Analytics edita dados confidenciais, consulte. [Habilitar a edição de dados confidenciais](enable-analytics.md#enable-redaction)

## Crie um processador de mensagens personalizado
<a name="redaction-message-processing-custom"></a>

Você pode criar uma função Lambda personalizada que transforma mensagens em andamento. Processadores personalizados podem realizar qualquer transformação, como tradução de idiomas, filtragem de palavrões ou AI-powered aprimoramento de mensagens.

**Adicione primeiro a função Lambda à sua instância**  
Antes de usar um processador Lambda personalizado, você deve adicioná-lo à sua instância do Connect Customer. No console Connect Customer, escolha **Flows**, escolha **Funções Lambda** e selecione o caso de uso **Processador personalizado** lambda.

### Etapa 1: Crie sua função Lambda
<a name="redaction-message-processing-custom-step1"></a>

**nota**  
O Connect Customer respeita o tempo limite configurado da sua função Lambda, que deve estar entre 3 segundos e 3 minutos.

Seu processador personalizado Lambda recebe um evento de entrada no seguinte formato:

```
{
  "version": "1.0",
  "instanceId": "string",
  "associatedResourceArn": "string",
  "chatContent": {
    "absoluteTime": "string",
    "content": "string",
    "contentType": "string",
    "id": "string",
    "participantId": "string",
    "displayName": "string",
    "participantRole": "string",
    "initialContactId": "string",
    "contactId": "string"
  }
}
```

Sua função Lambda deve retornar uma resposta no seguinte formato:

```
{
  "status": "PROCESSED | APPROVED | REJECTED",
  "result": {
    "processedChatContent": {
      "content": "string",
      "contentType": "text/plain | text/markdown | application/json"
    }
  }
}
```

O conteúdo processado substitui a mensagem original quando publicada para os participantes do bate-papo.

### Etapa 2: Conceder permissão ao Connect Customer para invocar sua função Lambda
<a name="redaction-message-processing-custom-step2"></a>

Você deve conceder permissão ao Connect Customer para invocar sua função Lambda:

1. No console Connect Customer, escolha sua instância.

1. No painel de navegação, escolha **Fluxos**.

1. Na seção **Lambda**, selecione sua função Lambda.

1. Em Caso de **uso do Lambda**, selecione. `Custom Processor Lambda`

Como alternativa, você pode usar a `CreateIntegrationAssociation` API com `IntegrationType` set to`MESSAGE_PROCESSOR`. Para obter mais informações, consulte [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)a *Referência da API Connect Customer*.

![A seção Lambda no console do Amazon Connect mostrando a seleção de casos de uso do processador personalizado Lambda.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/message-processing-lambda-integration.png)


### Etapa 3: ativar sua função Lambda
<a name="redaction-message-processing-custom-step3"></a>

Escolha um dos métodos a seguir para ativar seu processador personalizado:

**Opção 1: usar o bloco de fluxo**

**Configure o bloco de fluxo Definir comportamento de gravação, análise e processamento** com as seguintes configurações:

1. **Selecione Ação**: Escolha`Set message processor`.

1. **Selecione o canal**: escolha`Chat`.

1. **Ativar processamento**: marque a caixa de seleção.

1. **ARN da função**: selecione sua função Lambda.

1. **Tratamento de falhas de processamento**: escolha se deseja entregar a mensagem original não processada ou suprimi-la se o processamento falhar.

**Opção 2: usar a StartContactMediaProcessing API**

![O bloco de fluxo Definir comportamento de gravação, análise e processamento configurado com a ação Definir processador de mensagens para bate-papo.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/message-processing-activate-flow-block.png)


Como alternativa, você pode ativar o processamento de mensagens chamando a `StartContactMediaProcessing` API. Isso requer seu ID de instância, o ID de contato do chat, o ARN do processador Lambda e um modo de falha. Para obter mais informações, consulte [StartContactMediaProcessing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactMediaProcessing.html)a *Referência da API Connect Customer*.

## Mais informações
<a name="redaction-message-processing-additional"></a>

### Armazenamento de transcrições
<a name="redaction-message-processing-transcripts"></a>
+ As mensagens de bate-papo processadas substituem as mensagens originais na pasta S3 Chat Transcripts: `<bucket-name>/connect/<instance-name>/<path-prefix>/`
+ A transcrição do bate-papo não processada (original) é armazenada em uma pasta S3 separada: `<bucket-name>/connect/<instance-name>/Unprocessed<path-prefix>/`

### Considerações importantes
<a name="redaction-message-processing-considerations"></a>
+ O processamento de mensagens permanece ativo durante toda a duração do bate-papo, mesmo que um segmento de contato individual termine (por exemplo, durante uma transferência).
+ `StartContactMediaProcessing`e o bloco de fluxo de **comportamento de gravação, análise e processamento Set** não processa retroativamente mensagens anteriores.
+ Para interromper o processamento de mensagens antes que o bate-papo termine, chame a [StopContactMediaProcessing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactMediaProcessing.html)API.
+ O processamento de mensagens não está disponível na região AWS GovCloud (US-West).