Add Event Subscriber

The addEventSubscriber method lets you listen to real-time events triggered inside the AdoptAI SDK sidebar. By subscribing to these events, your app can respond to user actions, analytics events, or sidebar updates — all without modifying the SDK itself. This is useful if you want to:

Track how users interact with the sidebar.
Log events for analytics or monitoring.
Trigger workflows in your own app when specific Adopt events occur.

How to Use

We introduced an event subscription system that allows external applications to subscribe to AdoptAI-specific events emitted on the global window object.
This enables you to monitor and handle sidebar interactions (like message loads, tool executions, or user actions) in real time. Paste this code block after the SDK has been booted in your application.

//Define your handler (mandatory handler)
const myHandler = (eventName, eventData) => {
  // Process the events as required
};
//Subscribe to events
const unsubPromise = window.AdoptAI.addEventSubscriber(myHandler);
//To unSubscribe 

Explanation

The Event Handler

const myHandler = (eventName, eventData) => {
  // Process the events as required
};

eventName — a string representing the event type (e.g. adopt_copilot:message_loaded).
eventData — an object containing the event payload and contextual details.

Your handler function is called automatically each time the SDK emits a new event.

Subscribing to Events

window.AdoptAI.addEventSubscriber(myHandler);

When you subscribe, the SDK invokes your handler for every emitted event.
You can store or forward these events (for example, to analytics tools like Segment or Datadog), or trigger custom actions inside your own app. To clean up, call the function returned by the promise:

unsubPromise.then((unsub) => unsub());

This ensures your handler is properly unsubscribed when it’s no longer needed.

Available Events

All event names follow the adopt_copilot:<event> convention.

Event Name	Description
`adopt_copilot:newConversation_click`	Triggered when a user starts a new conversation in the sidebar.
`adopt_copilot:minimize_click`	Fired when the sidebar is minimized.
`adopt_copilot:expand_click`	Fired when the sidebar is expanded.
`adopt_copilot:history_open`	Triggered when a user opens conversation history.
`adopt_copilot:history_close`	Triggered when a user closes conversation history.
`adopt_copilot:action_initiated`	Fired when a copilot action is initiated.
`adopt_copilot:action_executed`	Fired when a copilot action completes successfully.
`adopt_copilot:action_failed`	Fired when a copilot action fails.
`adopt_copilot:stop_execution`	Triggered when a user manually stops a running action.

Our Products

Workflows & Use Cases

Features

Authentication

JavaScript SDK

API

How to Use

Explanation

The Event Handler

Subscribing to Events

Available Events

​How to Use

​Explanation

​The Event Handler

​Subscribing to Events

​Available Events

How to Use

Explanation

The Event Handler

Subscribing to Events

Available Events