@concatflow/embed

The browser library. It loads the hosted widget.js and gives you a typed Concatflow object.

npm install @concatflow/embed

import { loadConcatflow } from "@concatflow/embed";

const Concatflow = await loadConcatflow();
Concatflow.init({ siteToken: "st_YOUR_SITE_TOKEN", launcher: "bubble" });

Like @stripe/stripe-js, the package does not contain the assistant. It loads widget.js from Concatflow once, so your customers always get the current version. What it adds: types, validated options, and a React component.

No build step? You do not need this package. Paste the two tags from Doors. See Quickstart.

Reference

loadConcatflow()

Load widget.js once and get the Concatflow object.

Concatflow.init()

Open the assistant: door, launcher, theme, renewal.

Assistant instance

setSession, open, close, destroy.

<ConcatflowAssistant>

The React component, from @concatflow/embed/react. React 18 or later.

<concatflow-assistant>

The HTML element, for pages without JavaScript of your own.

Guides

• Per-user door: open a session on your server, show the assistant.
• React: the component in a React or Next.js app.
• Bar or bubble and Appearance.