Embed your AI assistant on your website with voice and chat capabilities
Add your AI assistant to any website with a customizable widget that supports voice calls, text chat, or both.
Overview
The Web Widget allows website visitors to interact with your AI assistant directly through:
Voice conversations: Real-time voice calls in the browser
Text chat: Messaging interface for text-based interactions
Hybrid mode: Seamless switching between voice and chat
Accessing Widget Configuration
Navigate to your assistant’s edit page
Click the “Web widget” button (yellow/warning color)
The widget configuration panel opens with live preview
Web Widget is a premium feature. Ensure your plan includes web widget access before configuration.
Widget Modes
Choose how visitors interact with your assistant:
Voice & Chat (Recommended)
Users can seamlessly switch between voice and text during conversations.Best for:
Maximum flexibility for users
Accessibility (voice for mobile, chat for quiet environments)
Complex interactions requiring both modes
Chat Only
Text-based messaging interface only.Best for:
Customer support and FAQs
Environments where voice isn’t appropriate
Lead capture and qualification forms
Voice Only
Real-time voice conversations only.Best for:
Phone-like experience on website
Voice-first use cases
Hands-free interactions
Configuration Options
General Tab
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.
Button Tab
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 & Modal Tab
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”)
Chat Settings Tab
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.
Clickable Links in Chat
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.
Voice Settings Tab
This tab is only visible when the widget mode includes voice (Voice Only or Voice & Chat).
Connecting Text (default: “Connecting…”)Disconnect Text (default: “Disconnect”)Error Text (default: “Connection failed. Please try again.”)
Pre-Chat Form
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 Response Settings
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.
Conversation Webhook
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.
Widget Display
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.
Live Widget Preview
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.
Embed Code
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.
Installation
Configure and save your widget settings
Copy the embed code from the Embed Code section
Paste the script tag before the closing </body> tag on your website
Visit your website and verify the widget appears in the configured position
Test voice/chat functionality and pre-chat form (if configured)
Widget Behavior
First Visit
Widget button appears in configured position
Click opens modal/chat interface
Pre-chat form displays (if configured)
After form submission, conversation starts
Return Visits
Previous conversation state may be restored
Form data remembered (if visitor hasn’t cleared cookies)
Seamless continuation of support experience
Conversation Tracking
All widget conversations appear in your Conversations page for review and analysis.
HTTPS (SSL certificate) is required for voice functionality. HTTP sites can only use chat mode due to browser security restrictions.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Nicecall","colors":{"primary":"#8c52ff","light":"#af87ff","dark":"#6534c7"},"favicon":"https://mintcdn.com/nicecall/duBwEVBVgUQwLK-f/favicon.png?fit=max\u0026auto=format\u0026n=duBwEVBVgUQwLK-f\u0026q=85\u0026s=4895a74f857aaf4cecfec8e3ed3d9c6a","logo":{"light":"https://mintcdn.com/nicecall/HTh8wkgVLtCuGyKd/resources/logo/light.png?fit=max\u0026auto=format\u0026n=HTh8wkgVLtCuGyKd\u0026q=85\u0026s=fdc82ec4d433cd78b059eef7224a785e","dark":"https://mintcdn.com/nicecall/HTh8wkgVLtCuGyKd/resources/logo/dark.png?fit=max\u0026auto=format\u0026n=HTh8wkgVLtCuGyKd\u0026q=85\u0026s=6bd88933aeaa6f9c6137c6c784face5b"},"api":{"mdx":{"server":"https://app.nicecall.ai/api/","auth":{"method":"bearer","name":null}}},"navbar":{"links":[{"label":"Home","href":"https://nicecall.ai"},{"label":"Support","href":"https://nicecall.ai/contact"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.nicecall.ai"}},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nicecall","hasAudioNarration":false,"actualSubdomain":"nicecall","customDomains":["docs.nicecall.ai"],"gitSource":{"type":"github","owner":"nicecall-ai","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af652f5099366755051dc0d","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":105},{"language":"default","tag":"Platform Guide","count":94},{"language":"default","tag":"AI Assistants Overview","count":29},{"language":"default","tag":"Assistants","count":16},{"language":"default","tag":"Troubleshooting \u0026 FAQs","count":12},{"language":"default","tag":"Automations","count":10},{"language":"default","tag":"Knowledgebases","count":10},{"language":"default","tag":"Phone Numbers","count":10},{"language":"default","tag":"No-Code Automation","count":10},{"language":"default","tag":"Conversations","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"custom-rbac-roles","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":"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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","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/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=071d3b38d0107b6f3de0357dacc31a18`,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/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=c9758ec514a96f947256df025dd6bcef 280w, https://mintcdn.com/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=5bcbe30ae93b44f6f2439c27b2f29b94 560w, https://mintcdn.com/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=54572bde66ee9c3e21ebf927bbd27d61 840w, https://mintcdn.com/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=8eb520f2050336272bb32ff878a8ec12 1100w, https://mintcdn.com/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=b61c855e8aa15d9af13d56875d8a2b7c 1650w, https://mintcdn.com/nicecall/1FJMySxravWezcoP/resources/web-widget-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=1FJMySxravWezcoP\u0026q=85\u0026s=3b96507d83f5d65fb95ce62cc079f646 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=4f049d492d6f07194f2ac79afa5d8f5a`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=bf3a78042c2207084c9ce9d7c166b41a 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=4d2c651b468eff30f86f9f05f0908beb 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=b257a50faad316ceb4bcc61c5f854579 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=d6a976bb7b0dbb60fd827b682c70716f 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=2d372943c09f31c19e8feec64cf4bf11 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-general.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=22cb6ccaa1b1f493fd784bca3fd1f7ef 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=710533b669992829f235477407c6817c`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=bcd0f47f3d9d667e9c847dea4e1f13a0 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=6ff243acdcf805c8d053663597546002 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=db460ac2d7ae1cc0c1a44729fa0d3806 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=641b5ad6524eed6791948af5b9eb559e 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=3b59c222039281e505c37c3b62c29012 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7f5d48177b2f7d174eee12d2a19555ae 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=68193d6c53797e962034804467b92af4`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=97655dff22ae62f0423583d2c02fb361 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8fa5f544bda93ad676adc5e33d35e50c 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=3b49b18152bb635d7f7f39e60ae56c3e 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=42559b45e0b122066c4eeeaeb60d894c 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=58b5673b8ba62c254984bc0f84d5e200 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-header-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=dd5071aac25e7575e96f7c497385b909 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8a9b8769ce58d1720ec55ffa287fb2e5`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=d8e462f4b42d5382ea62fde2d33eb652 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=041fe4928500d19bcdf3b7c451b506e6 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=1a814101e89ab4eb53d3c251a4835b79 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=c55048887dff4586ab8fb3f6bcfdf19f 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=74eb3c32e8b9464c99e9f059f8cf9d24 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-chat-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=802ea5047a630d21d464b9393bf3c243 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8479663172169ff3d925b9afabd385a9`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=4ec8ee30a487627aca53f9dfb6d4c812 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=881950ad0aed880f172fe7ded8c12bde 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=3dd4f44b6a4a9727c8fabe790b7f218a 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=d0192d58180cda6aaeb8d99d1efb5290 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=47c620bdddc1e1ca643b5c31c34ae1fa 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-tab-voice-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=725cca58daeaabdb2105c02a17168171 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=ced6ddc3e4f732c61a7c349488f78a95`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=59b8f7193f5c8f80a6b72e7d4afa077f 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=2c83bfe22f6e73c55bd653f3ccf834de 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=5c6c4e93be3852648fb7deee63040a06 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=425b9742ff2665e20d72b6b2cc03e0a4 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8573c654867f474148676d17f4817c36 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-pre-chat-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=587e9dfb562eec019908e1180289952a 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=56ef0983e3de21f02831ab47516ceea9`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=2108620efe4ffad6f2204db88f4a6ccd 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=fd66e97645302492a4e4950073c5c7e9 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=a82fe8a37799a22da21ecf6b5ae14094 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=62197a77cfbec513f8884b254b9f7a86 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=41294fcf59d87866bff3b80d6f7d2782 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-ai-response-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=e1da7a3cbe22e3a484a4d717e9bd0b7e 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=ca21c4c68bcdf801e1f32d9938d0f921`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=9621b77fa3417aa9349cdfd74c769fc7 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=c0dd5e8120d9546fbb229751bf888939 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=882f635ed04d13f2551edf647708c785 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7c47416cbee9feeeabb2bf75cb55c7a6 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8f60d489c8f38a0ed7a40095e54ea447 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-conversation-webhook.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=444b65cc051c493ce0aa0109d9b9a709 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=9317d9b467e35b1e8104a44b7f5d4499`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=6f76c21dd267565028e2651b5cdc8f89 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=09ec58f70d8f9f78f82e3e157e2d593a 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=1f0752e45571c9b18f6a47bc26573e60 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=b1ad0a779bf10f96f810af635899ac79 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7799a8a7cd942fd42c9484f1a87ed3d5 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-display-toggle.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7266f3601e7cc22a3a5c6a84ef897ae4 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7f3f36b5d712950d6e8596c23d83b4d7`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8874de6f101bd19d4304b5d54e4570e4 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=cbf802619b0077bd4eb03c2a30c06e00 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=14ff2308d4d0f384282e77b38b148f74 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=59f15bb3d109b31fba221f67f7b4ec73 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=543cb3a08c3cc221bc1af1ed994084c8 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-live-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=8f77b6173891ed80ebee5082d4a6e8dc 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/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=b62a413d27fecae7bdc17f7f7cf6fad9`,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/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=280\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=7fecba06e1225628727381a930c3b353 280w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=560\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=f5a3bae4d61b0c32ad7c3c526d4e22bb 560w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=840\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=fe1ce6a8826c24595af26dd082923b47 840w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=99548b5621505f74f12d9e397d99b169 1100w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=257ec9a8d33f697987176d774ceea58f 1650w, https://mintcdn.com/nicecall/ShqowjlL9qr5kIUl/resources/widget-embed-code.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ShqowjlL9qr5kIUl\u0026q=85\u0026s=45129585fa3a9b26f9f30d60a98549fd 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.nicecall.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":"nicecall","siteName":"Nicecall","title":"Web Widget - Nicecall","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-17T20:46:22.761Z","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=\"Nicecall\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_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/nicecall/IHGQv35ipSjPch5Z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Web Widget - Nicecall\">\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=\"Nicecall\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nicecall.ai/ai-assistants/web-widget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nicecall.mintlify.site/_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=d271cb126dbc2ea417dc93d3\u0026amp;signature=e27d0ecc0b5a88ddfd8f01855a100163c2e4d23ace627ec79d2f7e82747aa2a6\">\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 - Nicecall\">\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://nicecall.mintlify.site/_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=d271cb126dbc2ea417dc93d3\u0026amp;signature=e27d0ecc0b5a88ddfd8f01855a100163c2e4d23ace627ec79d2f7e82747aa2a6\">\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/nicecall/IHGQv35ipSjPch5Z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nicecall\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8c52ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nicecall.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.nicecall.ai/#organization\",\"name\":\"Nicecall\",\"url\":\"https://docs.nicecall.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nicecall/HTh8wkgVLtCuGyKd/resources/logo/light.png?fit=max\u0026auto=format\u0026n=HTh8wkgVLtCuGyKd\u0026q=85\u0026s=fdc82ec4d433cd78b059eef7224a785e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nicecall.ai#website\",\"name\":\"Nicecall\",\"url\":\"https://docs.nicecall.ai\",\"publisher\":{\"@id\":\"https://docs.nicecall.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nicecall.ai/ai-assistants/web-widget#webpage\",\"url\":\"https://docs.nicecall.ai/ai-assistants/web-widget\",\"name\":\"Web Widget\",\"description\":\"Embed your AI assistant on your website with voice and chat capabilities\",\"dateModified\":\"2026-08-17T20:46:22.761Z\",\"isPartOf\":{\"@id\":\"https://docs.nicecall.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nicecall.ai/ai-assistants/web-widget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nicecall.ai/ai-assistants/web-widget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"AI Assistants Overview\",\"item\":\"https://docs.nicecall.ai/ai-assistants/what-is-ai-assistant\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Widget\",\"item\":\"https://docs.nicecall.ai/ai-assistants/web-widget\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.nicecall.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.nicecall.ai/ai-assistants/web-widget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nicecall.ai/ai-assistants/web-widget#webpage\"},\"dateModified\":\"2026-08-17T20:46:22.761Z\",\"publisher\":{\"@id\":\"https://docs.nicecall.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nicecall.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nicecall\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nicecall\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ai-assistants/web-widget.md","siteName":"Nicecall","nav":{"global":null,"anchors":[{"anchor":"Platform Guide","icon":"book","groups":[{"group":"Introduction","pages":[{"title":"What is Nicecall?","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":"Start here","pages":[{"title":"Simple or Advanced","href":"/ai-assistants/choosing-your-editor"},{"title":"Simple Setup","href":"/ai-assistants/simple-mode"},{"title":"The Advanced Builder","href":"/ai-assistants/advanced-workspace"}]},{"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":"MCP Servers","icon":"share-nodes","href":"/ai-assistants/mcp-servers"},{"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"},{"title":"Testing an Inbound Assistant","description":"Test the saved number and routing for an inbound assistant.","href":"/ai-assistants/testing-inbound"},{"title":"Version History","href":"/ai-assistants/version-history"},{"title":"AI Advisor","href":"/ai-assistants/ai-advisor"},{"title":"Find a Setting","href":"/ai-assistants/find-a-setting"},{"title":"Realtime Voice SDK","href":"/ai-assistants/realtime-sdk"}]},{"group":"Campaigns","icon":"bullhorn","pages":[{"title":"Campaigns Overview","icon":"bullhorn","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":"WhatsApp Calling","icon":"phone","href":"/whatsapp/calling"},{"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":"Claude \u0026 ChatGPT Connector (MCP)","icon":"plug","href":"/mcp-connector"},{"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"},{"title":"Telnyx","href":"/provisioning/sip-trunking/telnyx"}]}]},{"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 - Nicecall","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DBAS9Liu.js","DynamicMarkdown-C4w9kavL.js","zoom-image-lightbox-B9O1U98p.js","lightbox-handle-r17bVUz3.js"]}