音声の再生を有効にする

このページでは、署名付き URL を使用して Customer Experience Insights コンソールで音声再生を有効にする方法について説明します。

音声再生を有効にすると、CX インサイト コンソールで会話の音声を直接聴くことができます。音声再生では、署名付き URL を使用して、Cloud Storage バケットに保存されている音声ファイルへの認証済みアクセスを時間制限付きで提供します。これにより、音声再生のためにユーザーに Cloud Storage バケットへの直接アクセス権を付与する必要がなくなります。

始める前に

CX インサイト コンソールで音声を再生するには、ユーザーに署名付き音声 URL を生成する権限が必要です。必要な IAM 権限は、会話へのアクセス方法によって異なります。

  • すべての会話の場合: contactcenterinsights.conversations.generateSignedAudio 権限は、事前定義ロール Contact Center AI Insights viewer と Contact Center AI Insights editor にあります。
  • データセットを介してアクセスされるすべての会話の場合: contactcenterinsights.datasets.generateSignedAudio 権限は、事前定義ロール Contact Center AI Insights viewer と Contact Center AI Insights editor にあります。
  • 承認済みビューを介してアクセスされるきめ細かいアクセスの場合:contactcenterinsights.authorizedConversations.generateSignedAudio 権限は、事前定義ロール Contact Center AI Insights authorizedViewer と Contact Center AI Insights authorizedEditor にあります。

承認済みビューを使用したきめ細かい権限の詳細については、きめ細かいアクセス制御の概要をご覧ください。

始める前に、次の手順を行います。

  1. 音声会話を CX インサイトに インポートし、これらの会話に Cloud Storage バケット内の音声ファイルを指す音声 URI があることを確認します。これは、次の方法で実行できます。
  2. [プロジェクトの設定] ページに移動して、プロジェクト番号を確認します。 Google Cloud

音声再生を有効にする

署名付き URL を使用して音声再生を有効にするには、CX インサイト サービス アカウントに Cloud Storage バケットへのアクセス権を付与し、バケットでクロスオリジン リソース シェアリング（CORS）を構成する必要があります。

Cloud Storage バケットへのアクセス権をサービス アカウントに付与する

  • CX インサイトでは、署名付き URL を生成するために、会話の音声が保存されている Cloud Storage バケットへのアクセスが必要です。音声ファイルを含むバケットに対して、CX インサイト サービス アカウントに Storage Object Viewer ロール（roles/storage.objectViewer）を付与する必要があります。

  • CX インサイト サービス アカウント ID は service-PROJECT_NUMBER@gcp-sa-contactcenterinsights. です。

  • PROJECT_NUMBER は、使用する Google Cloud プロジェクト番号に置き換えます。

バケットのサービス アカウントへのアクセス権を付与する手順については、バケットレベルのポリシーにプリンシパルを追加するをご覧ください。

Cloud Storage バケットで CORS を構成する

ブラウザで CX インサイトによって生成された署名付き URL から音声を再生できるようにするには、Cloud Storage バケットで CORS を構成して、CX インサイト コンソール オリジンからのアクセスを許可する必要があります。

まず、次の内容で cors-config.json という名前の JSON ファイルを作成します。

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

次に、次の gcloud コマンドを実行して、CORS 構成をバケットに適用します。

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

最後に、BUCKET_NAME は、音声ファイルを含む Cloud Storage バケットの名前に置き換えます。詳細については、クロスオリジン リソース シェアリング（CORS）を構成するをご覧ください。