React Native

React Native SDK

Overview

The Ada React Native SDK embeds your Ada AI Agent in a React Native app. The @ada-cx/messaging-react-native package provides the AdaMessagingView component, which runs the Agent inside a secure react-native-webview instance. You can do things like:

  • Embed the Agent as a React component and control it through props
  • Send commands at runtime with an imperative handle, including sendMessage, reset, and setMetaFields
  • Receive Agent events through a single onEvent callback to drive analytics or your own UI
  • Start sessions as a known user with a short-lived, single-use identityToken
  • Run the Agent in headless mode and build a fully native chat experience
  • Remove the loading state after process restarts with onStateCache and initialState

The live session ends when the component unmounts. Persist onStateCache snapshots and pass them back as initialState to rehydrate on the next mount. See Session lifecycle and state restoration.

The React Native SDK reference covers all of the settings, actions, and events available to developers of React Native apps.

To get started, see the React Native getting started guide.