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

Session persistence across app restarts is not supported. The SDK stores session state in the WebView’s localStorage, which is not guaranteed to survive a force-quit on Android. See Session persistence for details.

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. 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.