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.
An event handler specifies an event that can be handled during a session. When the specified event happens, the following actions are taken in order:
If there is a triggerFulfillment associated with the event, it will be called.
If there is a targetPage associated with the event, the session will transition into the specified page.
If there is a targetFlow associated with the event, the session will transition into the specified flow.
JSON representation
{"name": string,"event": string,"triggerFulfillment": {object (Fulfillment)},// Union field target can be only one of the following:"targetPage": string,"targetFlow": string,"targetPlaybook": string// End of list of possible types for union field target.}
Fields
name
string
Output only. The unique identifier of this event handler.
The fulfillment to call when the event occurs. Handling webhook errors with a fulfillment enabled with webhook could cause infinite loop. It is invalid to specify such fulfillment for a handler handling webhooks.
Union field target. The target to transition to, either a page in the same host flow (the flow that owns this TransitionRoute), or another flow in the same agent. target can be only one of the following:
targetPage
string
The target page to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>.
targetFlow
string
The target flow to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>.
targetPlaybook
string
The target playbook to transition to. Format: projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/playbooks/<PlaybookID>.
[[["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\u003eEvent handlers define actions to be taken when a specified event occurs during a session.\u003c/p\u003e\n"],["\u003cp\u003eUpon an event, a \u003ccode\u003etriggerFulfillment\u003c/code\u003e may be executed, followed by a transition to a \u003ccode\u003etargetPage\u003c/code\u003e or \u003ccode\u003etargetFlow\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation includes fields for the event \u003ccode\u003ename\u003c/code\u003e, the \u003ccode\u003eevent\u003c/code\u003e being handled, and the associated \u003ccode\u003etriggerFulfillment\u003c/code\u003e and target, such as \u003ccode\u003etargetPage\u003c/code\u003e, \u003ccode\u003etargetFlow\u003c/code\u003e or \u003ccode\u003etargetPlaybook\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etarget\u003c/code\u003e field in an event handler can direct the session to a specific \u003ccode\u003etargetPage\u003c/code\u003e, \u003ccode\u003etargetFlow\u003c/code\u003e, or \u003ccode\u003etargetPlaybook\u003c/code\u003e, each identified by a unique format.\u003c/p\u003e\n"]]],[],null,[]]