Your team configures the agent in the dashboard. Your job as an integrator is to put that agent in front of customers. There are two supported surfaces:
  1. Web embed. Copy a snippet from the dashboard and paste it into your site. The snippet renders a floating launcher or an inline panel and needs no build step. Most integrations need nothing more than this.
  2. React Native SDK. Install @chatropic/react-native to render a native chat UI inside your iOS and Android apps, branded from your Mobile app deploy profile. The SDK is currently Beta.
Everything else, including knowledge, actions, guardrails, and branding, is configured in the dashboard by your team. Your code never has to orchestrate the agent itself.

​
Choose your surface

Web embed

Paste the website widget or inline panel snippet from Deploy > Chat widget > Embed. No SDK required.

React Native quickstart

Install the SDK and show a chat launcher in your app in under 10 minutes.

​
What you will work with

  • A publishable key from the Mobile app deploy profile authenticates the React Native SDK. It is safe to ship in app code.
  • Navigation cards let the agent deep-link users to pages in your product. You wire one callback (onNavigate on mobile, a host-page listener on web) to your router.
  • Signed-in user identity (endUserId, plus an optional signed identity token) connects conversations to known users and powers authenticated actions.

​
Keep reading

Architecture

How a chat turn flows through knowledge and actions.

Authentication & identity

Publishable keys and signed-in user identity.

Embed navigation

Handle deeplinks from the web embed.

Capability matrix

Stable, Beta, and Planned features at a glance.

​
Need help?

If the agent’s answers or actions are wrong, that is configured in the dashboard rather than in your integration. Point your team to the User Guide. For integration issues, check Error handling first.