Como faço para integrar o Amazon Connect ao Amazon Kinesis?

Breve descrição

A ativação da transmissão de dados na sua instância do Amazon Connect permite que você transmita CTRs e eventos de atendente ao Amazon Kinesis Data Firehose ou ao Amazon Kinesis Data Streams. Eventos de atendente fornecem relatórios quase em tempo real sobre a atividade de atendentes na sua instância. CTRs fornecem dados quase em tempo real de eventos de contato, como chamadas de voz, chat e tarefas na sua instância.

Para integrar o Amazon Connect ao Kinesis Data Firehose ou ao Kinesis Data Streams, conclua as seguintes etapas:

1. Crie um fluxo de entrega do Kinesis Data Firehose ou um fluxo de dados do Kinesis.
2. Ative a transmissão de dados para sua instância.
3. Teste sua configuração.

Resolução

Criar um fluxo de entrega do Kinesis Data Firehose

Para integrar o Amazon Connect ao Kinesis Data Firehose, conclua as seguintes etapas:

1. Configure a origem, o destino e o nome do seu fluxo de entrega do Kinesis Data Firehose.
   Observação: o PUT direto permite criar um Kinesis Data Firehose que pode transmitir dados do Amazon Connect sem precisar criar um fluxo de dados do Kinesis. O fluxo do Kinesis exige que você crie um fluxo de dados do Kinesis para seus dados do Amazon Connect.
2. (Opcional) Configure o Kinesis Data Firehose para transformar e converter seus dados de registros.
3. (Opcional) Defina as configurações de backup e avançadas para o seu fluxo de entrega do Kinesis Data Firehose.
4. Ative a transmissão de dados para sua instância.
5. Teste seu fluxo de entrega usando dados de amostra.

Crie um fluxo de dados do Kinesis

Para integrar o Amazon Connect ao Kinesis Data Streams, conclua as seguintes etapas:

1. Crie um fluxo usando o Console de Gerenciamento da AWS.
2. Ative a transmissão de dados para sua instância.
3. Para testar sua configuração, conclua um dos seguintes conjuntos de etapas, dependendo do seu caso de uso:

Você ativou a transmissão de dados para eventos de contato:

1. Faça uma chamada de saída ou de entrada para criar um registro de contato na sua instância.
2. Confirme se o registro do contato foi gerado na UI de pesquisa de contatos.
3. Verifique o destino configurado no seu fluxo de entrega para ver o evento de registros de contato. Eventos de contato são entregues em massa. Você pode ver vários IDs de contato entregues ao destino ao mesmo tempo. Para ver um exemplo, consulte Exemplo de evento de contato para quando uma chamada de voz é conectada a um atendente.

-ou-

Você ativou a transmissão de dados para eventos de atendente:

1. Faça com que um atendente altere seu status ou se conecte a um contato para criar um evento de atendente.
2. Verifique o destino configurado para o fluxo de dados do Kinesis para o evento de atendente. O ARN do atendente é a chave de partição usada quando os dados são enviados ao fluxo de dados. Todos os eventos de um único atendente são enviados ao mesmo fragmento, e todos os eventos de refragmentação no fluxo são ignorados. Para ver um exemplo, consulte Exemplo de fluxo de eventos de atendente.

Identificar e solucionar erros

Não vejo dados publicados no meu destino de fluxo de entrega do Kinesis.

Para solucionar problemas de não visualização de dados publicados, tome uma ou mais das seguintes medidas:

• Confirme se o fluxo de dados do Kinesis que você selecionou está ativado para criptografia no lado do servidor. Se a criptografia no lado do servidor for ativada devido à falta de permissão para chamar kms:GenerateDataKey, o Amazon Connect não poderá publicar dados no fluxo. Para resolver esse problema, siga as etapas em usar a criptografia no lado do servidor para o fluxo do Kinesis.
• Teste seu fluxo de entrega usando a opção Test demo data (Testar dados de demonstração) no Kinesis Data Firehose para verificar se seu fluxo de entrega está configurado conforme o esperado.
• Analise a frequência de entrega de dados do Kinesis Data Firehose. A frequência de entrega de dados pode variar dependendo do destino selecionado. Se passarem cinco minutos e os dados não estiverem sendo entregues, revise as métricas do fluxo de entrega para registros recebidos. Você pode configurar o registro em log de erros do Kinesis Data Firehose para capturar erros de entrega de dados.

Não consigo selecionar o Kinesis Data Firehose ou o Kinesis Data Stream que eu criei quando ativei o fluxo de dados para o Amazon Connect.

Primeiro, confirme se o Kinesis Data Firehose ou o Kinesis Data Stream existem na mesma região da AWS que a instância do Amazon Connect. Se os serviços estiverem na mesma região, talvez falte uma permissão que permita listar o fluxo. Confirme se as seguintes permissões foram concedidas: ListDeliveryStreams para o Kinesis Data Firehose ou ListStreams para o Kinesis Data Streams.

Você também pode usar o comando associate-instance-storage-config da AWS Command Line Interface (AWS CLI) para ativar a transmissão de dados.

Observação: se receber erros ao executar comandos da AWS Command Line Interface (AWS CLI), verifique se está usando a versão mais recente da AWS CLI.

Onde posso acessar os eventos de atendente ou os registros de rastreamento de contatos (CTRs)?

Se eventos de atendente e CTRs forem enviados ao Kinesis Data Streams, use o visualizador de dados no console do Kinesis para ver os dados. Além disso, você pode configurar um consumidor para processar os dados do fluxo de dados do Kinesis. Por exemplo, você pode criar um Kinesis Data Firehose para consumir os dados do fluxo de dados do Kinesis para os eventos de atendente.

Se CTRs forem enviados ao Kinesis Data Firehose, eles ficarão acessíveis no destino configurado para o fluxo de entrega. Por exemplo, se o destino for um bucket do Amazon Simple Storage Service (Amazon S3), você poderá acessar os CTRs no bucket do S3 escolhido. Você escolhe o bucket de destino do Amazon S3 ao criar o Kinesis Data Firehose.

Posso configurar mais de um fluxo de entrega do Kinesis para registros de rastreamento de contatos (CTRs)?

Por padrão, somente um fluxo de entrega é compatível com CTRs. Mas você pode usar vários consumidores para ter vários fluxos de entrega de CTRs para um Kinesis Data Stream. Para usar essa configuração, o fluxo de dados do Kinesis deve atuar como produtor dos dados de CTRs. Em seguida, você pode configurar vários consumidores para ingerir os dados. Para obter mais informações sobre consumidores do Kinesis Data Streams, consulte Ler dados do Amazon Kinesis Data Streams.

Vejo dados duplicados do Amazon Connect publicados na minha aplicação do Kinesis Data Streams.

Dados duplicados podem ocorrer devido a novas tentativas do produtor e do consumidor. É uma boa prática fazer com que o destino dos dados finais manipule duplicatas para serem resilientes a novas tentativas.

---

Informações relacionadas

Fluxos de eventos de atendente do Amazon Connect

Eventos de contato do Amazon Connect

O que é o Amazon Kinesis Data Streams?

O que é o Amazon Kinesis Data Firehose?