SaaS app

Open Deploy > SaaS app to configure the drawer profile for authenticated web applications. This setup is separate from Deploy > Chat widget: use Chat widget for public website launchers and inline panels, and use SaaS app for an in-app assistant drawer.

Configure the drawer profile

Set the SaaS app display name, colors, welcome message, model, and instructions from the SaaS app deploy page.

Create a channel key

Use the Embed tab to create or copy a live or sandbox publishable key for the SaaS app channel.

Copy the drawer snippet

Paste the drawer snippet inside your authenticated app shell or layout.

Pass identity when available

For signed-in users, append endUser and a backend-signed identity JWT to the iframe src.

Drawer snippet

Copy live drawer snippet emits only the right-side drawer iframe. It does not include the Chat widget launcher host scripts.

<!-- Chatropic SaaS app assistant drawer -->
<iframe
  id="chatropic-drawer"
  src="https://chatropic.com/embed/key/cpk_live_...?mode=drawer"
  title="Support assistant"
  allow="microphone"
  style="position:fixed;bottom:16px;right:16px;width:min(432px,calc(100vw-32px));height:calc(80dvh + 88px);border:none;background:transparent;z-index:99999;overflow:visible"
></iframe>

The drawer snippet omits session so production users are not pinned to a shared preview conversation.

Signed-in users

For authenticated apps, build the iframe src at runtime with the signed-in user’s stable id. If actions require customer login or trusted user identity, mint identity on your backend and append it with endUser.

<iframe
  id="chatropic-drawer"
  src="https://chatropic.com/embed/key/cpk_live_...?mode=drawer&endUser=user_123&identity=YOUR_JWT"
  title="Support assistant"
  allow="microphone"
  style="position:fixed;bottom:16px;right:16px;width:min(432px,calc(100vw-32px));height:calc(80dvh + 88px);border:none;background:transparent;z-index:99999;overflow:visible"
></iframe>

Generate the identity signing secret from Manage tokens when creating a customer-login token. Sign JWTs on your server with HS256, including sub (must match endUser) and exp.

Never expose the identity signing secret or JWT minting logic in browser code.

Environment variables

The Embed tab also shows channel key examples for app configuration:

NEXT_PUBLIC_CHATROPIC_PUBLISHABLE_KEY=cpk_live_...
NEXT_PUBLIC_CHATROPIC_SANDBOX_PUBLISHABLE_KEY=cpk_test_...

Use sandbox keys for development and live keys for production.

URL options

Param	Purpose
`mode=drawer`	Loads the SaaS app drawer profile
`product`	Agent product (`customer_support`, etc.), omit for default
`endUser`	Stable signed-in user id, required for customer-login tokens and agent BFF
`identity`	JWT from your backend, verifies `endUser` with the workspace identity secret
`theme`	`dark` or `light`, an optional override of the stored widget theme
`session`	Preview only; omit in production
`demo`	Set to `1` to show a mock SaaS shell behind the drawer preview

Web embed

Website widget and inline panel setup.

Manage tokens

Static and customer-login credentials for actions.

Quick Start

Agent Management

Actions

Settings & Guardrails

Deploy

Analytics & Monitoring

Drawer snippet

Signed-in users

Environment variables

URL options

Web embed

Manage tokens

​Drawer snippet

​Signed-in users

​Environment variables

​URL options

Web embed

Manage tokens

Drawer snippet

Signed-in users

Environment variables

URL options