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á.
# Usar logs de fluxo para rastrear eventos nos fluxos do Amazon Connect
Amazon Connect os registros de fluxo fornecem detalhes em tempo real sobre eventos em seus fluxos à medida que os clientes interagem com eles. É possível usar os logs de fluxo para ajudar a depurar os fluxos que você está criando. Se necessário, sempre é possível [reverter ](flow-version-control.md#rollback)para uma versão anterior de um fluxo.
Acesse abaixo uma visão geral do registro em log de fluxos e interações de bots.
+ **Registros de fluxo armazenados em um CloudWatch grupo**. Use esses logs para identificar gargalos no design do fluxo, depurar problemas de fluxo em tempo real e analisar os padrões da jornada do cliente.
Os logs de fluxo ajudam você a acompanhar os clientes entre diferentes fluxos incluindo o ID do contato em cada entrada de log. Você pode consultar os logs com relação ao ID de contato para rastrear a interação do cliente por meio de cada fluxo.
O registro do CloudWatch grupo é criado automaticamente quando a [opção Ativar registro de fluxo](contact-flow-logs.md#enable-contact-flow-logs) é selecionada para sua instância no console do Amazon Connect. No entanto, para habilitar o registro em log, você também precisa adicionar um bloco **Definir comportamento de log** ao seu fluxo. Para instruções, consulte [Ative os registros de fluxo do Amazon Connect em um grupo de CloudWatch registros da Amazon](contact-flow-logs.md).
+ **Logs de interação automatizados**. Use esses logs para analisar a qualidade das conversas entre clientes e bots, entender as consultas comuns dos clientes e melhorar as respostas dos bots.
Esses logs são salvos em um bucket do S3 que é criado quando você [seleciona](monitor-automated-interaction-logs.md) as seguintes opções para sua instância no console do Amazon Connect:
+ **Habilite a gravação de chamadas** e crie ou selecione seu bucket do S3 na página **Armazenamento de dados**. O log de interação automatizado é armazenado no mesmo local do S3 que a gravação da sua chamada.
+ **Habilite os logs de interação automatizados** na página **Fluxos**. Essa opção habilita o registro em log dos principais pontos de interação, como fluxos, prompts, menus e seleções de teclado. Esse registro automatizado está disponível em seu armazenamento S3 e na página de **detalhes de contato** no site Amazon Connect administrativo.
+ **Habilite analytics e transcrições de bots** no Amazon Connect, na página **Fluxos**. Essa opção garante que o log inclua a transcrição do bot Amazon Lex.
**Topics**
+ [Armazenamento para logs de fluxo](contact-flow-logs-stored-in-cloudwatch.md)
+ [Habilitar logs de fluxo](contact-flow-logs.md)
+ [Pesquisar logs de fluxo](search-contact-flow-logs.md)
+ [Dados em logs de fluxo](contact-flow-log-data.md)
+ [Rastrear clientes entre vários fluxos na central de atendimento](contact-flow-log-multiple-flows.md)
+ [Criar alertas para os eventos em seus logs de fluxo](contact-flow-log-alerts.md)
+ [Monitorar interações automatizadas (IVR)](monitor-automated-interaction-logs.md)
# Registros de fluxo armazenados em um grupo de Amazon CloudWatch registros
Os registros de fluxo são armazenados em um grupo de Amazon CloudWatch registros, na mesma AWS região da sua Amazon Connect instância. Esse grupo de logs é criado automaticamente quando [Habilitar o registro em log de fluxos](contact-flow-logs.md#enable-contact-flow-logs) está habilitado para a instância.
Por exemplo, a imagem a seguir mostra os grupos de CloudWatch registros de duas instâncias de teste.
![\[O CloudWatch console da Amazon, grupos de registros, aws/connect/mytest /88 e mytest89.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/cloudwatch-log-group.png)
Uma entrada de log é adicionada à medida que cada bloco do fluxo é acionado. Você pode configurar CloudWatch para enviar alertas quando ocorrerem eventos inesperados durante fluxos ativos.
**O que acontecerá se meu grupo de logs for excluído?** Você precisa recriar manualmente o grupo de CloudWatch registros. Caso contrário, Amazon Connect não publicará mais registros.
## Definição de preço para registro em log de fluxos
Você não será cobrado por gerar logs de fluxo, mas será cobrado por usar o CloudWatch para gerar e armazenar os logs. Os clientes do nível gratuito são cobrados apenas pelo uso que ultrapassar as cotas de serviço. Para obter detalhes sobre Amazon CloudWatch preços, consulte [Amazon CloudWatch Preços](https://aws.amazon.com/cloudwatch/pricing/).
# Ative os registros de fluxo do Amazon Connect em um grupo de CloudWatch registros da Amazon
Por padrão, quando você cria uma nova instância do Amazon Connect, um grupo de CloudWatch registros da Amazon é criado automaticamente para armazenar os registros da sua instância.
**dica**
Amazon Connect fornece registros de fluxo pelo menos uma vez. Eles podem ser entregues novamente por vários motivos. Por exemplo, uma nova tentativa de serviço devido a uma falha inevitável.
## Etapa 1: Habilitar o registro em log para a instância
Use o procedimento a seguir para verificar se o registro em log está habilitado para sua instância.
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Na página Instâncias, escolha o alias da instância. O alias da instância também é o **nome da instância**, que aparece no URL do Amazon Connect. A imagem a seguir mostra a página **Instâncias da central de atendimento virtual do Amazon Connect**, com uma caixa ao redor do alias da instância.
![\[Página Instâncias da central de atendimento virtual do Amazon Connect e o alias da instância.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/instance.png)
1. No painel de navegação, escolha **Fluxos**.
1. Selecione **Habilitar logs de fluxo** e escolha **Salvar**.
## Etapa 2: Usar o bloco Definir comportamento de registro em log
Os logs são gerados somente para fluxos que incluem um bloco [Set logging behavior](set-logging-behavior.md) com o registro em log definido como habilitado.
Você controla para quais fluxos ou partes de fluxos os logs são gerados ao incluir vários blocos **Definir comportamento de registro em log** e configurá-los conforme necessário.
Quando você usa um bloco **Set logging behavior (Definir comportamento de log)** para habilitar ou desabilitar o registro em log para um fluxo, o registro também é habilitado ou desabilitado para qualquer fluxo subsequente para o qual um contato é transferido, mesmo que o fluxo não inclua um bloco **Set logging behavior (Definir comportamento de log)**. Para evitar o registro em log que persiste entre fluxos, habilite ou desabilite um bloco **Definir comportamento de registro em log** conforme necessário para esse fluxo específico.
**Para habilitar ou desabilitar os logs de fluxo para um fluxo**
1. No designer de fluxo, adicione um bloco [Set logging behavior](set-logging-behavior.md) e conecte-o a outro bloco no fluxo.
1. Abra as propriedades do bloco. Escolha **Enable (Habilitar)** ou **Disable (Desabilitar)**.
1. Escolha **Salvar**.
1. Se você adicionar um bloco **Definir comportamento de log** a um fluxo que já foi publicado, deverá publicá-lo novamente para começar a gerar logs para ele.
# Registros de fluxo de pesquisa armazenados em um grupo de CloudWatch registros da Amazon
Antes de pesquisar logs de fluxo, você deve primeiro [habilitar o registro em logs de fluxo](contact-flow-logs.md).
Os logs serão criados para conversas que ocorrerem após a ativação do registro.
**Para pesquisar logs de fluxo**
1. Abra o Amazon CloudWatch console, acesse **Registros**, **Grupos de registros**. A imagem a seguir mostra um exemplo de grupo de logs chamado **mytest88**.
![\[O CloudWatch console da Amazon, seção de grupos de registros.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/cloudwatch-log-group.png)
1. Escolha o grupo de logs para sua instância.
Você verá uma lista de fluxos de logs.
1. Para pesquisar todos os fluxos de logs na instância, escolha **Pesquisar grupo de logs**, conforme mostrado na imagem a seguir.
![\[O botão do grupo de registros de pesquisa na página aws/connect/mytest /88.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-flow-logs-choose-search.png)
1. Na caixa de pesquisa, insira a string que você deseja pesquisar, por exemplo, toda ou parte do ID do contato.
1. Depois de alguns momentos (mais dependendo do tamanho do seu registro), Amazon CloudWatch retorna os resultados. A imagem a seguir mostra um exemplo de ID de contato **fb3304c2** e o resultado.
![\[Os eventos de logs listados para mytest88.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-flow-logs-search-results.png)
1. Você pode abrir cada evento para ver o que aconteceu. A imagem a seguir mostra o evento de quando um bloco **Reproduzir mensagem** é executado em um fluxo.
![\[O evento para um bloco Reproduzir mensagem.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/contact-flow-logs-example-event.png)
# Dados em registros de fluxo armazenados em um grupo de CloudWatch registros da Amazon
As entradas de log para fluxos incluem detalhes sobre o bloco associado à entrada de log, o ID do contato e a ação executada depois que as etapas no bloco foram concluídas. Qualquer interação de contato que ocorra fora do fluxo não é registrada, como o tempo gasto em uma fila ou interações com um atendente.
Você pode definir as propriedades do bloco para desabilitar o registro em log nas partes do fluxo que capturam, ou interagem com, dados confidenciais ou informações pessoais dos clientes.
Se você usa Amazon Lex ou AWS Lambda em seus fluxos, os registros mostram a entrada e a saída do fluxo que vai até eles e incluem qualquer informação sobre a interação que é enviada ou recebida durante a entrada ou saída.
Como os logs de fluxo também incluem o ID, e o ID de fluxo permanece o mesmo quando você altera um contato, é possível usar os logs para comparar as interações com diferentes versões do fluxo.
O exemplo de entrada de log a seguir mostra um bloco **Definir fila de trabalho** de um fluxo de entrada.
```
{
"ContactId": "11111111-2222-3333-4444-555555555555",
"ContactFlowId": "arn:aws:connect:us-west-2:0123456789012:instance/nnnnnnnnnnn-3333-4444-5555-111111111111/contact-flow/123456789000-aaaa-bbbbbbbbb-cccccccccccc",
"ContactFlowModuleType": "SetQueue",
"Timestamp": "2021-04-13T00:14:31.581Z",
"Parameters": {
"Queue": "arn:aws:connect:us-west-2:0123456789012:instance/nnnnnnnnnnn-3333-4444-5555-111111111111/queue/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
}
```
# Rastrear clientes entre vários fluxos na central de atendimento
Em muitos casos, os clientes interagem com vários fluxos da central de atendimento, sendo passados de um fluxo para outro para ajudá-los com seu problema específico de forma adequada. Os logs de fluxo ajudam você a rastrear clientes entre diferentes fluxos incluindo o ID do contato em cada entrada de log.
Quando um cliente é transferido para outro fluxo, o ID do contato associado à interação é incluído com o log para o novo fluxo. Você pode consultar os logs com relação ao ID de contato para rastrear a interação do cliente por meio de cada fluxo.
Em centrais de contatos maiores e de alto volume, é possível que existam vários fluxos para os logs de fluxo. Se um contato é transferido para outro fluxo, o log pode estar em um fluxo diferente. Para ter certeza de que você está encontrando todos os dados de registro de um contato específico, você deve pesquisar a ID do contato em todo o grupo de CloudWatch registros em vez de em um fluxo de registro específico.
Para obter um diagrama que mostre quando um novo registro de contato é criado, consulte [Eventos no registro de contato](about-contact-states.md#ctr-events).
# Crie alertas para eventos em seus registros de fluxo armazenados em um grupo de CloudWatch registros da Amazon
Você pode configurar CloudWatch para definir um padrão de filtro que procure eventos específicos em seus registros de fluxo e crie um alerta quando uma entrada desse evento for adicionada ao registro.
Por exemplo, você pode definir um alerta para quando um bloco de fluxo é direcionado para um caminho de erro quando um cliente interage com o fluxo. Normalmente, as entradas de registro CloudWatch ficam disponíveis em pouco tempo, fornecendo notificações quase em tempo real de eventos em fluxos.
# Monitorar interações automatizadas (IVR) no Amazon Connect
Você pode usar logs de interação automatizados para analisar a parte automatizada da experiência de seus clientes com o Amazon Connect. Os logs de interação aparecem na página **Detalhes do contato**. Eles incluem as seguintes informações:
+ Principais pontos de interação, ou seja, fluxos, prompts, menus, seleções de teclado.
+ Uma transcrição completa do bot.
É possível usar os logs para monitorar e melhorar suas interações automatizadas com os clientes e manter registros de áudio e execução do sistema da interação para fins de conformidade.
## Habilitar logs de interação automatizados
Conclua as etapas a seguir para conferir se os logs de interação automatizados estão habilitados para sua instância do Amazon Connect.
**nota**
Atualmente, o Amazon Connect não oferece suporte a buckets do S3 com o [Bloqueio de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html) ativado.
1. Abra o console do Amazon Connect em [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. Os logs de interações automatizados são salvos no **bucket do S3 que você configurou para gravações de chamadas**. Se o recurso de gravação de chamadas ainda não estiver habilitado para sua instância, habilite-o agora.
1. No painel de navegação, escolha **Armazenamento de dados**, **Gravações de chamadas**, **Editar**, **Habilitar gravação de chamadas** e crie ou selecione seu bucket do S3.
1. No painel de navegação, escolha **Fluxos**.
1. Selecione **Habilitar analytics e transcrições de bots no Amazon Connect**. Escolha essa opção para registrar em log uma transcrição completa da parte do Amazon Lex da experiência do cliente. A transcrição fica então disponível para você ler na página **Detalhes do contato**.
1. Selecione **Habilitar logs de interação automatizados**. Escolha essa opção para registrar em log os principais pontos de interação, como fluxos, prompts, menus e seleções de teclado. É possível ver o log de interações e ouvir a gravação de áudio, se disponível, na página **Detalhes do contato**.
## Permissões para logs de interação automatizados
Para manter os dados do cliente seguros, você pode configurar permissões para ter controle detalhado sobre quem pode acessar os logs de interação automatizados. O acesso aos logs de interação automatizados é limitado pelas seguintes permissões de perfil de segurança:
+ Permissões de **Fluxos** e **Módulos de fluxo - visualizar**: essas permissões são necessárias para ver dados específicos do fluxo e do módulo nos logs de interação automatizados.
+ Permissões de **Analytics e otimização** - **transcrições de voz de interação automatizadas (IVR) (não editadas)**: essas permissões são necessárias para acessar logs da interação de IVR, como entradas de teclado em resposta a prompts de IVR, transcrições de interações com o Lex etc.
## Navegar por logs de interações automatizados e gravação de áudio
A imagem a seguir mostra um exemplo de um registro de interação automatizado na página de **detalhes de contato** no site Amazon Connect administrativo.
![\[Um exemplo de log de interação automatizado.\]](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/automated-interaction-log.png)
**Como navegar pelo log**
1. Use guias para alternar entre a interação automatizada e a interação do agente para ver a end-to-end interação do seu cliente.
1. Escolha **Mostrar detalhes do fluxo** para ocultar detalhes do sistema sobre os fluxos e os blocos de fluxo.
1. Escolha o fluxo e os hiperlinks do bloco para abrir o designer de fluxo em uma nova guia, permitindo acompanhar rapidamente seu fluxo.
1. Escolha **Reproduzir** para reproduzir o prompt específico em seu arquivo de gravação de áudio.
**nota**
Se nenhuma gravação de áudio estiver disponível, não haverá opção para reproduzir o prompt.
1. Veja rapidamente onde ocorreram erros, incluindo tempos limite do cliente ou erros da função do Lambda.
1. Veja onde as intenções dos bots são detectadas e resolvidas.