> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Introducing Messaging

[Messaging](/messaging/introduction/overview) is Ada's next-generation web and mobile SDK for embedding an AI Agent. It replaces Chat and the legacy Chat SDKs: the web `embed2.js` script tag, `@ada-support/embed2` npm package, iOS, Android, and React Native.

On desktop, custom apps can size, position, and style their frame with [`setFrameStyles`](/messaging/custom-apps/operations#setframestyles), including transparent backgrounds. Read `appearance.hostViewport` to adapt the frame to the available space. [Launch Controls](/docs/channels/messaging/messaging-configuration/launch-options) now serves the alternative AI Agent in the Messaging web SDK.

Ada has deprecated Chat. Messaging fully replaces Chat on **December 15, 2026**. Before you choose a migration path, identify whether your website uses the script tag or npm package. Check mobile applications separately.

If you use the Chat script tag, `embed2.js`, you do not need to change your code. Ada moves each AI Agent to Messaging, starting **October 1, 2026**. Keep your existing script tag and read the [web script migration guide](/messaging/web/getting-started#migrate-from-the-chat-sdk-web-script).

If you use the `@ada-support/embed2` npm package, Ada cannot move it for you. Replace it with the Messaging SDK package before December 15, 2026. Follow the [npm migration guide](/messaging/web/getting-started#migrate-from-the-embed2-npm-package).

If you use a legacy iOS, Android, or React Native SDK, upgrade to the Messaging SDK for your platform before December 15, 2026. Follow the upgrade guide for [iOS](/messaging/ios/getting-started#upgrade-from-the-existing-ios-sdk), [Android](/messaging/android/getting-started#upgrade-from-the-existing-android-sdk), or [React Native](/messaging/react-native/getting-started#upgrade-from-the-existing-react-native-sdk).

To choose a setup, use the [integration chooser](/messaging/introduction/choosing-an-integration). For dashboard setup and configuration, start with the [Messaging channel overview](/docs/channels/messaging).

Try the [Integration examples](/messaging/integration-examples) and download a starter project.