Android

Android SDK

Overview

The Ada Android SDK is a Kotlin library that you can use to embed Ada in your Android app. It ships as a single Maven Central artifact, cx.ada:messaging-android, and provides settings and actions that customize the behavior of your AI Agent. You can do things like:

  • Embed the conversation in your own layout, a full-screen activity, or a dialog
  • Programmatically set the AI Agent language
  • Pass public and sensitive metadata using MetaFields.Builder
  • Authenticate end users with a backend-minted identity token
  • Run a headless conversation and build your own native UI, such as an unread badge, on top of conversation events
  • Configure push notifications with device tokens

From version 1.2.0, session state persists across an app force-quit. This includes an active live agent handoff. See Session persistence for the storage details and the required sign-out step.

The Android SDK reference covers all of the settings and actions available to developers of Android apps.

Compatibility

The SDK supports Android 6.0 (API level 23) and up with Android System WebView 99 or later. Your app must use AndroidX and build with a Kotlin 2.2-compatible toolchain. See Compatibility for the full requirements.

Migrating from the existing Android SDK

If you currently use the existing Ada Android SDK (support.ada.embed.*), the new SDK is designed as a low-risk upgrade. Most apps only need a dependency swap and import renames. See Upgrade from the existing Android SDK for the migration steps.