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":"cloudone-ai.com","colors":{"primary":"#0188c4","light":"#0188c4","dark":"#0188c4"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/tel-one/37XKTsbawt90AU8w/resources/logo/light.png?fit=max\u0026auto=format\u0026n=37XKTsbawt90AU8w\u0026q=85\u0026s=ce7aceae375292ccbf29754e4eeb2d4e","dark":"https://mintcdn.com/tel-one/37XKTsbawt90AU8w/resources/logo/dark.png?fit=max\u0026auto=format\u0026n=37XKTsbawt90AU8w\u0026q=85\u0026s=ad0ab8165e1652b306c0567c039357ac"},"api":{"mdx":{"server":"https://app.cloudone-ai.com/api/","auth":{"method":"bearer","name":null}}},"navbar":{"links":[{"label":"Home","href":"https://cloudone-ai.com"},{"label":"Support","href":"https://support.tel-one.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cloudone-ai.com"}},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tel-one","hasAudioNarration":false,"actualSubdomain":"tel-one","customDomains":["docs.cloudone-ai.com"],"gitSource":{"type":"github","owner":"cloudai3030","repo":"cloudone-ai-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21ebc7322a7286e3169f48","collectionId":"08bbe09f-b398-4998-843b-309517030e39","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae948bc3da74a958a8f65c7:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Platform Guide","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"AI Assistants Overview","count":20},{"language":"default","tag":"Assistants","count":16},{"language":"default","tag":"Troubleshooting \u0026 FAQs","count":12},{"language":"default","tag":"Knowledgebases","count":10},{"language":"default","tag":"Phone Numbers","count":9},{"language":"default","tag":"No-Code Automation","count":9},{"language":"default","tag":"Leads","count":7},{"language":"default","tag":"Conversations","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"rbac-expansion","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":"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":"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},{"name":"turbopuffer-serve","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/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f0fa1183d7080d62a2986c6db39ae70b`,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/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=1a898078e9e892a85ab40736bc827ab6 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=408da006a233d7b8cdef729373657806 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=10510aafa8d62e677bb14b7e7c4209da 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=1ff29fa2ac0b3ddb8b04d17816344132 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=a13174a9e4f7b4ad5712f767b62a690d 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/web-widget-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f11b6dc08b15ba9547fa8b2d9db21961 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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=ba67f43d4a32ba75f25a3f5823008209`,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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=280\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=7f5e5c8b7410aeb484c0f43b23148641 280w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=560\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=76f94012d9de0102bc1fa7278ac33f35 560w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=840\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=ff13581f6fa50f1dad00920cbd343246 840w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=1100\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=08acbc1cedfb2ece0ef4acaad6314f73 1100w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=1650\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=e05174273b4b9d3d6194ffa190707ae8 1650w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-general.png?w=2500\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=b3dae2ea3aa3ecd12a871cc091dd9a00 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=c599a1359d08a092f0f9f7a2d591a57e`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=89e0a2cbadfd401c51613301fc5d3edf 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=17674aeca0008fda9b900b20224806ce 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=fb325e3b52e5e5c6489b7e7d9add7084 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=e98f68c8cdc4f2990101c8f60bf9ad37 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=a2555ec14957d8bc1d8e824d2f6de6e4 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=cd295bc4a9d34a89cb163642a84bc49f 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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=1479eab0f46a51f695616069ecc5d093`,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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=9148b04b9b87f32c406f93f25c0928f7 280w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=029d441fa7037e2c931e724d7acbab91 560w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=7b8b913ec1c3068c89077c747808b341 840w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=f2f533ac0794903369f4cae6d20b7199 1100w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=d3469069e2e205fbd2bb180c43a86d30 1650w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-header-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=f40649bbe227471fccb2ca8dc8c7f49e 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=72cff25aff8a4f89ba335bb04b10cd30`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=62cbd7193952a45abe59d6aef35bf3d7 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=7c26df15527111ba6113349dc59c4105 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=c0ee29879d35ff93222801f37c024dda 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=0f31a0560e56e03b5bd1c42e662c156b 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=b424c3f4ffb783d03ed80cb92a45f03c 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-tab-chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=16ca66bf500b478badbe9b5711a8cc75 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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=345f7957ab46537003a4f61f679012f4`,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/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=a4535df68575299c8f836cfbfaf62fcf 280w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=8c96d6f2a7ce1d7722f83698985ef291 560w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=1383c1127993536e42ba715e13009cd6 840w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=6b3a8dfec252ba1768565a8807a7594c 1100w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=91c6d55231bbef7d19b6b7be3f008fa6 1650w, https://mintcdn.com/tel-one/PnsNc4g5jNTxQ__A/resources/widget-tab-voice-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=PnsNc4g5jNTxQ__A\u0026q=85\u0026s=d3c041d263124c5bf01bed880a135db5 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=6febf6b8646cd594d6ae38c8fcf87fa1`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=79266a9503e68e45b2f19584fb808298 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=fe1de0b0c73e144803d54d4f7e292604 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=2fad566de1c03ea17b0b6bcd1060a503 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=c98df9a33f6e39435c364d82d9356a1d 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f3c3f674fe1b6440562954c1f797ffcb 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-pre-chat-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=4647b4a485e5631ee920470e5b41c558 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=1de75eb3d6080a1462504a24c219f660`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=4f0ac75104803f76bff661defee01cfc 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=48f62de6142b2e5cbadfada1619364ee 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=c5abb99e8d73537468a4dafa14c59791 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=1c591e844a997019161c53f784f47acf 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=2dd4aeebc570989a40e306e428510ef5 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-ai-response-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=946e294b7196775dda5446008ba31c64 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=7e8e0a378577e4a0da3e23b9ce97e9bf`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=530c7e3d3755061fcfece482b1fe0fde 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f4fdcf3cd5ef4859a846ba616664f2ac 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=5c2d34ff414e75786d13f588429390fb 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=e2bb1d1e1e53efe0d96273efb43dcaac 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=b92f4423d966bdde4d16920b6a3f4acb 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-conversation-webhook.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=05791ba798522c87f4b28f2436a832ee 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=ff588ee0948f30774e9f7607ba7dd309`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f0f5459d69d83fe7b49adb657d5bacc5 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=99f519d5ccf3c8fa3a6da4c18e1e073a 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=3690435b90d4b1305f1c9643a96aa941 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=16650d6cf999d7e1eb12541a3e22f185 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=892ba13e9a46402719818381f18426ab 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-display-toggle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=9b54e18ccd2b7b88692a83269691c32c 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=0c276597098d8daace1283941dcd9df2`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=df7e324e0c5753ee6c39cddfb3ebf63e 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=f5082b7a4e53def92f616ea0a2f7a499 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=3eb80743f8fc2b74b4e807e54c66f704 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=592e37088740d4a629a3daa22488f056 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=409812a2d465a352246e5284ab3c00e6 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-live-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=c67bd3869661e08b8e27efe53c08b77a 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/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=ba38b5a0b624d7d2524060f65bed1268`,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/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=280\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=117fc126a92caf88060426840b8aedd2 280w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=560\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=10484efce0cda9af6ff8541727fd0b27 560w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=840\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=0d4c1ffed70b7828e42cba941335061b 840w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=0b1a481cd96bd9070e4392bca5d88527 1100w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=054a2e4a17d1aff625ab101a483e448e 1650w, https://mintcdn.com/tel-one/NZU3ntzAvedXFcmT/resources/widget-embed-code.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NZU3ntzAvedXFcmT\u0026q=85\u0026s=74ef064592038d943a9be7aae15bb345 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.cloudone-ai.com/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":"tel-one","siteName":"cloudone-ai.com","title":"Web Widget - cloudone-ai.com","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-26T15:00:34.189Z","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=\"cloudone-ai.com\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_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/tel-one/YfXgIx6j98bLU3eU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Web Widget - cloudone-ai.com\">\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=\"cloudone-ai.com\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloudone-ai.com/ai-assistants/web-widget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tel-one.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=ad1a80dda0e29b51c4e9e861\u0026amp;signature=1be9338e2e3e6c2418e01c2a64e81d20f43bc671f13af69a38184575063bf23c\">\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 - cloudone-ai.com\">\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://tel-one.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=ad1a80dda0e29b51c4e9e861\u0026amp;signature=1be9338e2e3e6c2418e01c2a64e81d20f43bc671f13af69a38184575063bf23c\">\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/tel-one/YfXgIx6j98bLU3eU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"cloudone-ai.com\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0188c4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloudone-ai.com/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.cloudone-ai.com/#organization\",\"name\":\"cloudone-ai.com\",\"url\":\"https://docs.cloudone-ai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tel-one/37XKTsbawt90AU8w/resources/logo/light.png?fit=max\u0026auto=format\u0026n=37XKTsbawt90AU8w\u0026q=85\u0026s=ce7aceae375292ccbf29754e4eeb2d4e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloudone-ai.com#website\",\"name\":\"cloudone-ai.com\",\"url\":\"https://docs.cloudone-ai.com\",\"publisher\":{\"@id\":\"https://docs.cloudone-ai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget#webpage\",\"url\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget\",\"name\":\"Web Widget\",\"description\":\"Embed your AI assistant on your website with voice and chat capabilities\",\"dateModified\":\"2026-03-26T15:00:34.189Z\",\"isPartOf\":{\"@id\":\"https://docs.cloudone-ai.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Assistants Overview\",\"item\":\"https://docs.cloudone-ai.com/ai-assistants/what-is-ai-assistant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Widget\",\"item\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloudone-ai.com/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.cloudone-ai.com/ai-assistants/web-widget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloudone-ai.com/ai-assistants/web-widget#webpage\"},\"dateModified\":\"2026-03-26T15:00:34.189Z\",\"publisher\":{\"@id\":\"https://docs.cloudone-ai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloudone-ai.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"cloudone-ai.com\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"cloudone-ai.com","nav":{"global":null,"anchors":[{"anchor":"Platform Guide","icon":"book","groups":[{"group":"Introduction","pages":[{"title":"What is cloudone-ai.com?","icon":"circle-question","href":"/introduction/what-is-platform"},{"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"},{"group":"Creating and Editing an AI Assistant","icon":"robot","pages":[{"title":"General Settings","icon":"gear","href":"/ai-assistants/settings/general"},{"title":"Prompt \u0026 Tools","icon":"wrench","href":"/ai-assistants/settings/prompt-and-tools"},{"title":"Post-call Actions","icon":"webhook","href":"/ai-assistants/settings/post-call-actions"}]},{"title":"Assistant Modes","icon":"wave-pulse","href":"/ai-assistants/assistant-modes"},{"title":"Assistant best practices","icon":"sliders","href":"/ai-assistants/assistant-configuration"},{"title":"System Prompts","icon":"brain","href":"/ai-assistants/system-prompt"},{"title":"AI Prompt Editor","icon":"sparkles","href":"/ai-assistants/ai-prompt-editor"},{"title":"Flow Builder","icon":"share-nodes","href":"/ai-assistants/flow-builder"},{"title":"Initial Message \u0026 Audio","icon":"message-dots","href":"/ai-assistants/initial-message"},{"title":"Tools \u0026 Functions","icon":"screwdriver-wrench","href":"/ai-assistants/tools-and-functions"},{"title":"Custom Mid-Call Tools","icon":"code-branch","href":"/ai-assistants/custom-tools"},{"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":"Calendly Appointment Scheduling","icon":"calendar-days","href":"/ai-assistants/calendly-scheduling"},{"title":"GoHighLevel Appointment Scheduling","icon":"calendar-plus","href":"/ai-assistants/gohighlevel-scheduling"},{"title":"Testing Your Assistant","icon":"vial","href":"/ai-assistants/testing"},{"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":"Campaigns","icon":"bullhorn","pages":[{"title":"Campaigns Overview","icon":"bullhorn","description":"Learn how to create and manage automated calling campaigns to reach multiple leads efficiently","href":"/campaigns/index"},{"title":"Creating a Campaign","icon":"plus","href":"/campaigns/creating-campaigns"}]},{"group":"Leads","icon":"users","pages":[{"title":"Leads Overview","icon":"users","href":"/leads/index"},{"title":"Managing Leads","icon":"user-gear","href":"/leads/managing-leads"},{"title":"Importing Leads","icon":"file-import","href":"/leads/importing-leads"}]},{"group":"Custom Dashboards","icon":"chart-line","pages":[{"title":"Custom Dashboards","icon":"chart-line","href":"/custom-dashboards/overview"},{"title":"Widget Configuration","icon":"sliders","href":"/custom-dashboards/widget-types"}]},{"group":"Conversations","icon":"messages","pages":[{"title":"Conversations Overview","icon":"messages","href":"/conversations/overview"},{"title":"Viewing \u0026 Managing Conversations","icon":"list-check","href":"/conversations/viewing-and-managing"}]},{"group":"WhatsApp Business","icon":"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":"Phone Numbers","pages":[{"title":"Types of Phone Numbers","icon":"phone","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":"AI Prompting \u0026 Conversation Design","pages":[{"title":"Prompt Writing Basics","icon":"pen-nib","href":"/conversation-design/prompt-basics"},{"title":"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":"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":"/provisioning/phone-system-integrations"}]},{"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"},{"group":"SIP trunking","icon":"phone-volume","pages":[{"title":"Overview","href":"/provisioning/sip-trunking/sip-integration"},{"title":"Twilio Integration","href":"/provisioning/sip-trunking/twilio"},{"title":"Zadarma Integration","href":"/provisioning/sip-trunking/zadarma"},{"title":"DIDLogic Integration","href":"/provisioning/sip-trunking/didlogic"}]}]},{"group":"Settings","pages":[{"title":"Data Retention","icon":"clock-rotate-left","href":"/settings/data-retention"}]},{"group":"Troubleshooting \u0026 FAQs","pages":[{"title":"AI Behavior Issues","icon":"robot","href":"/troubleshooting/ai-behavior"},{"title":"Billing \u0026 Credits","icon":"money-bill","href":"/troubleshooting/billing"},{"title":"Cal.com Issues","icon":"calendar-days","href":"/troubleshooting/cal-com"},{"title":"Calendly Issues","icon":"calendar-days","href":"/troubleshooting/calendly"},{"title":"Call Quality Issues","icon":"phone","href":"/troubleshooting/call-quality"},{"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":"Voice \u0026 Response Issues","icon":"microphone","href":"/troubleshooting/voice-problems"},{"title":"Web Widget Issues","icon":"code","href":"/troubleshooting/web-widget"},{"title":"WhatsApp Troubleshooting","icon":"circle-question","href":"/troubleshooting/whatsapp"}]}]},{"anchor":"No-Code Automation","icon":"wand-magic-sparkles","color":{"light":"#6c63ff","dark":"#6c63ff"},"pages":[{"title":"No-Code Automation","href":"/automation-platform/introduction"}]},{"anchor":"API Reference","icon":"code","color":{"light":"#1c51fc","dark":"#1c51fc"},"pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"anchor":"Platform updates","icon":"scroll","color":{"light":"#ffbb00","dark":"#ffbb00"},"pages":[{"title":"Platform updates","href":"/releases"}]}]},"basePath":"","title":"Web Widget - cloudone-ai.com","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BdiBGm0H.js","DynamicMarkdown-CbqEDjbV.js","zoom-image-lightbox-CvtNkYOX.js","lightbox-handle-r17bVUz3.js"]}
