- JSON representation
- CallMetadata
- ConversationDataSource
- GcsSource
- DialogflowSource
- QualityMetadata
- AgentInfo
- Transcript
- TranscriptSegment
- WordInfo
- ConversationParticipant
- DialogflowSegmentMetadata
- ConversationSummarizationSuggestionData
- RuntimeAnnotation
- FaqAnswerData
- SmartReplyData
- SmartComposeSuggestionData
- DialogflowInteractionData
- UserInput
- DialogflowIntent
- DialogflowCxConversationData
- QueryInputStats
- MatchTypeStats
The conversation resource.
JSON representation |
---|
{ "name": string, "dataSource": { object ( |
Fields | |
---|---|
name |
Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation} |
dataSource |
The source of the audio and transcription for the conversation. |
createTime |
Output only. The time at which the conversation was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. The most recent time at which the conversation was updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
startTime |
The time at which the conversation started. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
languageCode |
A user-specified language code for the conversation. |
agentId |
An opaque, user-specified string representing the human agent who handled the conversation. |
customerId |
An opaque, user-specified string representing the customer identifier. |
labels |
A map for the user to specify any custom fields. A maximum of 20 labels per conversation is allowed, with a maximum of 256 characters per entry. An object containing a list of |
qualityMetadata |
Conversation metadata related to quality management. |
metadataJson |
Input only. JSON metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insight's supported formats. |
transcript |
Output only. The conversation transcript. |
medium |
Immutable. The conversation medium, if unspecified will default to PHONE_CALL. |
duration |
Output only. The duration of the conversation. A duration in seconds with up to nine fractional digits, ending with ' |
turnCount |
Output only. The number of turns in the conversation. |
latestAnalysis |
Output only. The conversation's latest analysis, if one exists. |
latestSummary |
Output only. Latest summary of the conversation. |
runtimeAnnotations[] |
Output only. The annotations that were generated during the customer and agent interaction. |
dialogflowIntents |
Output only. All the matched Dialogflow intents in the call. The key corresponds to a Dialogflow intent, format: projects/{project}/agent/{agent}/intents/{intent} An object containing a list of |
obfuscatedUserId |
Obfuscated user ID which the customer sent to us. |
dialogflowCxConversationData |
The Dialogflow conversation raw data. It will only be populated when ConversationView is DF_CONVERSATION_BASIC or DF_CONVERSATION_FULL. |
Union field metadata . Metadata that applies to the conversation. metadata can be only one of the following: |
|
callMetadata |
Call-specific metadata. |
Union field expiration . A time to live expiration setting, can be either a specified timestamp or a duration from the time that the conversation creation request was received. Conversations with an expiration set will be removed up to 24 hours after the specified time. expiration can be only one of the following: |
|
expireTime |
The time at which this conversation should expire. After this time, the conversation data and any associated analyses will be deleted. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
ttl |
Input only. The TTL for this resource. If specified, then this TTL will be used to calculate the expire time. A duration in seconds with up to nine fractional digits, ending with ' |
CallMetadata
Call-specific metadata.
JSON representation |
---|
{ "customerChannel": integer, "agentChannel": integer } |
Fields | |
---|---|
customerChannel |
The audio channel that contains the customer. |
agentChannel |
The audio channel that contains the agent. |
ConversationDataSource
The conversation source, which is a combination of transcript and audio.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field source . The source of the conversation. source can be only one of the following: |
|
gcsSource |
A Cloud Storage location specification for the audio and transcript. |
dialogflowSource |
The source when the conversation comes from Dialogflow. |
GcsSource
A Cloud Storage source of conversation data.
JSON representation |
---|
{ "audioUri": string, "transcriptUri": string, "metadataUri": string } |
Fields | |
---|---|
audioUri |
Cloud Storage URI that points to a file that contains the conversation audio. |
transcriptUri |
Immutable. Cloud Storage URI that points to a file that contains the conversation transcript. |
metadataUri |
Cloud Storage URI that points to a file that contains the conversation metadata. |
DialogflowSource
A Dialogflow source of conversation data.
JSON representation |
---|
{ "dialogflowConversation": string, "audioUri": string } |
Fields | |
---|---|
dialogflowConversation |
Output only. The name of the Dialogflow conversation that this conversation resource is derived from. Format: projects/{project}/locations/{location}/conversations/{conversation} |
audioUri |
Cloud Storage URI that points to a file that contains the conversation audio. |
QualityMetadata
Conversation metadata related to quality management.
JSON representation |
---|
{
"customerSatisfactionRating": integer,
"waitDuration": string,
"menuPath": string,
"agentInfo": [
{
object ( |
Fields | |
---|---|
customerSatisfactionRating |
An arbitrary integer value indicating the customer's satisfaction rating. |
waitDuration |
The amount of time the customer waited to connect with an agent. A duration in seconds with up to nine fractional digits, ending with ' |
menuPath |
An arbitrary string value specifying the menu path the customer took. |
agentInfo[] |
Information about agents involved in the call. |
AgentInfo
Information about an agent involved in the conversation.
JSON representation |
---|
{ "agentId": string, "displayName": string, "team": string, "dispositionCode": string } |
Fields | |
---|---|
agentId |
A user-specified string representing the agent. |
displayName |
The agent's name. |
team |
A user-specified string representing the agent's team. |
dispositionCode |
A user-provided string indicating the outcome of the agent's segment of the call. |
Transcript
A message representing the transcript of a conversation.
JSON representation |
---|
{
"transcriptSegments": [
{
object ( |
Fields | |
---|---|
transcriptSegments[] |
A list of sequential transcript segments that comprise the conversation. |
TranscriptSegment
A segment of a full transcript.
JSON representation |
---|
{ "messageTime": string, "text": string, "confidence": number, "words": [ { object ( |
Fields | |
---|---|
messageTime |
The time that the message occurred, if provided. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
text |
The text of this segment. |
confidence |
A confidence estimate between 0.0 and 1.0 of the fidelity of this segment. A default value of 0.0 indicates that the value is unset. |
words[] |
A list of the word-specific information for each word in the segment. |
languageCode |
The language code of this segment as a BCP-47 language tag. Example: "en-US". |
channelTag |
For conversations derived from multi-channel audio, this is the channel number corresponding to the audio from that channel. For audioChannelCount = N, its output values can range from '1' to 'N'. A channel tag of 0 indicates that the audio is mono. |
segmentParticipant |
The participant of this segment. |
dialogflowSegmentMetadata |
CCAI metadata relating to the current transcript segment. |
sentiment |
The sentiment for this transcript segment. |
WordInfo
Word-level info for words in a transcript.
JSON representation |
---|
{ "startOffset": string, "endOffset": string, "word": string, "confidence": number } |
Fields | |
---|---|
startOffset |
Time offset of the start of this word relative to the beginning of the total conversation. A duration in seconds with up to nine fractional digits, ending with ' |
endOffset |
Time offset of the end of this word relative to the beginning of the total conversation. A duration in seconds with up to nine fractional digits, ending with ' |
word |
The word itself. Includes punctuation marks that surround the word. |
confidence |
A confidence estimate between 0.0 and 1.0 of the fidelity of this word. A default value of 0.0 indicates that the value is unset. |
ConversationParticipant
The call participant speaking for a given utterance.
JSON representation |
---|
{ "dialogflowParticipant": string, "obfuscatedExternalUserId": string, "role": enum ( |
Fields | |
---|---|
dialogflowParticipant |
Deprecated. Use |
obfuscatedExternalUserId |
Obfuscated user ID from Dialogflow. |
role |
The role of the participant. |
Union field
|
|
dialogflowParticipantName |
The name of the participant provided by Dialogflow. Format: projects/{project}/locations/{location}/conversations/{conversation}/participants/{participant} |
userId |
A user-specified ID representing the participant. |
DialogflowSegmentMetadata
Metadata from Dialogflow relating to the current transcript segment.
JSON representation |
---|
{ "smartReplyAllowlistCovered": boolean } |
Fields | |
---|---|
smartReplyAllowlistCovered |
Whether the transcript segment was covered under the configured smart reply allowlist in Agent Assist. |
ConversationSummarizationSuggestionData
Conversation summarization suggestion data.
JSON representation |
---|
{ "text": string, "textSections": { string: string, ... }, "confidence": number, "metadata": { string: string, ... }, "answerRecord": string, "conversationModel": string } |
Fields | |
---|---|
text |
The summarization content that is concatenated into one string. |
textSections |
The summarization content that is divided into sections. The key is the section's name and the value is the section's content. There is no specific format for the key or value. An object containing a list of |
confidence |
The confidence score of the summarization. |
metadata |
A map that contains metadata about the summarization and the document from which it originates. An object containing a list of |
answerRecord |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answerRecord} |
conversationModel |
The name of the model that generates this summary. Format: projects/{project}/locations/{location}/conversationModels/{conversationModel} |
RuntimeAnnotation
An annotation that was generated during the customer and agent interaction.
JSON representation |
---|
{ "annotationId": string, "createTime": string, "startBoundary": { object ( |
Fields | |
---|---|
annotationId |
The unique identifier of the annotation. Format: projects/{project}/locations/{location}/conversationDatasets/{dataset}/conversationDataItems/{data_item}/conversationAnnotations/{annotation} |
createTime |
The time at which this annotation was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
startBoundary |
The boundary in the conversation where the annotation starts, inclusive. |
endBoundary |
The boundary in the conversation where the annotation ends, inclusive. |
answerFeedback |
The feedback that the customer has about the answer in |
userInput |
Explicit input used for generating the answer |
Union field data . The data in the annotation. data can be only one of the following: |
|
articleSuggestion |
Agent Assist Article Suggestion data. |
faqAnswer |
Agent Assist FAQ answer data. |
smartReply |
Agent Assist Smart Reply data. |
smartComposeSuggestion |
Agent Assist Smart Compose suggestion data. |
dialogflowInteraction |
Dialogflow interaction data. |
conversationSummarizationSuggestion |
Conversation summarization suggestion data. |
FaqAnswerData
Agent Assist frequently-asked-question answer data.
JSON representation |
---|
{ "answer": string, "confidenceScore": number, "question": string, "metadata": { string: string, ... }, "queryRecord": string, "source": string } |
Fields | |
---|---|
answer |
The piece of text from the |
confidenceScore |
The system's confidence score that this answer is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
question |
The corresponding FAQ question. |
metadata |
Map that contains metadata about the FAQ answer and the document that it originates from. An object containing a list of |
queryRecord |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answerRecord} |
source |
The knowledge document that this answer was extracted from. Format: projects/{project}/knowledgeBases/{knowledgeBase}/documents/{document}. |
SmartReplyData
Agent Assist Smart Reply data.
JSON representation |
---|
{ "reply": string, "confidenceScore": number, "metadata": { string: string, ... }, "queryRecord": string } |
Fields | |
---|---|
reply |
The content of the reply. |
confidenceScore |
The system's confidence score that this reply is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
metadata |
Map that contains metadata about the Smart Reply and the document from which it originates. An object containing a list of |
queryRecord |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answerRecord} |
SmartComposeSuggestionData
Agent Assist Smart Compose suggestion data.
JSON representation |
---|
{ "suggestion": string, "confidenceScore": number, "metadata": { string: string, ... }, "queryRecord": string } |
Fields | |
---|---|
suggestion |
The content of the suggestion. |
confidenceScore |
The system's confidence score that this suggestion is a good match for this conversation, ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
metadata |
Map that contains metadata about the Smart Compose suggestion and the document from which it originates. An object containing a list of |
queryRecord |
The name of the answer record. Format: projects/{project}/locations/{location}/answerRecords/{answerRecord} |
DialogflowInteractionData
Dialogflow interaction data.
JSON representation |
---|
{ "dialogflowIntentId": string, "confidence": number, "detectIntentRequest": { "@type": string, field1: ..., ... }, "detectIntentResponse": { "@type": string, field1: ..., ... }, "flowId": string, "flowDisplayName": string, "pageId": string, "pageDisplayName": string, "intentId": string, "intentDisplayName": string, "endFlowOrSession": boolean, "liveAgentHandoff": boolean, "inputType": enum ( |
Fields | |
---|---|
dialogflowIntentId |
The Dialogflow intent resource path. Format: projects/{project}/agent/{agent}/intents/{intent} |
confidence |
The confidence of the match ranging from 0.0 (completely uncertain) to 1.0 (completely certain). |
detectIntentRequest |
The Dialogflow conversation DetectIntentRequest raw data of this turn. This field will only be populated in the GetConversation response and its data format should be same as Dialogflow [DetectIntentRequest] of Sessions. An object containing fields of an arbitrary type. An additional field |
detectIntentResponse |
The Dialogflow conversation DetectIntentResponse raw data of this turn. This field will only be populated in the GetConversation response and its data format should be same as Dialogflow DetectIntentResponse of Sessions. An object containing fields of an arbitrary type. An additional field |
flowId |
The Dialogflow flow id. |
flowDisplayName |
The Dialogflow flow display name. The Dialogflow environment display name. |
pageId |
The Dialogflow page ID. |
pageDisplayName |
The Dialogflow page display name. The Dialogflow environment display name. |
intentId |
The Dialogflow intent ID. |
intentDisplayName |
The Dialogflow intent display name. The Dialogflow environment display name. |
endFlowOrSession |
The turn reaches END_FLOW or END_SESSION. |
liveAgentHandoff |
Whether the turn was handed off to a human agent. |
inputType |
The input type in this turn. |
matchType |
The match type in this turn. |
UserInput
Explicit input used for generating the answer
JSON representation |
---|
{
"query": string,
"generatorName": string,
"querySource": enum ( |
Fields | |
---|---|
query |
Query text. Article Search uses this to store the input query used to generate the search results. |
generatorName |
The resource name of associated generator. Format: |
querySource |
Query source for the answer. |
DialogflowIntent
The data for a Dialogflow intent. Represents a detected intent in the conversation, e.g. MAKES_PROMISE.
JSON representation |
---|
{ "displayName": string } |
Fields | |
---|---|
displayName |
The human-readable name of the intent. |
DialogflowCxConversationData
The metadata for a Dialogflow CX conversation.
JSON representation |
---|
{ "virtualAgentId": string, "flowIds": [ string ], "flowDisplayNames": [ string ], "pageIds": [ string ], "pageDisplayNames": [ string ], "intentIds": [ string ], "intentDisplayNames": [ string ], "experimentIds": [ string ], "experimentDisplayNames": [ string ], "inputAudioDuration": string, "outputAudioDuration": string, "queryInputStats": { object ( |
Fields | |
---|---|
virtualAgentId |
The virtual agent id of this conversation. |
flowIds[] |
The deduped flow UUIDs set. |
flowDisplayNames[] |
The deduped flow display names set. |
pageIds[] |
The deduped page UUIDs set. |
pageDisplayNames[] |
The deduped page display names set. |
intentIds[] |
The deduped intent UUIDs set. |
intentDisplayNames[] |
The deduped intent display names set. |
experimentIds[] |
The deduped experiment UUIDs set. |
experimentDisplayNames[] |
The deduped experiment display names set. |
inputAudioDuration |
The total duration of the user input audio in this conversation. A duration in seconds with up to nine fractional digits, ending with ' |
outputAudioDuration |
The total duration of the agent output audio in this conversation. A duration in seconds with up to nine fractional digits, ending with ' |
queryInputStats |
Query input stats |
matchTypeStats |
Match type stats. |
averageMatchConfidence |
Average match confidence for all the initent matches in this conversation. |
endSessionExit |
Whether the conversation reaches END_FLOW or END_SESSION. |
maxWebhookLatency |
The maximum webhook latency for an individual webhook call in this conversation. A duration in seconds with up to nine fractional digits, ending with ' |
liveAgentHandoff |
Whether the conversation was handed off to a human agent. |
QueryInputStats
Count by input types in this conversation
JSON representation |
---|
{ "textCount": integer, "intentCount": integer, "audioCount": integer, "eventCount": integer, "dtmfCount": integer } |
Fields | |
---|---|
textCount |
The number of requests with text input. |
intentCount |
The number of requests with intent input. |
audioCount |
The number of requests with audio input. |
eventCount |
The number of requests with event input. |
dtmfCount |
The number of requests with DTMF input. |
MatchTypeStats
Count by match types in this conversation .
JSON representation |
---|
{ "intentCount": integer, "directIntentCount": integer, "parameterFillingCount": integer, "noMatchCount": integer, "noInputCount": integer, "eventCount": integer } |
Fields | |
---|---|
intentCount |
The number of responses with match type INTENT. |
directIntentCount |
The number of responses with match type DIRECT_INTENT. |
parameterFillingCount |
The number of responses with match type PARAMETER_FILLING. |
noMatchCount |
The number of responses with match type NO_MATCH. |
noInputCount |
The number of responses with match type NO_INPUT. |
eventCount |
The number of responses with match type EVENT. |