@handlemotion/agents-sdk

React embed SDK for Handlemotion Agents web chat.

Install

pnpm add @handlemotion/agents-sdk ai @ai-sdk/react react streamdown

Usage

Allowlist your site origin in the Handlemotion admin console (Web connector → allowed origins), then embed:

import "@handlemotion/agents-sdk/styles.css";
import { WebChat } from "@handlemotion/agents-sdk";

export function SupportChat() {
  return <WebChat orgSlug="your-org-slug" />;
}

For Next.js apps, you can use env-based org slug:

import { WebChatFromEnv } from "@handlemotion/agents-sdk";

// .env.local: NEXT_PUBLIC_AGENTS_ORG_SLUG=your-org-slug
<WebChatFromEnv />;

Optional: point at a non-default API host with apiBaseUrl or NEXT_PUBLIC_AGENTS_API_URL.

Exports

• WebChat, WebChatFromEnv, WebChatProps
• createWebChatTransport
• resolveApiBaseUrl, DEFAULT_AGENTS_API_URL
• @handlemotion/agents-sdk/styles.css