React Native app

The React Native SDK uses a dedicated Mobile app deploy profile. Configure appearance in the dashboard; the mobile app loads it automatically with a publishable mobile keywith a publishable mobile key.

Before you integrate

Open your agent in the dashboardashboard.
Go to Deploy > Deploy > Mobile app.
Set the the Content (welcome message, prompts), Style (colors, theme), and AI settings.
Click Deploy, then confirmconfirm the profile is Live.

Publishable keyPublishable key

Your integrator needs the publishable key from the Embed tab on Deploy > Mobile app.publishable key from the Embed tab on Deploy > Mobile app. Share this key with your mobile team. It is scoped to mobile and widget runtime calls, and it is required for chat, history, feedback, and voice.

SDK components

Mode	SDK component	`profile` prop
Floating launcher	`ChatWidgetLauncher`	`"mobile"` (default)
Full-screen chat	`ChatWidgetScreen`	`"mobile"` (default)

The mobile profile is separate from the web Chat widget and SaaS app profiles. Deploy and enable Mobile app before shipping your native build.

Signed-in apps

Pass user identity from your auth state so {{end_user_id}} resolves correctly and threads appear in Inbox with the visitor’s name.

Prop	Purpose
`endUserId`	Stable user id, required for agent BFF actions
`userName`	Display name in inbox and Slack alerts
`userEmail`	Email shown with name in inbox and alerts

<ChatWidgetLauncher
  publishableKey={publishableKey}
  profile="mobile"
  endUserId={user.id}
  userName={`${user.first_name} ${user.last_name}`.trim()}
  userEmail={user.email}
/>

Auth patterns

Pattern	When to use	Docs
Agent BFF	User signs in to your app; your backend proxies API calls	Manage tokens, Pricepally recipe

See the React Native SDK developer guide for full prop reference and the examples/react-native-demo wiring.

Test with the demo app

The repo includes examples/react-native-demo:

cd examples/react-native-demo
cp .env.example .env
# Set EXPO_PUBLIC_CHATROPIC_PUBLISHABLE_KEY
npm install
npx expo run:ios

Developer guide

Install, props, and navigation wiring.

Web widget

Same config for website embeds.

Quick Start

Agent Management

Actions

Settings & Guardrails

Deploy

Analytics & Monitoring

Before you integrate

Publishable keyPublishable key

SDK components

Signed-in apps

Auth patterns

Test with the demo app

Developer guide

Web widget

​Before you integrate

​Publishable keyPublishable key

​SDK components

​Signed-in apps

​Auth patterns

​Test with the demo app

Developer guide

Web widget

Before you integrate

Publishable keyPublishable key

SDK components

Signed-in apps

Auth patterns

Test with the demo app