1-Line Live Chat Widget Embed

The standalone widget.js is a zero-dependency script that injects the floating chat trigger and conversation window into any website.

HTML / Vanilla JavaScript Embed

Add this script tag immediately before the closing </body> tag of your website:

<script 
  src="https://your-domain.com/widget.js" 
  data-app-id="wd_live_your_workspace_id"
  data-theme="#6366f1"
  data-bot-name="Support Copilot"
  data-position="bottom-right"
  async>
</script>

Configuration Attributes

Attribute	Type	Default	Description
data-app-id	string	Required	Your unique WeaveDesk workspace ID or license key.
data-theme	hex string	#6366f1	Primary accent color for launcher, buttons, and badges.
data-bot-name	string	WeaveDesk Copilot	Name displayed in widget title bar.
data-position	string	bottom-right	Widget position: bottom-right or bottom-left.
data-greeting	string	Default greeting	Initial AI greeting message sent to visitor.
data-require-lead	boolean	true	Prompts for visitor name & email before chat starts.

Programmatic JavaScript API

You can programmatically control the widget from your own front-end scripts:

// Open the widget
window.WeaveDesk.open();

// Close the widget
window.WeaveDesk.close();

// Identify authenticated user
window.WeaveDesk.identify({
  userId: "usr_98124",
  name: "Alex Mercer",
  email: "alex@company.com"
});