Activer la lecture audio

Cette page explique comment activer la lecture audio dans la console Customer Experience Insights à l'aide d'URL signées.

Lorsque la lecture audio est activée, vous pouvez écouter l'audio des conversations directement dans la console CX Insights. La lecture audio utilise des URL signées pour fournir un accès authentifié et limité dans le temps aux fichiers audio stockés dans vos buckets Cloud Storage. Il n'est donc plus nécessaire d'accorder aux utilisateurs un accès direct aux buckets Cloud Storage pour la lecture audio.

Avant de commencer

Pour lire l'audio dans la console CX Insights, les utilisateurs doivent être autorisés à générer des URL audio signées. L'autorisation IAM requise dépend de la manière dont la conversation est consultée :

  • Pour toutes les conversations : l'autorisation contactcenterinsights.conversations.generateSignedAudio se trouve dans les rôles prédéfinis Contact Center AI Insights viewer et Contact Center AI Insights editor.
  • Pour toutes les conversations consultées via un ensemble de données : l'autorisation contactcenterinsights.datasets.generateSignedAudio se trouve dans les rôles prédéfinis Contact Center AI Insights viewer et Contact Center AI Insights editor.
  • Pour un accès précis via une vue autorisée : l'autorisation contactcenterinsights.authorizedConversations.generateSignedAudio se trouve dans les rôles prédéfinis Contact Center AI Insights authorizedViewer et Contact Center AI Insights authorizedEditor.

Pour en savoir plus sur les autorisations précises avec les vues autorisées, consultez la présentation du contrôle des accès ultraprécis.

Avant de commencer, suivez les étapes suivantes :

  1. Assurez-vous d'avoir importé des conversations vocales dans CX Insights et que ces conversations comportent des URI audio pointant vers des fichiers audio dans un bucket Cloud Storage. Pour ce faire :
  2. Recherchez le numéro de votre Google Cloud projet sur la page Paramètres du projet.

Activer la lecture audio

Pour activer la lecture audio à l'aide d'URL signées, vous devez accorder au compte de service CX Insights l'accès à votre bucket Cloud Storage et configurer le Cross-Origin Resource Sharing (CORS) sur le bucket.

Accorder au compte de service l'accès au bucket Cloud Storage

  • CX Insights doit accéder au bucket Cloud Storage dans lequel l'audio des conversations est stocké pour générer des URL signées. Vous devez attribuer le rôle Storage Object Viewer (roles/storage.objectViewer) au compte de service CX Insights pour les buckets contenant vos fichiers audio.

  • L'identifiant de compte de service CX Insights est le suivant : service-PROJECT_NUMBER@gcp-sa-contactcenterinsights.

  • Remplacez PROJECT_NUMBER par le numéro de votre Google Cloud projet.

Pour savoir comment accorder l'accès à un compte de service pour un bucket, consultez la section Ajouter une entité principale à une stratégie au niveau du bucket.

Configurer CORS sur le bucket Cloud Storage

Pour autoriser les navigateurs à lire l'audio à partir d'URL signées générées par CX Insights, vous devez configurer CORS sur votre bucket Cloud Storage afin d'autoriser l'accès à partir des origines de la console CX Insights.

Commencez par créer un fichier JSON nommé cors-config.json avec le contenu suivant :

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

Exécutez ensuite la commande gcloud suivante pour appliquer la configuration CORS à votre bucket :

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

Enfin, remplacez BUCKET_NAME par le nom de votre bucket Cloud Storage contenant des fichiers audio. Pour en savoir plus, consultez la section Configurer le Cross-Origin Resource Sharing (CORS).