Attivare la riproduzione audio

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive come attivare la riproduzione audio nella console Customer Experience Insights utilizzando gli URL firmati.

Con la riproduzione audio attivata, puoi ascoltare l'audio della conversazione direttamente nella console CX Insights. La riproduzione audio utilizza URL firmati per fornire un accesso autenticato e limitato nel tempo ai file audio archiviati nei bucket Cloud Storage. In questo modo, non è più necessario concedere agli utenti l'accesso diretto ai bucket Cloud Storage per la riproduzione audio.

Prima di iniziare

Per riprodurre l'audio nella console CX Insights, gli utenti devono disporre dell'autorizzazione per generare URL audio firmati. L'autorizzazione IAM richiesta dipende dalla modalità di accesso alla conversazione:

• Per tutte le conversazioni: l'autorizzazione contactcenterinsights.conversations.generateSignedAudio è inclusa nei ruoli predefiniti Contact Center AI Insights viewer e Contact Center AI Insights editor.
• Per tutte le conversazioni a cui si accede tramite un set di dati: l'autorizzazione contactcenterinsights.datasets.generateSignedAudio è inclusa nei ruoli predefiniti Contact Center AI Insights viewer e Contact Center AI Insights editor.
• Per l'accesso granulare tramite una vista autorizzata:l'autorizzazione contactcenterinsights.authorizedConversations.generateSignedAudio è inclusa nei ruoli predefiniti Contact Center AI Insights authorizedViewer e Contact Center AI Insights authorizedEditor.

Per saperne di più sulle autorizzazioni granulari con le viste autorizzate, consulta la panoramica del controllo dell'accesso granulare.

Prima di iniziare, segui questi passaggi:

1. Assicurati di aver importato le conversazioni vocali in CX Insights e che queste conversazioni abbiano URI audio che puntano a file audio in un bucket Cloud Storage. Puoi farlo tramite:
   • Caricamento di conversazioni con URI audio.
   • Abilitazione dell'esportazione audio per l'integrazione del runtime Dialogflow.
2. Trova il numero di progetto Google Cloud andando alla pagina Impostazioni progetto.

Attivare la riproduzione audio

Per attivare la riproduzione audio utilizzando gli URL firmati, devi concedere all'account di servizio CX Insights l'accesso al tuo bucket Cloud Storage e configurare la condivisione delle risorse tra origini (CORS) nel bucket.

Concedi l'accesso del account di servizio al bucket Cloud Storage

• CX Insights richiede l'accesso al bucket Cloud Storage in cui è archiviato l'audio della conversazione per generare URL firmati. Devi concedere il ruolo Storage Object Viewer (roles/storage.objectViewer) al account di servizio CX Insights per i bucket contenenti i file audio.

• L'identificatore del account di servizio di CX Insights è: [e-mail]

• Sostituisci PROJECT_NUMBER con il numero del tuo progetto Google Cloud .

Per istruzioni su come concedere l'accesso a un account di servizio per un bucket, vedi Aggiungere un principal a una policy a livello di bucket.

Configura CORS nel bucket Cloud Storage

Per consentire ai browser di riprodurre l'audio dagli URL firmati generati da CX Insights, devi configurare CORS nel bucket Cloud Storage per consentire l'accesso dalle origini della console CX Insights.

Innanzitutto, crea un file JSON denominato cors-config.json con i seguenti contenuti:

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

Poi esegui questo comando gcloud per applicare la configurazione CORS al bucket:

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

Infine, sostituisci BUCKET_NAME con il nome del tuo bucket Cloud Storage contenente i file audio. Per saperne di più, consulta Configurazione della condivisione delle risorse tra origini (CORS).