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](url)” — 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":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Soara","colors":{"primary":"#A620F8","light":"#A620F8","dark":"#7D13C2"},"logo":{"light":"https://mintcdn.com/soara/N4BA4io9wFicEjvG/resources/logo/light.png?fit=max\u0026auto=format\u0026n=N4BA4io9wFicEjvG\u0026q=85\u0026s=b4b1112604554912f7c8b98b31860bd2","dark":"https://mintcdn.com/soara/N4BA4io9wFicEjvG/resources/logo/dark.png?fit=max\u0026auto=format\u0026n=N4BA4io9wFicEjvG\u0026q=85\u0026s=7f680c910d802a94c92964bc4da9b75e"},"favicon":"https://mintcdn.com/soara/N4BA4io9wFicEjvG/favicon.png?fit=max\u0026auto=format\u0026n=N4BA4io9wFicEjvG\u0026q=85\u0026s=ae03f2acd6e67cf86869531bcc1378f3","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://app.soara.ai/api/"}},"navbar":{"links":[{"href":"https://soara.ai","label":"Home"},{"href":"https://soara.ai/contact","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.soara.ai"}},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"soara","hasAudioNarration":false,"actualSubdomain":"soara","customDomains":["docs.soara.ai"],"gitSource":{"type":"github","owner":"soaraadmin-bit","repo":"soara-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21de415ff9f1e2c50d39fd","collectionId":"3d48c452-bf3c-4a80-ab72-338b207c4f4e","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21de415ff9f1e2c50d39fd:success","clientVersion":"0.0.3990","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":"No-Code Automation","count":10},{"language":"default","tag":"Phone Numbers","count":9},{"language":"default","tag":"Leads","count":7},{"language":"default","tag":"No-Code Automation platform","count":7}]},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":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/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=c5a5d79efdc50c5a03db8f6340888c63`,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/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=b052079f80c10620806c7a33ae38e208 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=898176972e83354c406fd98c23fbd17c 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=7543163cf34d2c1bffe1d5d2a52e09d5 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=2e6028ecff61fadf77c44d1d084c05a3 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=2987e7f15afc228c75908e8da6ff3fba 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/web-widget-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=a30914406ba1f21928576e214b208b8d 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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=041521bf653307ef6d7493668e1c6cc7`,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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=280\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=0c6b356f1a91863ac554c998e49ee583 280w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=560\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=f1f53ceb8560561092e4efbcaefcacea 560w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=840\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=ef58763c899e4e3bdefbe0afa02e3ba3 840w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=d6a66abe312b73622fffc9915c0a871b 1100w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=fc2d71e86cfedf253876d10435586201 1650w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-general.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=ff5025a2c33175eb00a7eafc4f9747b5 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/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=ac7a9fc5c6fabdfd6d774fefaff525e2`,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/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=1f4060d4c026952195f7391981b56eec 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=91ab8224cbf99822cc65aa09bc67f7b7 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=10245087ffc11aa3e1b4853de7c399aa 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=60fdc7f8aebead639789c7063694bc26 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=f12341ffa87d9a1597c48f88c5e94137 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=10d3526fa2cd3d748c29b92df910f98d 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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=7ff977616fd15e76334273e824ba16b0`,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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=fcc9e2f80f65e52c1c6e16972146dac4 280w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=d03e7f667fb428a8d836af6abd33270a 560w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=9a7dd65b8d64bc28dd403adc701faabc 840w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=c5b6ef07815672888cd7e974113ed947 1100w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=82768a99e3336155fae51f6980b64c6c 1650w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-header-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=6c134546e13357bcbccc830a9c094574 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/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=db33df5e46255dd8289a2691f00d32b7`,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/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=a25736bbef5ac56108d963a8f3847d5d 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=2affb4c9188db0d3dc9c29e2bb88b015 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=dd0118c389ce87f9b73d78e7cfd986b7 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=5bce36f83fd97a6037d3b75f8e74adf2 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=e558a434d6521fd56473c5d426414c42 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-tab-chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=2cc242ee61dc57345db56f755abd027d 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.code,{children:`[link text](url)`}),`”`]}),` — 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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=be3d82e6aad00489a24edd21e663cc10`,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/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=4e28d77202d4c95730d6c61f34e9bcee 280w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=b20302ab1287646f4beb77153e119935 560w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=640e38664ccbc488f0315d96ff84db79 840w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=d92614058058bb2f0e3c1640051f3d6d 1100w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=8cf71c79506001b6a95c17653b56aacc 1650w, https://mintcdn.com/soara/hCbO27aoIUgpF8RF/resources/widget-tab-voice-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hCbO27aoIUgpF8RF\u0026q=85\u0026s=f9f6590f9afb712073ff9399243ce5e9 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/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=e4cf6fb621947fc1f07c3fed10797944`,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/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=f47cb9a581bb0fdd0f5e82164954bd85 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=45eeb74e185623cc81bee0da61b1d182 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=e4f217bc0beb308ef7010866a7a11a5c 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=f48aa7abc06d03270e3107fe68efd3e6 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=b70dc4d5ac91bdafc05ca93638c3be77 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-pre-chat-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=d2d5d83bc4b76cc86b8f563271b1d59c 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/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=1fa463ee064e3223013d6de8223f3517`,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/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=b57c991d2a30f2210ce38ae1e16c9f10 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=56d5c1bb8ac3f9d45638d1fc77fb2f9b 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=6723162e4662af58d6b5635643725b8d 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=34d06feec4f7430a68ba2d42e997232f 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=6d737c1ed6b465d2e6317b44ae55ad6f 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-ai-response-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=6c39184560361f59c0c71ff53cc8f6a1 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/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=5801ce4993fff833044d8f7b33d0085a`,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/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=73034bee143532ac650f4592eae905b1 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=58bd0a3f60ccb850efd867f2328109ac 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=b1400116643cebdf66bf55c30e246f67 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=52786a6736fd7f8921f519e23697d00b 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=1d03a173d82a1ba62e818649438882fb 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-conversation-webhook.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=b6c12be57127ed08fc656cabf6077b04 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/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=fddc48244c3d463c8df0472e4ef50e52`,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/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=87423d4ec0cba9d229eb59f6129dbd88 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=8a1c94a4b1bcb59d973f7c97cddae90b 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=8f409eef88aab7f7e9c981a5127bbd3d 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=c0490e9afc6688751b841a7c455f988b 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=bf45df6d7839a06fe58f696ae9618a27 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-display-toggle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=6a6de5da79879d0bb45cdbfc2909c433 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/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=298ed74fc5b388ba2e955de48f4b42ed`,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/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=e06a64930d27b60a5fad7586d1523a47 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=f5ea019f1908415e5eca8fbc05db236c 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=223b5e668de2037e95e840f1bf4cdff2 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=93718ea8d5835bff90c2b0888a2ef002 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=986675bedc71c46247da39393f939d75 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-live-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=676ac61eade6ae5b479a80a3019bb9e4 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/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=32e2053c63d5862e7db27ff8b985648c`,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/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=280\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=0790ccae32e5f2b3954dbc89fbe7210b 280w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=560\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=099f093cbfc91ccc7f8392412ff2ade8 560w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=840\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=e0528b3c73ea69db112c2ea4cb61d528 840w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=1100\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=2a154ffbbd545df16d343135889366e5 1100w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=1650\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=4a4daa575ec67045845a497e10ede939 1650w, https://mintcdn.com/soara/eiUo2QCto6gZgf6H/resources/widget-embed-code.png?w=2500\u0026fit=max\u0026auto=format\u0026n=eiUo2QCto6gZgf6H\u0026q=85\u0026s=39ba7e0aa0cd4abe9cd287965c19abb9 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.soara.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":"soara","siteName":"Soara","title":"Web Widget - Soara","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-25T18:00:03.836Z","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=\"Soara\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_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/soara/sEANYR8HiJJ7Bce1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Web Widget - Soara\">\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=\"Soara\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.soara.ai/ai-assistants/web-widget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://soara.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=a59553b1d388ab18346b9f01\u0026amp;signature=f4521db3917fb7f8ce9cdc561d77a71df55947e54c1155fd9779ac44b9e82672\">\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 - Soara\">\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://soara.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=a59553b1d388ab18346b9f01\u0026amp;signature=f4521db3917fb7f8ce9cdc561d77a71df55947e54c1155fd9779ac44b9e82672\">\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/soara/sEANYR8HiJJ7Bce1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Soara\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A620F8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.soara.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.soara.ai/#organization\",\"name\":\"Soara\",\"url\":\"https://docs.soara.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/soara/N4BA4io9wFicEjvG/resources/logo/light.png?fit=max\u0026auto=format\u0026n=N4BA4io9wFicEjvG\u0026q=85\u0026s=b4b1112604554912f7c8b98b31860bd2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.soara.ai#website\",\"name\":\"Soara\",\"url\":\"https://docs.soara.ai\",\"publisher\":{\"@id\":\"https://docs.soara.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.soara.ai/ai-assistants/web-widget#webpage\",\"url\":\"https://docs.soara.ai/ai-assistants/web-widget\",\"name\":\"Web Widget\",\"description\":\"Embed your AI assistant on your website with voice and chat capabilities\",\"dateModified\":\"2026-05-25T18:00:03.836Z\",\"isPartOf\":{\"@id\":\"https://docs.soara.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.soara.ai/ai-assistants/web-widget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.soara.ai/ai-assistants/web-widget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Assistants Overview\",\"item\":\"https://docs.soara.ai/ai-assistants/what-is-ai-assistant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Widget\",\"item\":\"https://docs.soara.ai/ai-assistants/web-widget\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.soara.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.soara.ai/ai-assistants/web-widget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.soara.ai/ai-assistants/web-widget#webpage\"},\"dateModified\":\"2026-05-25T18:00:03.836Z\",\"publisher\":{\"@id\":\"https://docs.soara.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.soara.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Soara\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Soara","nav":{"global":null,"anchors":[{"anchor":"Platform Guide","icon":"book","groups":[{"group":"Introduction","pages":[{"title":"What is Soara?","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"}]}]},"title":"Web Widget - Soara","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BbYRHtLl.js","DynamicMarkdown-DN96a4Ur.js","zoom-image-lightbox-D7yRe3On.js","lightbox-handle-r17bVUz3.js"]}
