1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="dialogflow_v2beta1.html">Dialogflow API</a> . <a href="dialogflow_v2beta1.projects.html">projects</a> . <a href="dialogflow_v2beta1.projects.locations.html">locations</a> . <a href="dialogflow_v2beta1.projects.locations.conversations.html">conversations</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="dialogflow_v2beta1.projects.locations.conversations.messages.html">messages()</a></code> 79</p> 80<p class="firstline">Returns the messages Resource.</p> 81 82<p class="toc_element"> 83 <code><a href="dialogflow_v2beta1.projects.locations.conversations.participants.html">participants()</a></code> 84</p> 85<p class="firstline">Returns the participants Resource.</p> 86 87<p class="toc_element"> 88 <code><a href="#close">close()</a></code></p> 89<p class="firstline">Close httplib2 connections.</p> 90<p class="toc_element"> 91 <code><a href="#complete">complete(name, body=None, x__xgafv=None)</a></code></p> 92<p class="firstline">Completes the specified conversation. Finished conversations are purged from the database after 30 days.</p> 93<p class="toc_element"> 94 <code><a href="#create">create(parent, body=None, conversationId=None, x__xgafv=None)</a></code></p> 95<p class="firstline">Creates a new conversation. Conversations are auto-completed after 24 hours. Conversation Lifecycle: There are two stages during a conversation: Automated Agent Stage and Assist Stage. For Automated Agent Stage, there will be a dialogflow agent responding to user queries. For Assist Stage, there's no dialogflow agent responding to user queries. But we will provide suggestions which are generated from conversation. If Conversation.conversation_profile is configured for a dialogflow agent, conversation will start from `Automated Agent Stage`, otherwise, it will start from `Assist Stage`. And during `Automated Agent Stage`, once an Intent with Intent.live_agent_handoff is triggered, conversation will transfer to Assist Stage.</p> 96<p class="toc_element"> 97 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 98<p class="firstline">Retrieves the specific conversation.</p> 99<p class="toc_element"> 100 <code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p> 101<p class="firstline">Returns the list of all conversations in the specified project.</p> 102<p class="toc_element"> 103 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 104<p class="firstline">Retrieves the next page of results.</p> 105<h3>Method Details</h3> 106<div class="method"> 107 <code class="details" id="close">close()</code> 108 <pre>Close httplib2 connections.</pre> 109</div> 110 111<div class="method"> 112 <code class="details" id="complete">complete(name, body=None, x__xgafv=None)</code> 113 <pre>Completes the specified conversation. Finished conversations are purged from the database after 30 days. 114 115Args: 116 name: string, Required. Resource identifier of the conversation to close. Format: `projects//locations//conversations/`. (required) 117 body: object, The request body. 118 The object takes the form of: 119 120{ # The request message for Conversations.CompleteConversation. 121} 122 123 x__xgafv: string, V1 error format. 124 Allowed values 125 1 - v1 error format 126 2 - v2 error format 127 128Returns: 129 An object of the form: 130 131 { # Represents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions. 132 "conversationProfile": "A String", # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`. 133 "conversationStage": "A String", # The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE. 134 "endTime": "A String", # Output only. The time the conversation was finished. 135 "lifecycleState": "A String", # Output only. The current state of the Conversation. 136 "name": "A String", # Output only. The unique identifier of this conversation. Format: `projects//locations//conversations/`. 137 "phoneNumber": { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. Required if the conversation is to be connected over telephony. 138 "phoneNumber": "A String", # Output only. The phone number to connect to this conversation. 139 }, 140 "startTime": "A String", # Output only. The time the conversation was started. 141}</pre> 142</div> 143 144<div class="method"> 145 <code class="details" id="create">create(parent, body=None, conversationId=None, x__xgafv=None)</code> 146 <pre>Creates a new conversation. Conversations are auto-completed after 24 hours. Conversation Lifecycle: There are two stages during a conversation: Automated Agent Stage and Assist Stage. For Automated Agent Stage, there will be a dialogflow agent responding to user queries. For Assist Stage, there's no dialogflow agent responding to user queries. But we will provide suggestions which are generated from conversation. If Conversation.conversation_profile is configured for a dialogflow agent, conversation will start from `Automated Agent Stage`, otherwise, it will start from `Assist Stage`. And during `Automated Agent Stage`, once an Intent with Intent.live_agent_handoff is triggered, conversation will transfer to Assist Stage. 147 148Args: 149 parent: string, Required. Resource identifier of the project creating the conversation. Format: `projects//locations/`. (required) 150 body: object, The request body. 151 The object takes the form of: 152 153{ # Represents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions. 154 "conversationProfile": "A String", # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`. 155 "conversationStage": "A String", # The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE. 156 "endTime": "A String", # Output only. The time the conversation was finished. 157 "lifecycleState": "A String", # Output only. The current state of the Conversation. 158 "name": "A String", # Output only. The unique identifier of this conversation. Format: `projects//locations//conversations/`. 159 "phoneNumber": { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. Required if the conversation is to be connected over telephony. 160 "phoneNumber": "A String", # Output only. The phone number to connect to this conversation. 161 }, 162 "startTime": "A String", # Output only. The time the conversation was started. 163} 164 165 conversationId: string, Optional. Identifier of the conversation. Generally it's auto generated by Google. Only set it if you cannot wait for the response to return a auto-generated one to you. The conversation ID must be compliant with the regression fomula "a-zA-Z*" with the characters length in range of [3,64]. If the field is provided, the caller is resposible for 1. the uniqueness of the ID, otherwise the request will be rejected. 2. the consistency for whether to use custom ID or not under a project to better ensure uniqueness. 166 x__xgafv: string, V1 error format. 167 Allowed values 168 1 - v1 error format 169 2 - v2 error format 170 171Returns: 172 An object of the form: 173 174 { # Represents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions. 175 "conversationProfile": "A String", # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`. 176 "conversationStage": "A String", # The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE. 177 "endTime": "A String", # Output only. The time the conversation was finished. 178 "lifecycleState": "A String", # Output only. The current state of the Conversation. 179 "name": "A String", # Output only. The unique identifier of this conversation. Format: `projects//locations//conversations/`. 180 "phoneNumber": { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. Required if the conversation is to be connected over telephony. 181 "phoneNumber": "A String", # Output only. The phone number to connect to this conversation. 182 }, 183 "startTime": "A String", # Output only. The time the conversation was started. 184}</pre> 185</div> 186 187<div class="method"> 188 <code class="details" id="get">get(name, x__xgafv=None)</code> 189 <pre>Retrieves the specific conversation. 190 191Args: 192 name: string, Required. The name of the conversation. Format: `projects//locations//conversations/`. (required) 193 x__xgafv: string, V1 error format. 194 Allowed values 195 1 - v1 error format 196 2 - v2 error format 197 198Returns: 199 An object of the form: 200 201 { # Represents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions. 202 "conversationProfile": "A String", # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`. 203 "conversationStage": "A String", # The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE. 204 "endTime": "A String", # Output only. The time the conversation was finished. 205 "lifecycleState": "A String", # Output only. The current state of the Conversation. 206 "name": "A String", # Output only. The unique identifier of this conversation. Format: `projects//locations//conversations/`. 207 "phoneNumber": { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. Required if the conversation is to be connected over telephony. 208 "phoneNumber": "A String", # Output only. The phone number to connect to this conversation. 209 }, 210 "startTime": "A String", # Output only. The time the conversation was started. 211}</pre> 212</div> 213 214<div class="method"> 215 <code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code> 216 <pre>Returns the list of all conversations in the specified project. 217 218Args: 219 parent: string, Required. The project from which to list all conversation. Format: `projects//locations/`. (required) 220 filter: string, A filter expression that filters conversations listed in the response. In general, the expression must specify the field name, a comparison operator, and the value to use for filtering: - The value must be a string, a number, or a boolean. - The comparison operator must be either `=`,`!=`, `>`, or `<`. - To filter on multiple expressions, separate the expressions with `AND` or `OR` (omitting both implies `AND`). - For clarity, expressions can be enclosed in parentheses. Only `lifecycle_state` can be filtered on in this way. For example, the following expression only returns `COMPLETED` conversations: `lifecycle_state = "COMPLETED"` For more information about filtering, see [API Filtering](https://aip.dev/160). 221 pageSize: integer, Optional. The maximum number of items to return in a single page. By default 100 and at most 1000. 222 pageToken: string, Optional. The next_page_token value returned from a previous list request. 223 x__xgafv: string, V1 error format. 224 Allowed values 225 1 - v1 error format 226 2 - v2 error format 227 228Returns: 229 An object of the form: 230 231 { # The response message for Conversations.ListConversations. 232 "conversations": [ # The list of conversations. There will be a maximum number of items returned based on the page_size field in the request. 233 { # Represents a conversation. A conversation is an interaction between an agent, including live agents and Dialogflow agents, and a support customer. Conversations can include phone calls and text-based chat sessions. 234 "conversationProfile": "A String", # Required. The Conversation Profile to be used to configure this Conversation. This field cannot be updated. Format: `projects//locations//conversationProfiles/`. 235 "conversationStage": "A String", # The stage of a conversation. It indicates whether the virtual agent or a human agent is handling the conversation. If the conversation is created with the conversation profile that has Dialogflow config set, defaults to ConversationStage.VIRTUAL_AGENT_STAGE; Otherwise, defaults to ConversationStage.HUMAN_ASSIST_STAGE. If the conversation is created with the conversation profile that has Dialogflow config set but explicitly sets conversation_stage to ConversationStage.HUMAN_ASSIST_STAGE, it skips ConversationStage.VIRTUAL_AGENT_STAGE stage and directly goes to ConversationStage.HUMAN_ASSIST_STAGE. 236 "endTime": "A String", # Output only. The time the conversation was finished. 237 "lifecycleState": "A String", # Output only. The current state of the Conversation. 238 "name": "A String", # Output only. The unique identifier of this conversation. Format: `projects//locations//conversations/`. 239 "phoneNumber": { # Represents a phone number for telephony integration. It allows for connecting a particular conversation over telephony. # Output only. Required if the conversation is to be connected over telephony. 240 "phoneNumber": "A String", # Output only. The phone number to connect to this conversation. 241 }, 242 "startTime": "A String", # Output only. The time the conversation was started. 243 }, 244 ], 245 "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list. 246}</pre> 247</div> 248 249<div class="method"> 250 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 251 <pre>Retrieves the next page of results. 252 253Args: 254 previous_request: The request for the previous page. (required) 255 previous_response: The response from the request for the previous page. (required) 256 257Returns: 258 A request object that you can call 'execute()' on to request the next 259 page. Returns None if there are no more items in the collection. 260 </pre> 261</div> 262 263</body></html>