Cómo habilitar la reproducción de audio

En esta página, se describe cómo habilitar la reproducción de audio en la consola de Customer Experience Insights con URLs firmadas.

Con la reproducción de audio habilitada, puedes escuchar el audio de la conversación directamente en la consola de CX Insights. La reproducción de audio usa URLs firmadas para proporcionar acceso autenticado y por tiempo limitado a los archivos de audio almacenados en tus buckets de Cloud Storage. Esto elimina la necesidad de otorgar a los usuarios acceso directo a los buckets de Cloud Storage para la reproducción de audio.

Antes de comenzar

Para reproducir audio en la consola de CX Insights, los usuarios necesitan permiso para generar URLs de audio firmadas. El permiso de IAM requerido depende de cómo se acceda a la conversación:

  • Para todas las conversaciones: El permiso contactcenterinsights.conversations.generateSignedAudio está en las funciones predefinidas Contact Center AI Insights viewer y Contact Center AI Insights editor.
  • Para todas las conversaciones a las que se accede a través de un conjunto de datos: El permiso contactcenterinsights.datasets.generateSignedAudio está en las funciones predefinidas Contact Center AI Insights viewer y Contact Center AI Insights editor.
  • Para el acceso detallado a través de una vista autorizada: El permiso contactcenterinsights.authorizedConversations.generateSignedAudio está en las funciones predefinidas Contact Center AI Insights authorizedViewer y Contact Center AI Insights authorizedEditor.

Para obtener más información sobre los permisos detallados con vistas autorizadas, consulta Descripción general del control de acceso detallado.

Antes de comenzar, realiza los siguientes pasos:

  1. Asegúrate de haber importado conversaciones de voz a CX Insights y de que estas conversaciones tengan URIs de audio que apunten a archivos de audio en un bucket de Cloud Storage. Esto se puede hacer de las siguientes maneras:
  2. Para encontrar el número de tu Google Cloud proyecto, ve a la página Configuración del proyecto.

Habilita la reproducción de audio

Para habilitar la reproducción de audio con URLs firmadas, debes otorgar acceso a la cuenta de servicio de CX Insights a tu bucket de Cloud Storage y configurar el uso compartido de recursos entre dominios (CORS) en el bucket.

Otorga acceso a la cuenta de servicio al bucket de Cloud Storage

  • CX Insights requiere acceso al bucket de Cloud Storage en el que se almacena el audio de la conversación para generar URLs firmadas. Debes otorgar la función Storage Object Viewer (roles/storage.objectViewer) a la cuenta de servicio de CX Insights para los buckets que contienen tus archivos de audio.

  • El identificador de cuenta de servicio de CX Insights es: service-PROJECT_NUMBER@gcp-sa-contactcenterinsights.

  • Reemplaza PROJECT_NUMBER por el número de tu Google Cloud proyecto.

Para obtener instrucciones sobre cómo otorgar acceso a una cuenta de servicio para un bucket, consulta Agrega una principal a una política a nivel de bucket.

Configura CORS en el bucket de Cloud Storage

Para permitir que los navegadores reproduzcan audio desde URLs firmadas generadas por CX Insights, debes configurar CORS en tu bucket de Cloud Storage para permitir el acceso desde los orígenes de la consola de CX Insights.

Primero, crea un archivo JSON llamado cors-config.json con el siguiente contenido:

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

Luego, ejecuta el siguiente comando gcloud para aplicar la configuración de CORS a tu bucket:

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

Por último, reemplaza BUCKET_NAME por el nombre de tu bucket de Cloud Storage que contiene archivos de audio. Para obtener más información, consulta Configura el uso compartido de recursos entre dominios (CORS).