Widget Mode: Voice, Chat, or Voice & ChatWidget Size: Choose between standard or extra large layout
Standard: Compact floating widget suitable for most use cases
Extra Large: Half-screen panel on desktop, full-screen on mobile — ideal for detailed conversations
Position: Choose from 8 positions (bottom-right, bottom-left, bottom-center, middle-right, middle-left, top-right, top-left, top-center)Primary Color: Brand color for buttons and accentsToggle Button Size: Small or NormalToggle Button Style: Animated (glass morphism) or Simple (flat design)Auto-Open on Page Load: When enabled, the widget automatically expands when the page loads — no click required from the visitor.
Custom Avatar: Upload your own avatar image to replace the default widget icon. Appears on the toggle button and in the chat header. Max file size: 512KB, 1:1 aspect ratio (square).Button Main Text (default: “Need help?”) — primary text on the widget buttonButton Sub Text (default: “Chat with us”) — secondary text, hidden when using the small button sizeTab Labels (Voice & Chat mode only):
Voice Tab Label (default: “Voice”) — rename to match your brand language (e.g., “Call Us”, “Speak”)
Chat Tab Label (default: “Chat”) — rename to match your brand language (e.g., “Message”, “Text”)
Header Title (default: “AI Assistant”)Header Subtitle (default: “Ready to help you ✨”)Modal Title (default: “Ready to chat?”)Start Button Text (default: “Start Voice Chat”)Modal Description (default: “Click below to start your conversation”)
This tab is only visible when the widget mode includes chat (Chat Only or Voice & Chat).
Chat Placeholder (default: “Type your message…”)Send Button Label (default: “Send message”) — accessibility label for the send buttonShow Function Calls: When disabled (default), LLM tool calls (e.g., calendar lookups, knowledge base queries) are hidden from the chat, keeping the conversation clean for end users. Enable to show tool usage details.
The chat widget supports markdown formatting, so your AI assistant can send clickable links, bold text, lists, and more.To include clickable URLs in chat messages, use markdown link format in your assistant’s prompt or initial message:
Check out our [latest offers](https://example.com/offers) or visit our [help center](https://example.com/help).
Add an instruction to your assistant’s prompt like: “When sharing links or URLs, always format them as clickable markdown links: link text” — this ensures the AI consistently outputs clickable links instead of plain text URLs.
Collect information before starting conversations:Form Configuration:
Pre-form Title (default: “Before we start…”)
Pre-form Description (default: “Please provide some information to help us assist you better”)
Submit Button Text (default: “Continue”)
Form Fields:
Add custom fields to collect data:
Variable Name: Internal variable name (maps to assistant variables). Only letters, numbers, dashes, and underscores allowed.
Field Label: Display label shown to users
Field Type: Text, Email, Phone, or Textarea
Required: Make field mandatory
Placeholder: Placeholder text shown in the field
Helper Text: Optional description below the field
Variable Mapping:
Form field names automatically map to your assistant’s variables, making collected data available during conversations.Example Form Fields:
Name: Full Name (required, text)Email: Email Address (required, email)Company: Company Name (optional, text)Message: How can we help? (optional, textarea)
AI Enabled: When toggled on (default), the AI assistant automatically responds to incoming messages. Turn this off if you want to use the widget for manual-only conversations — messages are collected but the AI does not reply.
Webhook URL: Enter a URL to receive a webhook notification whenever a new conversation starts via the widget. Use this to trigger automation flows, log events to your CRM, or notify your team in real-time.
Enable Widget: Master toggle that controls whether the widget loads on your website. When disabled, the widget will not appear even if the embed script is installed on your site. Use this to temporarily hide the widget without removing code from your website.
At the top of the configuration panel, a live preview shows exactly how your widget will look and behave on a website. The preview updates in real-time as you change any setting.Copy Preview URL — copies the preview URL to your clipboard so you can open it in a separate browser tab or share it with your team for review.Reset Data — clears all stored conversation history, form submissions, and preferences in the preview. Use this to simulate a first-time visitor experience after testing.
The preview is fully interactive — you can click the widget button, fill out the pre-chat form, and start a real conversation to test your configuration before deploying.
The embed code section provides a ready-to-copy script tag. Click Copy to copy it to your clipboard, then paste it into your website before the closing </body> tag:
Save your widget settings before copying the embed code. The script loads all configuration from the server, so any unsaved changes won’t appear on your website.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Lacyai Support Docs","colors":{"primary":"#007BFF","light":null,"dark":null},"favicon":"https://mintcdn.com/lacyai/XShP4J2TcCKez9X5/favicon.png?fit=max\u0026auto=format\u0026n=XShP4J2TcCKez9X5\u0026q=85\u0026s=d87609b109d83d36abf64ad76fbaeb0c","logo":"https://mintcdn.com/lacyai/XShP4J2TcCKez9X5/logo.png?fit=max\u0026auto=format\u0026n=XShP4J2TcCKez9X5\u0026q=85\u0026s=09c7e2269ffc3d1d20220997a5184179","styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lacyai","hasAudioNarration":false,"actualSubdomain":"lacyai","customDomains":["docs.lacy.ai"],"gitSource":{"type":"github","owner":"lacyai","repo":"support-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ace8acde2457fc00317fafd","collectionId":"99145e40-8616-4f00-bbbb-e21fb33f01d3","schemaVersion":"v2","latestBuiltDeploymentHistoryId":"6ace8acde2457fc00317fafd"},"feedback":{"edits":false},"entitlements":{},"buildId":"6ace8acde2457fc00317fafd","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"AI Assistants Overview","count":16},{"language":"default","tag":"Troubleshooting \u0026 FAQs","count":12},{"language":"default","tag":"API Reference","count":10},{"language":"default","tag":"Outbound Calls","count":6},{"language":"default","tag":"Number Provisioning","count":6},{"language":"default","tag":"Phone Numbers","count":5},{"language":"default","tag":"WhatsApp","count":5},{"language":"default","tag":"Automation \u0026 Integrations","count":4},{"language":"default","tag":"AI Prompting \u0026 Conversation Design","count":4},{"language":"default","tag":"Inbound Calls","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"ai-assistants/web-widget","slug":"/ai-assistants/web-widget","pageMetadata":{"title":"Web Widget","icon":"code","description":"Embed your AI assistant on your website with voice and chat capabilities","href":"/ai-assistants/web-widget"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Embed your AI assistant on your website with voice and chat capabilities\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,Note,OptimizedImage,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Add your AI assistant to any website with a customizable widget that supports voice calls, text chat, or both.`}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`The Web Widget allows website visitors to interact with your AI assistant directly through:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Voice conversations:`}),` Real-time voice calls in the browser`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Text chat:`}),` Messaging interface for text-based interactions`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Hybrid mode:`}),` Seamless switching between voice and chat`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`accessing-widget-configuration`,children:`Accessing Widget Configuration`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Navigate to your assistant’s edit page`}),`\n`,_jsxs(_components.li,{children:[`Click the `,_jsx(_components.strong,{children:`“Web widget”`}),` button (yellow/warning color)`]}),`\n`,_jsx(_components.li,{children:`The widget configuration panel opens with live preview`}),`\n`]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=bdccdf80b9d540347d266450720cac40`,alt:`Web Widget Button Location`,\"data-og-width\":`1104`,width:`1104`,\"data-og-height\":`660`,height:`660`,\"data-path\":`resources/web-widget-button.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=271ad51a55ea6dfaf2639096a35d8f45 280w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=af19c71e766d182e9531ef5689681244 560w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=d35c0b937a9df174f3adb535580ebae8 840w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=93ba34027342a439e9852cc59377fd7c 1100w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=cc35fa16fcacfdccb66ca10b30ce1a8a 1650w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/web-widget-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=ce3ea4ca291363756d23ffd545396843 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Web Widget is a premium feature. Ensure your plan includes web widget access before configuration.`})}),`\n`,_jsx(Heading,{level:`2`,id:`widget-modes`,children:`Widget Modes`}),`\n`,_jsx(_components.p,{children:`Choose how visitors interact with your assistant:`}),`\n`,_jsx(Heading,{level:`3`,id:`voice-\u0026-chat-recommended`,children:`Voice \u0026 Chat (Recommended)`}),`\n`,_jsx(_components.p,{children:`Users can seamlessly switch between voice and text during conversations.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Best for:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Maximum flexibility for users`}),`\n`,_jsx(_components.li,{children:`Accessibility (voice for mobile, chat for quiet environments)`}),`\n`,_jsx(_components.li,{children:`Complex interactions requiring both modes`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`chat-only`,children:`Chat Only`}),`\n`,_jsx(_components.p,{children:`Text-based messaging interface only.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Best for:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Customer support and FAQs`}),`\n`,_jsx(_components.li,{children:`Environments where voice isn’t appropriate`}),`\n`,_jsx(_components.li,{children:`Lead capture and qualification forms`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`voice-only`,children:`Voice Only`}),`\n`,_jsx(_components.p,{children:`Real-time voice conversations only.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Best for:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Phone-like experience on website`}),`\n`,_jsx(_components.li,{children:`Voice-first use cases`}),`\n`,_jsx(_components.li,{children:`Hands-free interactions`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`configuration-options`,children:`Configuration Options`}),`\n`,_jsx(Heading,{level:`3`,id:`general-tab`,children:`General Tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=22046f05df48989d68a23fcedc4cd047`,alt:`Widget General Tab`,\"data-og-width\":`1016`,width:`1016`,\"data-og-height\":`710`,height:`710`,\"data-path\":`resources/widget-tab-general.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=8d5c8e55be84d54ff52121c983e0ef82 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=3724ea7cf2149faf4253ebe3cf863382 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=39a3f10d2805df4e4ca8ac8ad24dc3af 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=be670f0cc71c6338759ccf35341607b0 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=f08a8deeabe60f92e4c0bc4bafc03c3a 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-general.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=62a1114e67ca778dfac00590d6fe7919 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Widget Mode:`}),` Voice, Chat, or Voice \u0026 Chat`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Widget Size:`}),` Choose between standard or `,_jsx(_components.strong,{children:`extra large`}),` layout`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Standard`}),`: Compact floating widget suitable for most use cases`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Extra Large`}),`: Half-screen panel on desktop, full-screen on mobile — ideal for detailed conversations`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Position:`}),` Choose from 8 positions (bottom-right, bottom-left, bottom-center, middle-right, middle-left, top-right, top-left, top-center)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Primary Color:`}),` Brand color for buttons and accents`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Toggle Button Size:`}),` Small or Normal`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Toggle Button Style:`}),` Animated (glass morphism) or Simple (flat design)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Auto-Open on Page Load:`}),` When enabled, the widget automatically expands when the page loads — no click required from the visitor.`]}),`\n`,_jsx(Heading,{level:`3`,id:`button-tab`,children:`Button Tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=9d79cb4975c131d292476107e85ef852`,alt:`Widget Button Tab`,\"data-og-width\":`1015`,width:`1015`,\"data-og-height\":`649`,height:`649`,\"data-path\":`resources/widget-tab-button.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=61b3160391405d860eb35685d830949d 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=f1cf4eaf63be4f6abafd25c731d3c3db 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=03432c5ad578c038979a9ae98b65c28c 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=caf5f8aea173f147d9578fd655ba9184 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=216033e2685a85a3b3db6fb7ddac11b9 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=1fdf0949735f8e6607e0e6bc36c3cdb8 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Custom Avatar:`}),` Upload your own avatar image to replace the default widget icon. Appears on the toggle button and in the chat header. Max file size: 512KB, 1:1 aspect ratio (square).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Button Main Text`}),` (default: “Need help?”) — primary text on the widget button`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Button Sub Text`}),` (default: “Chat with us”) — secondary text, hidden when using the small button size`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Tab Labels (Voice \u0026 Chat mode only):`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Voice Tab Label (default: “Voice”) — rename to match your brand language (e.g., “Call Us”, “Speak”)`}),`\n`,_jsx(_components.li,{children:`Chat Tab Label (default: “Chat”) — rename to match your brand language (e.g., “Message”, “Text”)`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`header-\u0026-modal-tab`,children:`Header \u0026 Modal Tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=a85b0857715f159e0c2c7bf891c6b12b`,alt:`Widget Header \u0026 Modal Tab`,\"data-og-width\":`1014`,width:`1014`,\"data-og-height\":`499`,height:`499`,\"data-path\":`resources/widget-tab-header-modal.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=ef0307e11f69447d36adc656aa37dfb0 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=45a1111ad1924105e46287b7f8354077 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=62920bb06802ec3aa3493968f55d6b65 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=a8f33da4ca5e6448aed9b45379ab6c7d 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=4b8a35fb3383a3c1e809abb4eb220daa 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-header-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=6ff009feb65e3ca8df73c6f436185900 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Header Title`}),` (default: “AI Assistant”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Header Subtitle`}),` (default: “Ready to help you ✨”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Modal Title`}),` (default: “Ready to chat?”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Start Button Text`}),` (default: “Start Voice Chat”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Modal Description`}),` (default: “Click below to start your conversation”)`]}),`\n`,_jsx(Heading,{level:`3`,id:`chat-settings-tab`,children:`Chat Settings Tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=5055056a698a73e8d98944a9a5b29c3a`,alt:`Widget Chat Settings Tab`,\"data-og-width\":`1013`,width:`1013`,\"data-og-height\":`445`,height:`445`,\"data-path\":`resources/widget-tab-chat-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=2c372e23a89d7ae0b1a1b5ae508f9f23 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=d589fd2564e95b70e43fd098b4dd9dd4 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=e6da3116b19cfbc9f1f78db02705eb50 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=23ae07eb63b5af8754fe3707bc8e67c4 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=6547b2599404a6336a4dc41e8c3b9d18 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=d05f14410aaa8ad45870ad3fd9b9738e 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`This tab is only visible when the widget mode includes chat (Chat Only or Voice \u0026 Chat).`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Chat Placeholder`}),` (default: “Type your message…”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Send Button Label`}),` (default: “Send message”) — accessibility label for the send button`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Show Function Calls:`}),` When disabled (default), LLM tool calls (e.g., calendar lookups, knowledge base queries) are hidden from the chat, keeping the conversation clean for end users. Enable to show tool usage details.`]}),`\n`,_jsx(Heading,{level:`3`,id:`clickable-links-in-chat`,children:`Clickable Links in Chat`}),`\n`,_jsxs(_components.p,{children:[`The chat widget supports `,_jsx(_components.strong,{children:`markdown formatting`}),`, so your AI assistant can send clickable links, bold text, lists, and more.`]}),`\n`,_jsx(_components.p,{children:`To include clickable URLs in chat messages, use markdown link format in your assistant’s prompt or initial message:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Check out our [latest offers](https://example.com/offers) or visit our [help center](https://example.com/help).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Add an instruction to your assistant’s prompt like: `,_jsxs(_components.em,{children:[`“When sharing links or URLs, always format them as clickable markdown links: `,_jsx(_components.a,{href:`url`,children:`link text`}),`”`]}),` — this ensures the AI consistently outputs clickable links instead of plain text URLs.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`voice-settings-tab`,children:`Voice Settings Tab`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=203a1d5d5789696fd60bd8a18c9f362c`,alt:`Widget Voice Settings Tab`,\"data-og-width\":`1014`,width:`1014`,\"data-og-height\":`480`,height:`480`,\"data-path\":`resources/widget-tab-voice-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=6723156dbaec694da5c61a72e2396a0b 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=71b4a18007bc4523d95c6937cb8f73f0 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=99753bbfd8ad209ca516ca81926ba775 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=ab04398ca17703411d2a016c8874b72a 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=6d45d5440277c49907b73d98c0a9452b 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-tab-voice-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=ceb7dfd2d5b039ff5334b1962741325d 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`This tab is only visible when the widget mode includes voice (Voice Only or Voice \u0026 Chat).`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Connecting Text`}),` (default: “Connecting…”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Disconnect Text`}),` (default: “Disconnect”)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Error Text`}),` (default: “Connection failed. Please try again.”)`]}),`\n`,_jsx(Heading,{level:`3`,id:`pre-chat-form`,children:`Pre-Chat Form`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=6f128d6e50f45fb071d943b7c7784d05`,alt:`Pre-Chat Form Configuration`,\"data-og-width\":`1017`,width:`1017`,\"data-og-height\":`730`,height:`730`,\"data-path\":`resources/widget-pre-chat-form.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=dab53c4d640f789eef4182189772d2aa 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=e5bba61191e28d2389dcb5a932ed1621 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=ee39a56569736c49c01d99587b02c787 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=2f9d7181a0def4d500a200a62fb7a576 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=ba36dfba173dab8cbe8e1d012a959d2c 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-pre-chat-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=bddbf6248e49515ae4ced353ec011b21 2500w`})}),`\n`,_jsx(_components.p,{children:`Collect information before starting conversations:`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Form Configuration:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Pre-form Title (default: “Before we start…”)`}),`\n`,_jsx(_components.li,{children:`Pre-form Description (default: “Please provide some information to help us assist you better”)`}),`\n`,_jsx(_components.li,{children:`Submit Button Text (default: “Continue”)`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Form Fields:`}),`\nAdd custom fields to collect data:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Variable Name:`}),` Internal variable name (maps to assistant variables). Only letters, numbers, dashes, and underscores allowed.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Field Label:`}),` Display label shown to users`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Field Type:`}),` Text, Email, Phone, or Textarea`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Required:`}),` Make field mandatory`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Placeholder:`}),` Placeholder text shown in the field`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Helper Text:`}),` Optional description below the field`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Variable Mapping:`}),`\nForm field names automatically map to your assistant’s variables, making collected data available during conversations.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example Form Fields:`})}),`\n`,_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Name: Full Name (required, text)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Email: Email Address (required, email)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Company: Company Name (optional, text)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Message: How can we help? (optional, textarea)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`ai-response-settings`,children:`AI Response Settings`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=90dbdc5a9c5562e5ebb571a3d4efa58b`,alt:`Widget AI Response Settings`,\"data-og-width\":`1012`,width:`1012`,\"data-og-height\":`189`,height:`189`,\"data-path\":`resources/widget-ai-response-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=db183a629fa32d20718367496c13b14e 280w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=1aff326465b6597fb07dd77cf7e1f84f 560w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=4ed83d6a1ae8eb4adbd3ced6fff3ae0f 840w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=2d32fc962057a45a01f7c99c26e323f4 1100w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=84509211acd3040e9851965ee0453cdd 1650w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-ai-response-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=72b3209876099d4315e1dd21435de371 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`AI Enabled:`}),` When toggled on (default), the AI assistant automatically responds to incoming messages. Turn this off if you want to use the widget for manual-only conversations — messages are collected but the AI does not reply.`]}),`\n`,_jsx(Heading,{level:`3`,id:`conversation-webhook`,children:`Conversation Webhook`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=fba0d99297ea511bc32fdd8e987cc607`,alt:`Widget Conversation Webhook`,\"data-og-width\":`1011`,width:`1011`,\"data-og-height\":`313`,height:`313`,\"data-path\":`resources/widget-conversation-webhook.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=280\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=109f4233135fb89e69eddf9802ae649c 280w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=560\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=f885df17d532b0c1bb645b6c1beff0d4 560w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=840\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=f4656e6a33e3c15192df3572159007d2 840w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=2dab4e49c9628681204f0e702989b4f7 1100w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=865b1cc6af3986b8b1ce50833a3551ed 1650w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-conversation-webhook.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=39bd0c6f1a408fbd6e76dc7ab1306025 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Webhook URL:`}),` Enter a URL to receive a webhook notification whenever a new conversation starts via the widget. Use this to trigger automation flows, log events to your CRM, or notify your team in real-time.`]}),`\n`,_jsx(Heading,{level:`3`,id:`widget-display`,children:`Widget Display`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=ee1d23405b3777001a6febe19bb9c5ba`,alt:`Widget Display Toggle`,\"data-og-width\":`1016`,width:`1016`,\"data-og-height\":`271`,height:`271`,\"data-path\":`resources/widget-display-toggle.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=280\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=c6301644e6cdd5ef6c95baeed595269f 280w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=560\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=3653c65a4ae403974fdb2013234afb06 560w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=840\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=e3667b4dc64fcf04c0d0f2139dc6ab64 840w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=25f533ea29277b248a57ebb7ebd15aca 1100w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=8ec0f3478d7bead505fcfc021f7e657f 1650w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-display-toggle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=48ee0fcc6844637f2836b80090cd600c 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Enable Widget:`}),` Master toggle that controls whether the widget loads on your website. When disabled, the widget will not appear even if the embed script is installed on your site. Use this to temporarily hide the widget without removing code from your website.`]}),`\n`,_jsx(Heading,{level:`2`,id:`live-widget-preview`,children:`Live Widget Preview`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=0c6433374e4bdeb9b63ae1871df80627`,alt:`Widget Live Preview`,\"data-og-width\":`1013`,width:`1013`,\"data-og-height\":`511`,height:`511`,\"data-path\":`resources/widget-live-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=851e05b5a7f576be659cbbe362b4d918 280w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=d335f6ce83887f205a799068320633cf 560w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=04363c999ecd96fefc64d9799181dd23 840w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=d04236bc28c8b322d3defcbdcb40c953 1100w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=c5cf7572ab2a3fe5d738614275488a84 1650w, https://mintcdn.com/lacyai/GyDjbSP1_licQcSK/resources/widget-live-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GyDjbSP1_licQcSK\u0026q=85\u0026s=a1c1cca17eed1dbb77cec031fc53cff5 2500w`})}),`\n`,_jsx(_components.p,{children:`At the top of the configuration panel, a live preview shows exactly how your widget will look and behave on a website. The preview updates in real-time as you change any setting.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Copy Preview URL`}),` — copies the preview URL to your clipboard so you can open it in a separate browser tab or share it with your team for review.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Reset Data`}),` — clears all stored conversation history, form submissions, and preferences in the preview. Use this to simulate a first-time visitor experience after testing.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The preview is fully interactive — you can click the widget button, fill out the pre-chat form, and start a real conversation to test your configuration before deploying.`})}),`\n`,_jsx(Heading,{level:`3`,id:`embed-code`,children:`Embed Code`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=31dce0f26331f2e413de753e2cec3f49`,alt:`Widget Embed Code`,\"data-og-width\":`1012`,width:`1012`,\"data-og-height\":`270`,height:`270`,\"data-path\":`resources/widget-embed-code.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=280\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=9c5bba783dcb8346751dfd0d6d611e64 280w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=560\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=d760babbf36491b119cc87e3707b6271 560w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=840\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=9c8ff7d84cb799be816785d1b142d5db 840w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=1100\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=044230e3a5046609828d6b4272e5b04a 1100w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=1650\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=8b349628c617d7cb1bb0bac711b83783 1650w, https://mintcdn.com/lacyai/5cPEeFYo82kB7GWs/resources/widget-embed-code.png?w=2500\u0026fit=max\u0026auto=format\u0026n=5cPEeFYo82kB7GWs\u0026q=85\u0026s=53c97c39c1fc2ff4f402518dde23974d 2500w`})}),`\n`,_jsxs(_components.p,{children:[`The embed code section provides a ready-to-copy script tag. Click `,_jsx(_components.strong,{children:`Copy`}),` to copy it to your clipboard, then paste it into your website before the closing `,_jsx(_components.code,{children:`\u003c/body>`}),` tag:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`html`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`html`,children:_jsxs(_components.code,{language:`html`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` src`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.lacy.ai/embed.js\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-assistant-id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-assistant-id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`script`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Save your widget settings `,_jsx(_components.strong,{children:`before`}),` copying the embed code. The script loads all configuration from the server, so any unsaved changes won’t appear on your website.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`installation`,children:`Installation`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Configure and save your widget settings`}),`\n`,_jsxs(_components.li,{children:[`Copy the embed code from the `,_jsx(_components.strong,{children:`Embed Code`}),` section`]}),`\n`,_jsxs(_components.li,{children:[`Paste the script tag before the closing `,_jsx(_components.code,{children:`\u003c/body>`}),` tag on your website`]}),`\n`,_jsx(_components.li,{children:`Visit your website and verify the widget appears in the configured position`}),`\n`,_jsx(_components.li,{children:`Test voice/chat functionality and pre-chat form (if configured)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`widget-behavior`,children:`Widget Behavior`}),`\n`,_jsx(Heading,{level:`3`,id:`first-visit`,children:`First Visit`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Widget button appears in configured position`}),`\n`,_jsx(_components.li,{children:`Click opens modal/chat interface`}),`\n`,_jsx(_components.li,{children:`Pre-chat form displays (if configured)`}),`\n`,_jsx(_components.li,{children:`After form submission, conversation starts`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`return-visits`,children:`Return Visits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Previous conversation state may be restored`}),`\n`,_jsx(_components.li,{children:`Form data remembered (if visitor hasn’t cleared cookies)`}),`\n`,_jsx(_components.li,{children:`Seamless continuation of support experience`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`conversation-tracking`,children:`Conversation Tracking`}),`\n`,_jsxs(_components.p,{children:[`All widget conversations appear in your `,_jsx(_components.a,{href:`/conversations/overview`,children:`Conversations`}),` page for review and analysis.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`HTTPS (SSL certificate) is required for voice functionality. HTTP sites can only use chat mode due to browser security restrictions.`})}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.p,{children:[`For setup and configuration issues, see `,_jsx(_components.a,{href:`/troubleshooting/web-widget`,children:`Web Widget Troubleshooting`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Test widget using the live preview`}),`\n`,_jsx(_components.li,{children:`Embed code on your website`}),`\n`,_jsxs(_components.li,{children:[`Monitor conversations in the `,_jsx(_components.a,{href:`/conversations/overview`,children:`Conversations`}),` page`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Web Widget","icon":"code","description":"Embed your AI assistant on your website with voice and chat capabilities","href":"/ai-assistants/web-widget"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Accessing Widget Configuration","slug":"accessing-widget-configuration","depth":2,"children":[]},{"title":"Widget Modes","slug":"widget-modes","depth":2,"children":[{"title":"Voice \u0026 Chat (Recommended)","slug":"voice-\u0026-chat-recommended","depth":3,"children":[]},{"title":"Chat Only","slug":"chat-only","depth":3,"children":[]},{"title":"Voice Only","slug":"voice-only","depth":3,"children":[]}]},{"title":"Configuration Options","slug":"configuration-options","depth":2,"children":[{"title":"General Tab","slug":"general-tab","depth":3,"children":[]},{"title":"Button Tab","slug":"button-tab","depth":3,"children":[]},{"title":"Header \u0026 Modal Tab","slug":"header-\u0026-modal-tab","depth":3,"children":[]},{"title":"Chat Settings Tab","slug":"chat-settings-tab","depth":3,"children":[]},{"title":"Clickable Links in Chat","slug":"clickable-links-in-chat","depth":3,"children":[]},{"title":"Voice Settings Tab","slug":"voice-settings-tab","depth":3,"children":[]},{"title":"Pre-Chat Form","slug":"pre-chat-form","depth":3,"children":[]},{"title":"AI Response Settings","slug":"ai-response-settings","depth":3,"children":[]},{"title":"Conversation Webhook","slug":"conversation-webhook","depth":3,"children":[]},{"title":"Widget Display","slug":"widget-display","depth":3,"children":[]}]},{"title":"Live Widget Preview","slug":"live-widget-preview","depth":2,"children":[{"title":"Embed Code","slug":"embed-code","depth":3,"children":[]}]},{"title":"Installation","slug":"installation","depth":2,"children":[]},{"title":"Widget Behavior","slug":"widget-behavior","depth":2,"children":[{"title":"First Visit","slug":"first-visit","depth":3,"children":[]},{"title":"Return Visits","slug":"return-visits","depth":3,"children":[]},{"title":"Conversation Tracking","slug":"conversation-tracking","depth":3,"children":[]}]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"lacyai","siteName":"Lacyai Support Docs","title":"Web Widget - Lacyai Support Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-30T09:10:01.418Z","originalFileLocation":"ai-assistants/web-widget.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Embed your AI assistant on your website with voice and chat capabilities\">\u003cmeta data-mint-head name=\"application-name\" content=\"Lacyai Support Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Web Widget - Lacyai Support Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Embed your AI assistant on your website with voice and chat capabilities\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Lacyai Support Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.lacy.ai/ai-assistants/web-widget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lacyai.mintlify.app/_mintlify/api/og/v2?division=AI+Assistants+Overview\u0026amp;title=Web+Widget\u0026amp;description=Embed+your+AI+assistant+on+your+website+with+voice+and+chat+capabilities\u0026amp;theme=0e46719f512feab2eda4211d\u0026amp;signature=3221cc0483ad3566e5268b6a5a356bcff70f968375f245c29b141489ab3b0b3a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Web Widget - Lacyai Support Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Embed your AI assistant on your website with voice and chat capabilities\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lacyai.mintlify.app/_mintlify/api/og/v2?division=AI+Assistants+Overview\u0026amp;title=Web+Widget\u0026amp;description=Embed+your+AI+assistant+on+your+website+with+voice+and+chat+capabilities\u0026amp;theme=0e46719f512feab2eda4211d\u0026amp;signature=3221cc0483ad3566e5268b6a5a356bcff70f968375f245c29b141489ab3b0b3a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lacyai/CfGrFf5mfoTZaovQ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Lacyai Support Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007BFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.lacy.ai/ai-assistants/web-widget\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ai-assistants/web-widget.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.lacy.ai/#organization\",\"name\":\"Lacyai Support Docs\",\"url\":\"https://docs.lacy.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lacyai/XShP4J2TcCKez9X5/logo.png?fit=max\u0026auto=format\u0026n=XShP4J2TcCKez9X5\u0026q=85\u0026s=09c7e2269ffc3d1d20220997a5184179\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.lacy.ai#website\",\"name\":\"Lacyai Support Docs\",\"url\":\"https://docs.lacy.ai\",\"publisher\":{\"@id\":\"https://docs.lacy.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.lacy.ai/ai-assistants/web-widget#webpage\",\"url\":\"https://docs.lacy.ai/ai-assistants/web-widget\",\"name\":\"Web Widget\",\"description\":\"Embed your AI assistant on your website with voice and chat capabilities\",\"dateModified\":\"2026-04-30T09:10:01.418Z\",\"isPartOf\":{\"@id\":\"https://docs.lacy.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.lacy.ai/ai-assistants/web-widget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.lacy.ai/ai-assistants/web-widget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Assistants Overview\",\"item\":\"https://docs.lacy.ai/ai-assistants/what-is-ai-assistant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Widget\",\"item\":\"https://docs.lacy.ai/ai-assistants/web-widget\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.lacy.ai/ai-assistants/web-widget#article\",\"headline\":\"Web Widget\",\"name\":\"Web Widget\",\"description\":\"Embed your AI assistant on your website with voice and chat capabilities\",\"url\":\"https://docs.lacy.ai/ai-assistants/web-widget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.lacy.ai/ai-assistants/web-widget#webpage\"},\"dateModified\":\"2026-04-30T09:10:01.418Z\",\"publisher\":{\"@id\":\"https://docs.lacy.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.lacy.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Lacyai Support Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Lacyai Support Docs","nav":{"global":null,"groups":[{"group":"Platform Guide","pages":[{"title":"What is Lacy.ai?","icon":"circle-question","href":"/introduction/what-is-lacy"},{"title":"How It Works (Quick Overview)","icon":"diagram-project","href":"/introduction/how-it-works"},{"title":"Key Terminology","icon":"book","href":"/introduction/key-terminology"}]},{"group":"Getting Started","pages":[{"title":"Core Concepts","icon":"lightbulb","href":"/getting-started/core-concepts"},{"title":"Understanding Call Minutes \u0026 Billing","icon":"credit-card","href":"/getting-started/understanding-billing"}]},{"group":"AI Assistants Overview","pages":[{"title":"What is an AI Assistant?","icon":"robot","href":"/ai-assistants/what-is-ai-assistant"},{"title":"System Prompts","icon":"brain","href":"/ai-assistants/system-prompt"},{"title":"Initial Message \u0026 Audio","icon":"message-dots","href":"/ai-assistants/initial-message"},{"title":"Creating and Editing an AI Assistant","icon":"pen-to-square","href":"/ai-assistants/creating-and-editing"},{"title":"Tools \u0026 Functions","icon":"screwdriver-wrench","href":"/ai-assistants/tools-and-functions"},{"title":"Voice Selection \u0026 Voice Cloning","icon":"microphone","href":"/ai-assistants/voice-selection"},{"title":"Filler Audio","icon":"volume","href":"/ai-assistants/filler-audio"},{"title":"Cal.com Appointment Scheduling","icon":"calendar-days","href":"/ai-assistants/cal-com-scheduling"},{"title":"Testing Your Assistant","icon":"vial","href":"/ai-assistants/testing"},{"title":"Assistant best practices","icon":"sliders","href":"/ai-assistants/assistant-configuration"},{"title":"Assistant Modes","icon":"wave-pulse","href":"/ai-assistants/assistant-modes"},{"title":"AI Prompt Editor","icon":"sparkles","href":"/ai-assistants/ai-prompt-editor"},{"title":"Custom Mid-Call Tools","icon":"code-branch","href":"/ai-assistants/custom-tools"},{"title":"Flow Builder","icon":"share-nodes","href":"/ai-assistants/flow-builder"},{"title":"Test Chat Interface","icon":"comment-dots","description":"Test your assistant with a text-based chat interface for rapid iteration","href":"/ai-assistants/test-chat"},{"title":"Web Widget","icon":"code","href":"/ai-assistants/web-widget"}]},{"group":"Phone Numbers","pages":[{"title":"Types of Phone Numbers","icon":"phone","description":"Learn about the different types of phone numbers you can use with Lacy.ai: dedicated numbers, SIP integration, and Caller ID","href":"/phone-numbers/types"},{"title":"Purchasing \u0026 Managing Numbers","icon":"phone-plus","href":"/phone-numbers/purchasing-and-managing"},{"title":"Pricing \u0026 Regions","icon":"money-bill","href":"/phone-numbers/pricing-and-regions"},{"title":"SMS Capabilities","icon":"message-sms","href":"/phone-numbers/sms-capabilities"},{"title":"Assigning Numbers to Assistants","icon":"link","href":"/phone-numbers/assigning-to-assistants"}]},{"group":"Inbound Calls","pages":[{"title":"Inbound Calls Overview","icon":"phone-arrow-down-left","href":"/inbound-calls/overview"},{"title":"Provisioning \u0026 Managing Phone Numbers","icon":"phone-plus","href":"/inbound-calls/provisioning"},{"title":"Configuring the Inbound Assistant","icon":"sliders","href":"/inbound-calls/configuring"},{"title":"Inbound Call Insights","icon":"chart-line","href":"/inbound-calls/insights"}]},{"group":"Outbound Calls","pages":[{"title":"Outbound Calls Overview","icon":"phone-arrow-up-right","href":"/outbound-calls/overview"},{"title":"Creating \u0026 Managing Campaigns","icon":"bullhorn","href":"/outbound-calls/campaigns"},{"title":"Caller ID \u0026 Handling","icon":"id-card","href":"/outbound-calls/caller-id"},{"title":"Voicemail Handling","icon":"voicemail","href":"/outbound-calls/voicemail-handling"},{"title":"Scripts \u0026 Prompts for Sales or Collections","icon":"file-lines","href":"/outbound-calls/scripts-and-prompts"},{"title":"Mass/Parallel Dialing","icon":"phone-volume","href":"/outbound-calls/mass-dialing"}]},{"group":"Campaigns","pages":[{"title":"Campaigns Overview","icon":"bullhorn","href":"/campaigns/index"},{"title":"Creating a Campaign","icon":"plus","href":"/campaigns/creating-campaigns"}]},{"group":"Conversations","pages":[{"title":"Conversations Overview","icon":"messages","href":"/conversations/overview"},{"title":"Viewing \u0026 Managing Conversations","icon":"list-check","href":"/conversations/viewing-and-managing"}]},{"group":"Leads","pages":[{"title":"Leads Overview","icon":"users","href":"/leads/index"},{"title":"Importing Leads","icon":"file-import","href":"/leads/importing-leads"},{"title":"Managing Leads","icon":"user-gear","href":"/leads/managing-leads"}]},{"group":"AI Prompting \u0026 Conversation Design","pages":[{"title":"Prompt Writing Basics","icon":"pen-nib","href":"/conversation-design/prompt-basics"},{"title":"Inserting Knowledge Bases","icon":"database","href":"/conversation-design/knowledge-bases"},{"title":"Handling Interruptions \u0026 Speech Sensitivity","icon":"hand","href":"/conversation-design/interruptions"},{"title":"Language \u0026 Accent Support","icon":"language","href":"/conversation-design/language-support"}]},{"group":"Automation \u0026 Integrations","pages":[{"title":"Introduction","href":"/automation-platform/introduction"},{"title":"Overview of No-Code Automation","icon":"wand-magic-sparkles","href":"/automation/overview"},{"title":"Webhook \u0026 API","icon":"code","href":"/automation/webhook-api"},{"title":"Phone System Integrations","icon":"phone-office","href":"/automation/phone-system"}]},{"group":"Custom Dashboards","pages":[{"title":"Custom Dashboards","icon":"chart-line","href":"/custom-dashboards/overview"},{"title":"Widget Configuration","icon":"sliders","href":"/custom-dashboards/widget-types"}]},{"group":"WhatsApp","pages":[{"title":"WhatsApp Business Integration","icon":"whatsapp","href":"/whatsapp/overview"},{"title":"WhatsApp Senders","icon":"phone","href":"/whatsapp/senders"},{"title":"Message Templates","icon":"file-lines","href":"/whatsapp/templates"},{"title":"WhatsApp Conversations","icon":"messages","href":"/whatsapp/conversations"},{"title":"WhatsApp Automation","icon":"bolt","href":"/whatsapp/automation"}]},{"group":"Costs \u0026 Pricing","pages":[{"title":"Cost Overview","icon":"dollar-sign","href":"/pricing/overview"},{"title":"Pricing Breakdown","icon":"calculator","href":"/pricing/usage-based"},{"title":"Number Rentals \u0026 International Rates","icon":"globe","href":"/pricing/number-rentals"}]},{"group":"Number Provisioning","pages":[{"title":"Supported Countries","icon":"globe","href":"/provisioning/supported-countries"},{"title":"Managing Your Numbers","icon":"list-check","href":"/provisioning/managing-numbers"},{"title":"SIP Integration","icon":"phone-volume","href":"/provisioning/sip-integration"},{"title":"DIDLogic Integration","href":"/provisioning/sip-trunking/didlogic"},{"title":"Twilio Integration","href":"/provisioning/sip-trunking/twilio"},{"title":"Zadarma Integration","href":"/provisioning/sip-trunking/zadarma"}]},{"group":"Settings","pages":[{"title":"Data Retention","icon":"clock-rotate-left","href":"/settings/data-retention"}]},{"group":"Troubleshooting \u0026 FAQs","pages":[{"title":"Voice \u0026 Response Issues","icon":"microphone","href":"/troubleshooting/voice-problems"},{"title":"Billing \u0026 Credits","icon":"money-bill","href":"/troubleshooting/billing"},{"title":"Call Quality Issues","icon":"phone","href":"/troubleshooting/call-quality"},{"title":"AI Behavior Issues","icon":"robot","href":"/troubleshooting/ai-behavior"},{"title":"Cal.com Issues","icon":"calendar-days","href":"/troubleshooting/cal-com"},{"title":"Calendly Issues","icon":"calendar-days","href":"/troubleshooting/calendly"},{"title":"Campaign Issues","icon":"wrench","href":"/troubleshooting/campaigns"},{"title":"GoHighLevel Issues","icon":"calendar-days","href":"/troubleshooting/gohighlevel"},{"title":"Leads Issues","icon":"user-gear","href":"/troubleshooting/leads"},{"title":"SIP Integration Issues","icon":"phone-volume","href":"/troubleshooting/sip-integration"},{"title":"Web Widget Issues","icon":"code","href":"/troubleshooting/web-widget"},{"title":"WhatsApp Troubleshooting","icon":"circle-question","href":"/troubleshooting/whatsapp"}]},{"group":"API Reference","pages":[{"title":"Introduction","icon":"book-open","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"List campaigns","api":"GET /user/campaigns","icon":"list","href":"/api-reference/campaigns/index"},{"title":"Create lead","api":"POST /user/lead","icon":"user-plus","href":"/api-reference/leads/create"},{"title":"Create assistant","api":"POST /user/assistant","href":"/api-reference/assistants/create-assistant"},{"title":"List assistants","api":"GET /user/assistants/get","href":"/api-reference/assistants/get-assistants"},{"title":"List calls","api":"GET /user/calls","href":"/api-reference/calls/get-calls"},{"title":"List Conversations","api":"GET /user/conversations","href":"/api-reference/conversations/list-conversations"},{"title":"Send SMS","api":"POST /user/sms","href":"/api-reference/sms/send-sms"},{"title":"Get current user","api":"GET /user/me","href":"/api-reference/user/me"}]}]},"basePath":"","title":"Web Widget - Lacyai Support Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DW6UFrUy.js","DynamicMarkdown-B62XqCSI.js","zoom-image-lightbox-eHyQ0tlO.js","lightbox-handle-r17bVUz3.js"]}
