Use the console to import and analyze a conversation
Stay organized with collections
Save and categorize content based on your preferences.
You can import a single or multiple conversation files from a Cloud Storage bucket to Conversational Insights. You can view and analyze conversations in Conversational Insights after you import them.
This guide walks you through the process of importing and analyzing a single conversation using the Insights console.
To perform this task, you must have the following
permissions:
storage.objects.list
storage.objects.create
Chat Conversation
The transcript of a chat conversation must be supplied as a JSON-formatted file that matches the CCAI conversation data format. Follow these steps to add a chat transcript.
Upload the conversation's chat transcript as an object in your Cloud Storage bucket.
Make a note of the object path, which is formatted as gs://<bucket>/<object>.
Voice conversation
Upload the conversation audio or transcript as an object in your Cloud Storage bucket.
Make a note of the object path, formatted as gs://<bucket>/<object>.
The response is identical for synchronous recognition and asynchronous recognition across all Speech-to-Text API versions. Other transcription formats aren't supported and result in an error during import.
Insights only supports audio with two channels. More or fewer channels will result in an error during conversation analysis.
Import a conversation from Cloud Storage
Permissions required for this task
To perform this task, you must have the following
permissions:
resourcemanager.projects.get
contactcenterinsights.conversations.upload
Navigate to the Insights console and sign in with your Google Account.
Select your conversation type, either Voice or Chat.
Click Next.
Chat conversation
Follow these steps to import your chat conversation transcript.
For the Cloud Storage resource, select one of the following options:
File to import a single transcript file.
Bucket to import all transcript files within a folder in a Cloud Storage bucket.
Enter the path for the transcript file or folder in the Transcript URI field.
Click Next.
For the conversation data, enter the agent ID in the Agent ID field. This is the unique identifier used by Insights for the agent in the conversation.
Voice conversation
Follow these steps to import your audio conversation data.
Import a single conversation
For the Cloud Storage resource, select File to import a single audio file and a single transcript file.
Enter the path for the audio file in the Audio URI field.
For the transcript settings, select Provide a transcript and enter the path for the transcript file in the Transcript URI field.
Click Next.
Enter the agent ID in the Agent ID field. Insights uses this unique identifier for the agent in the conversation.
Select either 1 or 2 to indicate the audio track the agent is on.
Import multiple conversations
For the Cloud Storage resource, select Bucket to import all the files from a folder within a Cloud Storage bucket.
Enter the path for the folder containing your audio files in the Audio URI field.
For the transcript settings, select Use default STT config in Settings to automatically transcribe audio files. Select Provide a transcript to import all your transcript files.
Enter the path for the folder containing transcript files in the Transcript URI field.
Click Next.
Enter the agent ID in the Agent ID field. This is the unique identifier used by Insights for the agent in the conversation.
Select either 1 or 2 to indicate the audio track the agent is on.
After you enter the required information, click Import to import the conversation into Insights. You should receive a notification indicating when the conversation has been successfully imported.
Analyze a conversation
After you import a conversation object in Insights, you can analyze it to produce useful insights. A single conversation object can be analyzed many times, and each separate analysis creates a new analysis object. If the languageCode field is not set, Insights will automatically infer it. Refer
to the language support
documentation for a list of languages supported for analysis.
Permissions required for this task
To perform this task, you must have the following
permissions:
resourcemanager.projects.get
contactcenterinsights.conversations.list
contactcenterinsights.conversations.get
contactcenterinsights.analyses.create
Click the name of your conversation in the conversation list view table.
After the conversation details page loads, click Analyze.
The analysis may take some time. You can leave the page and come back later.
After the analysis is complete, you can view the results on the conversation details page.
View your conversations
You can view your Conversational Insights conversations and analyses in the console. When an operation reports completion, a new table entry for the conversation and analysis appears. If a conversation has multiple analyses, the console displays the results from the most recent analysis.
To view the conversation cover page:
Permissions required for this task
To perform this task, you must have the following
permissions:
resourcemanager.projects.get
contactcenterinsights.conversations.list
Navigate to the Insights console and sign in with your Google Account.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eYou can import both single and multiple chat or voice conversation files from a Cloud Storage bucket into Conversational Insights.\u003c/p\u003e\n"],["\u003cp\u003eTo import a conversation, you need specific permissions like \u003ccode\u003estorage.objects.list\u003c/code\u003e, \u003ccode\u003estorage.objects.create\u003c/code\u003e, \u003ccode\u003eresourcemanager.projects.get\u003c/code\u003e, and \u003ccode\u003econtactcenterinsights.conversations.upload\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eChat transcripts must be JSON-formatted, while voice conversations can include audio files, transcripts, or both, and must be two-channel audio.\u003c/p\u003e\n"],["\u003cp\u003eAfter importing, conversations can be analyzed within Conversational Insights to produce useful insights, and they can be viewed in the console, with the most recent analysis results displayed.\u003c/p\u003e\n"],["\u003cp\u003eBefore importing conversations, the required APIs must be enabled, including Cloud Storage, Speech-to-Text, and Insights.\u003c/p\u003e\n"]]],[],null,["# Use the console to import and analyze a conversation\n\nYou can import a single or multiple conversation files from a Cloud Storage bucket to Conversational Insights. You can view and analyze conversations in Conversational Insights after you import them.\nThis guide walks you through the process of importing and analyzing a single conversation using the [Insights console](https://ccai.cloud.google.com/insights/projects).\n\nBefore you begin\n----------------\n\n[Enable the following APIs](/contact-center/insights/docs/(/contact-center/insights/docs/before-you-begin)) for your Google Cloud project:\n\n- Cloud Storage\n- Speech-to-Text\n- Insights\n\nUpload to Cloud Storage\n-----------------------\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `storage.objects.list`\n- `storage.objects.create`\n\n### Chat Conversation\n\nThe transcript of a chat conversation must be supplied as a JSON-formatted file that matches the [CCAI conversation data format](/contact-center/insights/docs/conversation-data-format). Follow these steps to add a chat transcript.\n\n1. Upload the conversation's chat transcript as an [object](/storage/docs/json_api/v1/objects) in your Cloud Storage bucket.\n2. Make a note of the object path, which is formatted as `gs://\u003cbucket\u003e/\u003cobject\u003e`.\n\n### Voice conversation\n\n1. Upload the conversation audio or transcript as an [object](/storage/docs/json_api/v1/objects) in your Cloud Storage bucket.\n2. Make a note of the object path, formatted as `gs://\u003cbucket\u003e/\u003cobject\u003e`.\n\n| **Note:** Audio transcript files can be provided in the [CCAI conversation data format](/contact-center/insights/docs/conversation-data-format) or they can be the returned [speech recognition result](/speech-to-text/v2/docs/reference/rpc/google.cloud.speech.v2#speechrecognitionresult) of a Speech-to-Text API transcription.\n\nThe response is identical for synchronous recognition and asynchronous recognition across all Speech-to-Text API versions. Other transcription formats aren't supported and result in an error during import.\n\nInsights only supports audio with two channels. More or fewer channels will result in an error during conversation analysis.\n\nImport a conversation from Cloud Storage\n----------------------------------------\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `resourcemanager.projects.get`\n- `contactcenterinsights.conversations.upload`\n\n1. Navigate to the Insights console and sign in with your Google Account.\n\n [Insights console](https://ccai.cloud.google.com/insights)\n2. Enter your project ID.\n\n3. Click **Conversation Hub** \\\u003e **Import**.\n\n4. Select your conversation type, either **Voice** or **Chat**.\n\n5. Click **Next**.\n\n### Chat conversation\n\nFollow these steps to import your chat conversation transcript.\n\n1. For the Cloud Storage resource, select one of the following options:\n\n - **File** to import a single transcript file.\n - **Bucket** to import all transcript files within a folder in a Cloud Storage bucket.\n2. Enter the path for the transcript file or folder in the **Transcript URI** field.\n\n3. Click **Next**.\n\n4. For the conversation data, enter the agent ID in the **Agent ID** field. This is the unique identifier used by Insights for the agent in the conversation.\n\n### Voice conversation\n\nFollow these steps to import your audio conversation data.\n\n#### Import a single conversation\n\n1. For the Cloud Storage resource, select **File** to import a single audio file and a single transcript file.\n2. Enter the path for the audio file in the **Audio URI** field.\n3. For the transcript settings, select **Provide a transcript** and enter the path for the transcript file in the **Transcript URI** field.\n4. Click **Next**.\n5. Enter the agent ID in the **Agent ID** field. Insights uses this unique identifier for the agent in the conversation.\n6. Select either **1** or **2** to indicate the audio track the agent is on.\n\n#### Import multiple conversations\n\n| **Note:** Insights does not support the bulk import of transcripts together with audio or the linking of audio with transcripts. If you have both conversation audio and transcripts, make sure to save them in separate buckets.\n\n1. For the Cloud Storage resource, select **Bucket** to import all the files from a folder within a Cloud Storage bucket.\n2. Enter the path for the folder containing your audio files in the **Audio URI** field.\n3. For the transcript settings, select **Use default STT config in Settings** to automatically transcribe audio files. Select **Provide a transcript** to import all your transcript files.\n4. Enter the path for the folder containing transcript files in the **Transcript URI** field.\n5. Click **Next**.\n6. Enter the agent ID in the **Agent ID** field. This is the unique identifier used by Insights for the agent in the conversation.\n7. Select either **1** or **2** to indicate the audio track the agent is on.\n\nAfter you enter the required information, click **Import** to import the conversation into Insights. You should receive a notification indicating when the conversation has been successfully imported.\n| **Note:** If the [`languageCode`](/contact-center/insights/docs/reference/rest/v1/projects.locations.conversations#Conversation) field is not set, Insights will automatically infer it.\n\nAnalyze a conversation\n----------------------\n\nAfter you import a conversation object in Insights, you can analyze it to produce useful insights. A single conversation object can be analyzed many times, and each separate analysis creates a new analysis object. If the [`languageCode`](/contact-center/insights/docs/reference/rest/v1/projects.locations.conversations#Conversation) field is not set, Insights will automatically infer it. Refer\nto the [language support](/contact-center/insights/docs/languages)\ndocumentation for a list of languages supported for analysis.\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `resourcemanager.projects.get`\n- `contactcenterinsights.conversations.list`\n- `contactcenterinsights.conversations.get`\n- `contactcenterinsights.analyses.create`\n\n1. Click the name of your conversation in the conversation list view table.\n2. After the conversation details page loads, click **Analyze**.\n3. The analysis may take some time. You can leave the page and come back later.\n4. After the analysis is complete, you can view the results on the conversation details page.\n\nView your conversations\n-----------------------\n\nYou can view your Conversational Insights conversations and analyses in the console. When an operation reports completion, a new table entry for the conversation and analysis appears. If a conversation has multiple analyses, the console displays the results from the most recent analysis.\n\nTo view the conversation cover page:\n\n#### Permissions required for this task\n\nTo perform this task, you must have the following\n[permissions](/iam/docs/overview#permissions):\n\n\n- `resourcemanager.projects.get`\n- `contactcenterinsights.conversations.list`\n\n1. Navigate to the Insights console and sign in with your Google Account.\n\n [Insights console](https://ccai.cloud.google.com/insights)\n2. Enter your project ID.\n\nBefore you import any conversations, the page is empty. After you import conversations, the results appear on this page."]]
