Some products and features are in the process of being renamed. Generative playbook and flow features are also being migrated to a single consolidated console. See the details.
Required. The name of the session this query is sent to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default 'draft' environment. It's up to the API caller to choose an appropriate Session ID. It can be a random number or some type of session identifiers (preferably hashed). The length of the Session ID must not exceed 36 characters.
Authorization requires the following IAM permission on the specified resource session:
dialogflow.sessions.detectIntent
Request body
The request body contains data with the following structure:
JSON representation
{"matchIntentRequest": {"session": string,"queryParams": {"timeZone": string,"geoLocation": {object (LatLng)},"sessionEntityTypes": [{object (SessionEntityType)}],"payload": {object},"parameters": {object},"parameterScope": string,"currentPage": string,"disableWebhook": boolean,"analyzeQueryTextSentiment": boolean,"webhookHeaders": {string: string,...},"flowVersions": [string],"currentPlaybook": string,"llmModelSettings": {object (LlmModelSettings)},"channel": string,"sessionTtl": string,"endUserMetadata": {object},"searchConfig": {object (SearchConfig)},"populateDataStoreConnectionSignals": boolean},"queryInput": {"languageCode": string,// Union field input can be only one of the following:"text": {object (TextInput)},"intent": {object (IntentInput)},"audio": {object (AudioInput)},"event": {object (EventInput)},"dtmf": {object (DtmfInput)},"toolCallResult": {object (ToolCallResult)}// End of list of possible types for union field input.},"persistParameterChanges": boolean},"match": {object (Match)},"outputAudioConfig": {object (OutputAudioConfig)}}
Required. The name of the session this query is sent to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID> or projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>. If Environment ID is not specified, we assume default 'draft' environment. It's up to the API caller to choose an appropriate Session ID. It can be a random number or some type of session identifiers (preferably hashed). The length of the Session ID must not exceed 36 characters.
[[["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-06-27 UTC."],[[["\u003cp\u003eThis API endpoint fulfills a matched intent previously identified by the \u003ccode\u003esessions.matchIntent\u003c/code\u003e method, requiring the output from \u003ccode\u003eMatchIntentResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for this operation is a \u003ccode\u003ePOST\u003c/code\u003e request directed to a specific endpoint URL that includes path parameters for session identification.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a structured JSON payload containing details about the \u003ccode\u003ematchIntentRequest\u003c/code\u003e, such as \u003ccode\u003equeryParams\u003c/code\u003e, \u003ccode\u003equeryInput\u003c/code\u003e, and whether to \u003ccode\u003epersistParameterChanges\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a \u003ccode\u003eFulfillIntentResponse\u003c/code\u003e, and authorization requires specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe session path parameter requires a string in the format \u003ccode\u003eprojects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>\u003c/code\u003e or \u003ccode\u003eprojects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>\u003c/code\u003e with the \u003ccode\u003eSession ID\u003c/code\u003e not exceeding 36 characters.\u003c/p\u003e\n"]]],[],null,[]]