Widget

/ Embeddable chat bubble. Source in the monorepo. Handoff UI routes into Desk Center when your agent signals escalation.

Where the code lives

apps/dashboard/public/widget.js in the Humaner monorepo. Inspect auth, visitor identify, and handoff UI without reverse-engineering minified production builds.

Minimal embed

index.html

<script
  src="https://yourwebsite.com/widget.js"
  data-agent-id="YOUR_AGENT_PUBLIC_ID"
  async
></script>

Integration styling and product options are documented under Intelligence → Integrations → Widget.

Handoff

When your agent returns escalate: true, the widget shows Human Desk options. Desk Center creates the ticket with the summary and urgency you pass.

Connect your agent

Wire your API into the handoff framework.

Install guide →

Browser security model

Domain allowlist on the agent — requests from other origins are rejected.
Public agent ID only in the page — no secret keys client-side.
Visitor identify uses your hashed user ID, never raw PII.