Prerequisites
react >= 18andreact-native >= 0.73- A teammate (or you) has configured an agent in the dashboard
- The Mobile app deploy profile is set up, as described in the React Native deploy guide
1
Deploy the Mobile app profile
In the dashboard, open Deploy > Mobile app, configure the Content, Style, and AI tabs, then click Deploy and confirm the profile shows Live. The SDK loads all branding and copy from this profile at startup.
2
Copy your publishable key
On Deploy > Mobile app, open the Embed tab and copy the publishable key (prefix
cpk_live_). This key is scoped to widget runtime calls and is safe to ship in app code.3
Install the SDK
4
Render the launcher
5
Send a test message
Run your app, tap the launcher, and ask a question your agent’s knowledge can answer. The reply should be grounded in the documents your team uploaded.
What success looks like
- The launcher opens with your configured welcome message, colors, and suggested prompts
- A knowledge question returns a grounded answer
- The conversation appears in the dashboard under Chat logs
Next steps
React Native SDK guide
Full-screen chat, signed-in users, and every prop.
Authentication & identity
Connect conversations to signed-in users.
Messages & sessions
How conversations persist across turns.
SDK reference
Components, props, and callbacks.