> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# ai:chat-start embed event

> Emitted by Omni when an AI chat session begins.

This event is emitted when:

* The `/chat` route loads in the embedded Omni application
* The workbook AI drawer is opened

Use this event to track when users start AI chat sessions or to trigger custom behaviors in your embedding application when AI features are accessed.

## Payload

```json theme={null}
{
  "chatSessionId": "string"
}
```

## Properties

<ParamField path="chatSessionId" type="string">
  The unique identifier for the AI chat session that was started.
</ParamField>

## Example

```json theme={null}
{
  "chatSessionId": "chat-session-abc123"
}
```