Skip to main content
System events capture critical transitions in a conversation—session start, session end, and agent handoff. Configure each event to control what the app does at that transition.

​
Overview

Events fire automatically at defined points in the conversation. All events are disabled by default. To enable and configure an event, go to Settings > Events and click the edit icon next to the event.

​
Welcome Event

Triggered once at the start of each new session. Use this event to deliver a greeting and set the initial context. To configure:
  1. Click the edit icon and enable the event.
  2. Under Actions, configure Send Message to User:
    • Select AI-generated to let the model compose the message, or
    • Enter a Custom message. You can include memory store variables in the message.

​
Agent Handoff Event

Triggered when an agent handoff is requested. By default, the handoff fires when the user explicitly requests one or when the system cannot fulfill the request. Agent handoff is supported only via the AI for Service Platform. When triggered, the Platform sends session data to the specified automation node, which processes the transfer according to its configured connection rules. To configure:
  1. Click the edit icon and enable the event.
  2. Configure the following fields:
    FieldDescription
    DescriptionConditions that trigger this event. Edit to customize handoff detection logic.
    LLM Collected Event ParametersFields the LLM extracts from the conversation when the event fires. Provide a parameter name and describe the expected content. Example: an interaction summary passed to the receiving agent.
    System Defined ParametersFields populated directly from context or memory—not inferred by the LLM. Provide a key (field name) and a value: a static string or a memory/context variable such as {{user.country}}. The Platform resolves these values at runtime.
    Send Message to UserMessage shown when the handoff occurs. Select AI-generated or enter a custom message.
    Session ManagementKeep Alive — Maintains the session after the event. Terminate Session — Ends the session when the event fires.

​
End of Conversation Event

Triggered when a session ends. Use this event to send a closing message or collect summary data. This event is disabled by default. To configure:
  1. Click the edit icon and enable the event.
  2. Configure the following fields:
    FieldDescription
    DescriptionConditions that identify the end of conversation. Edit to update trigger logic.
    LLM Collected Event ParametersFields the LLM extracts from the conversation when the event fires. Provide a parameter name and describe the expected content.
    System Defined ParametersFields populated directly from context or memory. Provide a key and a value: a static string or a memory/context variable such as {{user.country}}.
    Send Message to UserMessage shown when the session ends. Select AI-generated or enter a custom message. Memory store variables can be included.
    Session ManagementKeep Alive — Maintains the session after the event. Terminate Session — Ends the session when the event fires.