Introduction

Overview

The Messaging SDK deploys an AI Agent into websites and mobile applications. It is the next generation of Ada’s embedded chat, and it replaces the Chat SDKs. The Messaging SDK works with generative AI Agents.

The SDK provides a complete chat interface that supports both AI-powered and human-agent conversations. It also provides a programmatic surface, so your own code can configure, observe, and drive the conversation.

Supported platforms

PlatformGet started
WebWeb SDK
iOSiOS SDK
AndroidAndroid SDK
React NativeReact Native SDK

Continuously delivered web runtime

The web runtime ships from Ada’s CDN. Every page load resolves the current rollout version, so fixes and improvements reach your site without a redeploy on your side.

The npm packages follow the same model. They carry TypeScript types, test mocks, and a thin loader. They never pin the runtime version. See Choosing an integration for details.

To validate a specific runtime build before it rolls out, use the ?ada-messaging-version query parameter.

What’s new in Messaging

  • Control over the conversation UI. Replace the built-in UI with an app you host, through the appUrl setting and @ada-cx/messaging-bridge. Build that app from Lovelace, Ada’s React component library. On mobile, headless mode connects to the AI Agent without rendering any Ada UI, so you drive the conversation from your own native components.
  • Message delivery that survives a bad network. The SDK recovers dropped messages and restores order after a reconnect. A live-agent handoff survives a page reload. Conversation-scoped event acceptance stops a stale event from reaching a new conversation.
  • Accessibility improvements. Keyboard operability, visible focus indicators, ARIA roles and labels, screen-reader announcements for incoming messages, and per-bubble sender attribution. Right-to-left layouts render in the correct direction. Automated axe checks run in CI.
  • A typed developer surface. @ada-cx/messaging-sdk carries TypeScript types for the full SDK surface and an in-memory mock for your unit tests. Subscribe to conversation events, read the conversation, and control the client lifecycle from your own code.
  • Attachments in the conversation. Files pass through a live-agent handoff. An end user can also attach an image with a caption to an AI Agent message. Ask your Ada team to enable that.
  • Identity tokens. Start sessions as a known end user with a short-lived, single-use token minted by your backend. Available on web, iOS, Android, and React Native.

Relationship to the Chat SDKs

The Chat SDKs and the Messaging SDK are documented side by side while customers migrate. The Chat SDKs remain supported, and existing integrations keep working.

For new development, use the Messaging SDK. If you already use the Chat SDK web script, the migration usually requires no code change. See Migrate from the Chat SDK web script.

Next steps