Ativar a reprodução de áudio

Nesta página, descrevemos como ativar a reprodução de áudio no console do Customer Experience Insights usando URLs assinados.

Com a reprodução de áudio ativada, você pode ouvir o áudio da conversa diretamente no console do CX Insights. A reprodução de áudio usa URLs assinados para fornecer acesso autenticado e por tempo limitado a arquivos de áudio armazenados nos seus buckets do Cloud Storage. Isso elimina a necessidade de conceder aos usuários acesso direto aos buckets do Cloud Storage para reprodução de áudio.

Antes de começar

Para reproduzir áudio no console do CX Insights, os usuários precisam de permissão para gerar URLs de áudio assinados. A permissão necessária do IAM depende de como a conversa está sendo acessada:

  • Para todas as conversas: a permissão contactcenterinsights.conversations.generateSignedAudio está nos papéis predefinidos Contact Center AI Insights viewer e Contact Center AI Insights editor.
  • Para todas as conversas acessadas por um conjunto de dados: a permissão contactcenterinsights.datasets.generateSignedAudio está nas funções predefinidas Contact Center AI Insights viewer e Contact Center AI Insights editor.
  • Para acesso refinado por uma visualização autorizada:a permissão contactcenterinsights.authorizedConversations.generateSignedAudio está nos papéis predefinidos Contact Center AI Insights authorizedViewer e Contact Center AI Insights authorizedEditor.

Para mais informações sobre permissões detalhadas com visualizações autorizadas, consulte Visão geral do controle de acesso detalhado.

Antes de começar, siga estas etapas:

  1. Verifique se você importou conversas por voz para o CX Insights e se elas têm URIs de áudio apontando para arquivos de áudio em um bucket do Cloud Storage. Isso pode ser feito das seguintes maneiras:
  2. Encontre o número do projeto Google Cloud na página Configurações do projeto.

Ativar a reprodução de áudio

Para ativar a reprodução de áudio usando URLs assinados, conceda à conta de serviço do CX Insights acesso ao seu bucket do Cloud Storage e configure o compartilhamento de recursos entre origens (CORS) no bucket.

Conceder acesso da conta de serviço ao bucket do Cloud Storage

  • O CX Insights exige acesso ao bucket do Cloud Storage em que o áudio da conversa é armazenado para gerar URLs assinados. Você precisa conceder a função Storage Object Viewer (roles/storage.objectViewer) à conta de serviço do CX Insights para os buckets que contêm seus arquivos de áudio.

  • O identificador da conta de serviço do CX Insights é: service-PROJECT_NUMBER@gcp-sa-contactcenterinsights.

  • Substitua PROJECT_NUMBER pelo número do projeto Google Cloud .

Para instruções sobre como conceder acesso a uma conta de serviço para um bucket, consulte Adicionar um principal a uma política no nível do bucket.

Configurar o CORS no bucket do Cloud Storage

Para permitir que os navegadores reproduzam áudio de URLs assinados gerados pelo CX Insights, configure o CORS no bucket do Cloud Storage para permitir o acesso das origens do console do CX Insights.

Primeiro, crie um arquivo JSON chamado cors-config.json com o seguinte conteúdo:

  [
    {
      "origin": ["https://ccai.cloud.google.com"],
      "responseHeader": ["Content-Type"],
      "method": ["GET"],
      "maxAgeSeconds": 3600
    }
  ]

Em seguida, execute o comando gcloud a seguir para aplicar a configuração do CORS ao bucket:

  gcloud storage buckets update gs://BUCKET_NAME --cors-file=cors-config.json

Por fim, substitua BUCKET_NAME pelo nome do bucket do Cloud Storage que contém os arquivos de áudio. Para mais informações, consulte Configurar o compartilhamento de recursos entre origens (CORS).