Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.
Quick embed
Create a Web channel in your agent’s Channels page, then copy the generated snippet into your site before </body>.
<script src="https://bothive.cloud/widget.js" data-bot-id="your-bot-id" data-widget-token="your-browser-safe-widget-token" data-title="Ask a question" data-theme="system" data-accent="#18181b" data-suggestions="What can you help with?|Show me how to get started" async></script>
The widget loads asynchronously. The token is designed for browser use, but it is not an owner API key.
Customize the experience
Attribute
Default
Description
data-bot-id
Required
Your agent ID
data-widget-token
Required
Browser-safe token created by the Web channel
data-position
bottom-right
bottom-right or bottom-left
data-mode
floating
floating launcher or inline embedded panel
data-theme
system
system, light, or dark
data-accent
#18181b
Hex color for the visitor message and send action
data-title
Ask a question
Header label
data-subtitle
Usually replies in a moment
Header status text
data-greeting
Hi. How can I help?
First assistant message
data-placeholder
Write a message...
Composer placeholder
data-launcher-label
Chat with us
Floating launcher’s label
data-avatar
Bothive mark
HTTPS image URL for an avatar
data-suggestions
None
Up to four starter prompts separated by `
`
Brand example
<script src="https://bothive.cloud/widget.js" data-bot-id="bot_abc123xyz" data-widget-token="your-browser-safe-widget-token" data-position="bottom-right" data-theme="light" data-accent="#0f766e" data-title="Acme Support" data-subtitle="Product and billing help" data-greeting="Welcome to Acme. I can help with billing, product questions, and getting started." data-placeholder="Ask Acme..." data-avatar="https://yoursite.com/support-avatar.png" data-suggestions="How do I get started?|Where is my invoice?|Talk to support" async></script>
Inline mode
Use inline mode when chat belongs inside a docs page, help center, or product settings screen rather than floating over the site.
The widget creates an opaque session ID in browser storage. It sends that ID with each message so a visitor can continue their own conversation without mixing it with another visitor’s history. It also sends the current page URL and title as runtime metadata.Open your agent’s Observability page after testing. Each widget run is recorded as a Web channel event, with session context, latency, final response, tool activity, memory events, and errors where they exist.
Restrict the Web channel to your allowed website origins before launch. Never put an owner API key, account identity, email address, or private application data into the public script tag.
Test before launch
Open the page in a private browser window.
Test a known answer, an unknown answer, a follow-up, and a request that needs a tool.
Check mobile layout and both light and dark site contexts.
Open the matching trace in Bothive Observability.
Next reads
Deploy to Channels
Telegram Bots
Observability
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bothive","colors":{"primary":"#09090b","light":"#f4f4f5","dark":"#09090b"},"logo":{"light":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-light.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=0030856b13a878aa5fa511ba61258250","dark":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-dark.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=352ede20b4e6122c17cabf0370d70b6b","href":"https://docs.bothive.cloud"},"favicon":"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-dark.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=352ede20b4e6122c17cabf0370d70b6b","api":{"playground":{}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://docs.bothive.cloud/guides/first-agent","label":"Guides"},{"href":"https://docs.bothive.cloud/api/overview","label":"API reference"},{"href":"https://docs.bothive.cloud/?assistant","label":"Ask AI"},{"href":"https://bothive.cloud/dashboard","label":"Open Bothive"}]},"search":{"prompt":"Search documentation..."},"seo":{"metatags":{"canonical":"https://docs.bothive.cloud","og:image":"https://docs.bothive.cloud/images/docs-og-image.png","og:image:width":"1734","og:image:height":"907","og:image:alt":"Bothive Documentation - Build agents that ship","twitter:card":"summary_large_image","twitter:image":"https://docs.bothive.cloud/images/docs-og-image.png"}},"contextual":{"options":["assistant","copy"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bothive","hasAudioNarration":false,"actualSubdomain":"bothive","customDomains":["docs.bothive.cloud"],"gitSource":{"type":"github","owner":"ciphrnotfound","repo":"laughing-potato","deployBranch":"main","contentDirectory":"bothive/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae95abbb9c52538cea7f7b2:success","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Core Concepts","count":9},{"language":"default","tag":"Building Agents","count":9},{"language":"default","tag":"Start Here","count":5},{"language":"default","tag":"API Reference","count":4},{"language":"default","tag":"Deployment \u0026 Operations","count":4},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Resources","count":2},{"language":"default","tag":"Integrations","count":2},{"language":"default","tag":"Teams \u0026 Organisations","count":2}]},"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":"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":"site-roles","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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[{"filePath":"custom.css","content":"/* vietnamese */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-eNGe6N.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-aNGe6N.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Bricolage Grotesque';\n font-style: normal;\n font-weight: 300 700;\n font-stretch: 75% 100%;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/bricolagegrotesque/v9/3y996as8bTXq_nANBjzKo3IeZx8z6up5L-iNGQ.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--bv-bg: #fcfbf9;--bv-panel: #ffffff;--bv-panel-hover: #f4f4f5;--bv-border: rgba(0, 0, 0, 0.07);--bv-border-strong: rgba(0, 0, 0, 0.13);--bv-text: #09090b;--bv-muted: #52525b;--bv-faint: #a1a1aa;--bv-accent: #09090b;--bv-accent-hover: #18181b;--bv-card: #000000;--bv-card-text: #fafafa;--bv-card-muted: #a1a1aa;--bv-code-bg: #f7f7f6;--bv-code-bar: #efefed;--bv-code-text: #27272a;--bv-code-border: rgba(0, 0, 0, 0.1);--font-bv: \"Bricolage Grotesque\", ui-sans-serif, system-ui, sans-serif}.dark,[data-theme=\"dark\"]{--bv-bg: #0c0c0e;--bv-panel: #131316;--bv-panel-hover: rgba(255, 255, 255, 0.05);--bv-border: rgba(255, 255, 255, 0.08);--bv-border-strong: rgba(255, 255, 255, 0.14);--bv-text: #f4f4f5;--bv-muted: #a1a1aa;--bv-faint: #52525b;--bv-accent: #f4f4f5;--bv-accent-hover: #ffffff;--bv-code-bg: #080808;--bv-code-bar: #0e0e10;--bv-code-text: #e4e4e7;--bv-code-border: rgba(255, 255, 255, 0.11)}html,body{background:var(--bv-bg)!important;color:var(--bv-text)!important;font-family:var(--font-bv)!important;font-size:14px!important;-webkit-font-smoothing:antialiased;letter-spacing:0!important;box-shadow:none!important}body *{font-family:var(--font-bv)!important;letter-spacing:0!important;box-shadow:none!important}h1,h2,h3,h4,h5,h6{color:var(--bv-text)!important;font-weight:600!important;letter-spacing:-0.01em!important}h1{font-size:clamp(1.5rem, 2.5vw, 2rem)!important;line-height:1.15!important}h2{margin-top:2.5rem!important;border-top:1px solid var(--bv-border)!important;padding-top:1.25rem!important;font-size:1.05rem!important}h3{font-size:0.9rem!important;font-weight:600!important}.hero-container{background:transparent!important;border:1px solid var(--bv-border)!important;border-radius:10px!important;padding:36px 28px!important;margin-bottom:32px!important;text-align:left!important;transition:all 0.2s ease!important}.hero-title{font-family:var(--font-bv)!important;font-weight:400!important;font-size:clamp(1.75rem, 3vw, 2.35rem)!important;color:var(--bv-text)!important;letter-spacing:-0.02em!important;margin-bottom:16px!important}.hero-subtitle{font-size:0.95rem!important;color:var(--bv-muted)!important;max-width:640px!important;margin:0!important;line-height:1.55!important}p,li,td{color:var(--bv-muted)!important;line-height:1.75!important}strong,th{color:var(--bv-text)!important;font-weight:500!important}a{color:var(--bv-text)!important;text-decoration-color:var(--bv-border-strong)!important;text-underline-offset:4px!important}a:hover{color:var(--bv-accent-hover)!important;text-decoration-color:var(--bv-border-strong)!important}header,[class*=\"topbar\"],[class*=\"Topbar\"]{background:var(--bv-bg)!important;border-bottom:1px solid var(--bv-border)!important;backdrop-filter:blur(12px)!important}[class*=\"topbar\"] a[href*=\"signup\"],[class*=\"Topbar\"] a[href*=\"signup\"],[class*=\"topbar\"] a[href*=\"dashboard\"],[class*=\"Topbar\"] a[href*=\"dashboard\"],[class*=\"topbar\"] button,[class*=\"Topbar\"] button{border:1px solid var(--bv-border-strong)!important;background:transparent!important;color:var(--bv-text)!important;font-weight:500!important;border-radius:8px!important;padding:0.35rem 0.85rem!important;font-size:0.85rem!important;transition:all 0.15s ease!important;box-shadow:inset 0 0 0 1px var(--bv-border)!important}[class*=\"topbar\"] a[href*=\"signup\"]:hover,[class*=\"Topbar\"] a[href*=\"signup\"]:hover,[class*=\"topbar\"] a[href*=\"dashboard\"]:hover,[class*=\"Topbar\"] a[href*=\"dashboard\"]:hover,[class*=\"topbar\"] button:hover,[class*=\"Topbar\"] button:hover{background:var(--bv-panel-hover)!important;border-color:var(--bv-border-strong)!important}header a[href*=\"bothive.cloud/dashboard\"],nav a[href*=\"bothive.cloud/dashboard\"],[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"],[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"],a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]{display:inline-flex!important;align-items:center!important;justify-content:center!important;height:2.25rem!important;min-height:2.25rem!important;border:1px solid rgba(0, 0, 0, 0.12)!important;border-radius:0.5rem!important;background:transparent!important;color:#171717!important;padding:0 1rem!important;font-size:13px!important;font-weight:500!important;line-height:1!important;letter-spacing:0!important;text-decoration:none!important;box-shadow:none!important;opacity:1!important;background-image:none!important;transition:background-color 200ms ease, border-color 200ms ease, color 200ms ease, transform 200ms ease!important}html.dark header a[href*=\"bothive.cloud/dashboard\"],html.dark nav a[href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"],html.dark a[role=\"button\"][href*=\"bothive.cloud/dashboard\"],html[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"],[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]{border-color:rgba(255, 255, 255, 0.12)!important;background:transparent!important;color:#f4f4f5!important;box-shadow:none!important}header a[href*=\"bothive.cloud/dashboard\"] *,nav a[href*=\"bothive.cloud/dashboard\"] *,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"] *,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"] *,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"] *{color:inherit!important;fill:currentColor!important}header a[href*=\"bothive.cloud/dashboard\"]:hover,nav a[href*=\"bothive.cloud/dashboard\"]:hover,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:hover,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:hover,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover{border-color:rgba(0, 0, 0, 0.18)!important;background:#f7f7f6!important;color:#09090b!important;text-decoration:none!important}html.dark header a[href*=\"bothive.cloud/dashboard\"]:hover,html.dark nav a[href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] header a[href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] nav a[href*=\"bothive.cloud/dashboard\"]:hover,html.dark a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover,html[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover,[data-theme=\"dark\"] a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:hover{border-color:rgba(255, 255, 255, 0.15)!important;background:rgba(255, 255, 255, 0.02)!important;color:#fff!important}header a[href*=\"bothive.cloud/dashboard\"]:active,nav a[href*=\"bothive.cloud/dashboard\"]:active,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:active,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:active,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:active{transform:scale(0.98)!important}header a[href*=\"bothive.cloud/dashboard\"]:focus-visible,nav a[href*=\"bothive.cloud/dashboard\"]:focus-visible,[class*=\"topbar\"] a[href*=\"bothive.cloud/dashboard\"]:focus-visible,[class*=\"Topbar\"] a[href*=\"bothive.cloud/dashboard\"]:focus-visible,a[role=\"button\"][href*=\"bothive.cloud/dashboard\"]:focus-visible{outline:2px solid var(--bv-text)!important;outline-offset:2px!important}[class*=\"sidebar\"],[class*=\"Sidebar\"],aside:first-of-type{background:var(--bv-bg)!important;border-right:1px solid var(--bv-border)!important}[class*=\"sidebar\"] a,[class*=\"Sidebar\"] a{font-size:12px!important;color:var(--bv-muted)!important;border-radius:7px!important;transition:all 0.12s ease!important}[class*=\"sidebar\"] a:hover,[class*=\"Sidebar\"] a:hover{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important}[class*=\"sidebar\"] a[class*=\"active\"],[class*=\"Sidebar\"] a[class*=\"active\"]{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important;font-weight:500!important}[class*=\"search\"] input,[class*=\"Search\"] input,button[aria-label*=\"Search\"]{border:1px solid var(--bv-border)!important;border-radius:8px!important;background:transparent!important}main{max-width:78rem!important}article{max-width:48rem!important}@media (max-width: 768px){.hero-container{padding:28px 20px!important;margin-bottom:24px!important}th,td{padding:0.7rem 0.8rem!important}}[class*=\"TableOfContents\"],[class*=\"toc-container\"],[class*=\"OnThisPage\"],[class*=\"on-this-page\"]{background:transparent!important;border:none!important;padding-top:1.5rem!important}[class*=\"TableOfContents\"]>p,[class*=\"TableOfContents\"]>span,[class*=\"toc\"]>p,[class*=\"OnThisPage\"]>p{font-size:10px!important;font-weight:500!important;text-transform:uppercase!important;letter-spacing:0.12em!important;color:var(--bv-faint)!important;margin-bottom:0.75rem!important}[class*=\"TableOfContents\"] ul,[class*=\"TableOfContents\"] ol,[class*=\"toc\"] ul{border-left:1px solid var(--bv-border)!important;padding-left:0!important;margin-left:0!important;list-style:none!important}[class*=\"TableOfContents\"] a,[class*=\"toc\"] a,[class*=\"OnThisPage\"] a{display:block!important;font-size:11px!important;font-weight:400!important;color:var(--bv-faint)!important;border-left:1.5px solid transparent!important;margin-left:-1px!important;padding:0.22rem 0 0.22rem 0.875rem!important;transition:color 0.12s ease, border-color 0.12s ease!important;text-decoration:none!important;line-height:1.5!important}[class*=\"TableOfContents\"] a:hover,[class*=\"toc\"] a:hover,[class*=\"OnThisPage\"] a:hover{color:var(--bv-text)!important;text-decoration:none!important}[class*=\"TableOfContents\"] a[class*=\"active\"],[class*=\"TableOfContents\"] a[aria-current],[class*=\"toc\"] a[class*=\"active\"],[class*=\"OnThisPage\"] a[class*=\"active\"]{color:var(--bv-text)!important;border-left-color:var(--bv-text)!important;font-weight:500!important}[class*=\"feedback\"],[class*=\"Feedback\"],[class*=\"rating\"],[class*=\"Rating\"]{display:inline-flex!important;align-items:center!important;gap:0.15rem!important;border:1px solid var(--bv-border)!important;border-radius:8px!important;background:transparent!important;padding:0.2rem!important;margin-bottom:2.5rem!important}[class*=\"feedback\"] button,[class*=\"Feedback\"] button,[class*=\"rating\"] button,[class*=\"Rating\"] button{border:none!important;border-radius:6px!important;background:transparent!important;color:var(--bv-faint)!important;padding:0.3rem 0.5rem!important;font-size:11px!important;font-weight:400!important;transition:all 0.12s ease!important;cursor:pointer!important}[class*=\"feedback\"] button:hover,[class*=\"Feedback\"] button:hover,[class*=\"rating\"] button:hover,[class*=\"Rating\"] button:hover{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important}[class*=\"feedback\"] button[class*=\"active\"],[class*=\"feedback\"] button[aria-pressed=\"true\"],[class*=\"Feedback\"] button[class*=\"active\"],[class*=\"rating\"] button[class*=\"active\"],[class*=\"rating\"] button[aria-pressed=\"true\"]{background:var(--bv-panel-hover)!important;color:var(--bv-text)!important;font-weight:500!important}.card,[class*=\"Card\"]:not([class*=\"CardGroup\"]),.glass-effect{position:relative!important;overflow:hidden!important;border:1px solid var(--bv-border)!important;border-radius:10px!important;background:var(--bv-panel)!important;color:var(--bv-muted)!important;padding:1.1rem 1.15rem!important;transition:border-color 160ms ease, transform 160ms ease!important}.card:hover,[class*=\"Card\"]:not([class*=\"CardGroup\"]):hover,.glass-effect:hover{border-color:var(--bv-border-strong)!important;background:var(--bv-panel-hover)!important;transform:translateY(-1px)!important}[class*=\"CardGroup\"],[class*=\"card-group\"]{gap:0.75rem!important;margin:1.25rem 0 1.75rem!important}[class*=\"Card\"]:not([class*=\"CardGroup\"])>:first-child,.card>:first-child{margin-top:0!important}.card svg,[class*=\"Card\"] svg,.glass-effect svg,[class*=\"card-icon\"],[class*=\"CardIcon\"]{color:var(--bv-text)!important;opacity:0.78!important}[class*=\"card-icon\"],[class*=\"CardIcon\"]{width:1.75rem!important;height:1.75rem!important;border:1px solid var(--bv-border)!important;border-radius:7px!important;background:var(--bv-bg)!important;padding:0.38rem!important;margin-bottom:0.8rem!important}.card strong,[class*=\"Card\"] strong,[class*=\"card-title\"],.glass-effect strong{color:var(--bv-text)!important;font-weight:500!important;font-size:0.88rem!important;line-height:1.4!important}.card p,[class*=\"Card\"] p,.glass-effect p{color:var(--bv-muted)!important;margin-top:0.4rem!important;margin-bottom:0!important;font-size:0.78rem!important;line-height:1.6!important}[class*=\"Card\"] a,.card a,.glass-effect a{color:var(--bv-text)!important;text-decoration:none!important}[class*=\"callout\"],[class*=\"Callout\"]{border:1px solid var(--bv-border-strong)!important;border-radius:9px!important;background:var(--bv-panel)!important;padding:0.9rem 1rem!important}button,[role=\"button\"]:not(a[href*=\"bothive.cloud/dashboard\"]),.btn-primary:not(a[href*=\"bothive.cloud/dashboard\"]),.btn-secondary:not(a[href*=\"bothive.cloud/dashboard\"]){border-radius:8px!important;border:1px solid var(--bv-border-strong)!important;background:transparent!important;color:var(--bv-text)!important;font-weight:500!important;transition:all 0.12s ease!important}button:hover,[role=\"button\"]:not(a[href*=\"bothive.cloud/dashboard\"]):hover{background:var(--bv-panel-hover)!important}:not(pre)>code{font-family:\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace!important;border:1px solid var(--bv-border)!important;border-radius:5px!important;background:var(--bv-panel)!important;color:var(--bv-text)!important;font-size:0.82em!important;font-weight:400!important;padding:0.12rem 0.32rem!important}pre{margin:1.25rem 0 1.65rem!important;border:1px solid var(--bv-code-border)!important;border-radius:10px!important;background:var(--bv-code-bg)!important;padding:1.05rem 1.15rem!important;overflow:auto!important;scrollbar-color:var(--bv-border-strong) transparent!important}pre code{font-family:\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace!important;border:0!important;background:transparent!important;padding:0!important;color:var(--bv-code-text)!important;font-size:0.76rem!important;line-height:1.75!important;tab-size:2!important;font-variant-ligatures:none!important}[class*=\"CodeBlock\"],[class*=\"code-block\"],[class*=\"CodeGroup\"],[class*=\"code-group\"]{overflow:hidden!important;border:1px solid var(--bv-code-border)!important;border-radius:10px!important;background:var(--bv-code-bg)!important;margin:1.25rem 0 1.65rem!important}[class*=\"CodeBlock\"] pre,[class*=\"code-block\"] pre,[class*=\"CodeGroup\"] pre,[class*=\"code-group\"] pre{margin:0!important;border:0!important;border-radius:0!important}[class*=\"CodeBlock\"] button,[class*=\"code-block\"] button,[class*=\"CodeGroup\"] button,[class*=\"code-group\"] button{border:0!important;background:transparent!important;color:var(--bv-faint)!important;font-family:\"JetBrains Mono\", ui-monospace, monospace!important;font-size:0.68rem!important;font-weight:400!important}[class*=\"CodeBlock\"] button:hover,[class*=\"code-block\"] button:hover,[class*=\"CodeGroup\"] button:hover,[class*=\"code-group\"] button:hover,[class*=\"CodeBlock\"] button[aria-selected=\"true\"],[class*=\"code-block\"] button[aria-selected=\"true\"],[class*=\"CodeGroup\"] button[aria-selected=\"true\"],[class*=\"code-group\"] button[aria-selected=\"true\"]{color:var(--bv-code-text)!important;background:var(--bv-code-bar)!important}[class*=\"CodeBlock\"]>div:first-child,[class*=\"code-block\"]>div:first-child,[class*=\"CodeGroup\"]>div:first-child,[class*=\"code-group\"]>div:first-child{min-height:2.45rem!important;border-bottom:1px solid var(--bv-code-border)!important;background:var(--bv-code-bar)!important}pre code span[style*=\"--shiki-light\"]{color:var(--shiki-light)!important}.dark pre code span[style*=\"--shiki-dark\"],[data-theme=\"dark\"] pre code span[style*=\"--shiki-dark\"]{color:var(--shiki-dark)!important}pre .token.comment,pre .token.prolog,pre .token.doctype{color:#7c7c85!important}pre .token.keyword,pre .token.selector,pre .token.atrule{color:#b35c9b!important}pre .token.string,pre .token.attr-value,pre .token.inserted{color:#41856a!important}pre .token.function,pre .token.class-name{color:#8a641f!important}pre .token.number,pre .token.boolean,pre .token.constant{color:#3976a8!important}.dark pre .token.keyword,[data-theme=\"dark\"] pre .token.keyword,.dark pre .token.selector,[data-theme=\"dark\"] pre .token.selector,.dark pre .token.atrule,[data-theme=\"dark\"] pre .token.atrule{color:#d78fc7!important}.dark pre .token.string,[data-theme=\"dark\"] pre .token.string,.dark pre .token.attr-value,[data-theme=\"dark\"] pre .token.attr-value,.dark pre .token.inserted,[data-theme=\"dark\"] pre .token.inserted{color:#83c6a5!important}.dark pre .token.function,[data-theme=\"dark\"] pre .token.function,.dark pre .token.class-name,[data-theme=\"dark\"] pre .token.class-name{color:#e2bb72!important}.dark pre .token.number,[data-theme=\"dark\"] pre .token.number,.dark pre .token.boolean,[data-theme=\"dark\"] pre .token.boolean,.dark pre .token.constant,[data-theme=\"dark\"] pre .token.constant{color:#78aee0!important}@media (max-width: 640px){.card,[class*=\"Card\"]:not([class*=\"CardGroup\"]),.glass-effect{padding:0.95rem!important}pre{border-radius:8px!important;padding:0.9rem!important}pre code{font-size:0.72rem!important}}table{border:1px solid var(--bv-border)!important;border-radius:10px!important;overflow:hidden!important;background:var(--bv-bg)!important;border-collapse:collapse!important;width:100%!important}th,td{border:1px solid var(--bv-border)!important;padding:0.875rem 1.25rem!important;text-align:left!important}th{background:var(--bv-panel)!important;color:var(--bv-text)!important;font-weight:500!important;font-size:0.85rem!important;letter-spacing:0.02em!important}td{font-size:0.9rem!important}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{border-radius:999px;background:var(--bv-border-strong)}::selection{background:var(--bv-text)!important;color:var(--bv-bg)!important}a[href*=\"bothive.cloud/dashboard\"],:is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]){appearance:none!important;-webkit-appearance:none!important;background-clip:padding-box!important;background:transparent!important;background-color:transparent!important;background-image:none!important;border:1px solid rgba(9, 9, 11, 0.14)!important;border-radius:0.5rem!important;box-shadow:none!important;color:#09090b!important;display:inline-flex!important;align-items:center!important;justify-content:center!important;font-size:13px!important;font-weight:500!important;height:2.25rem!important;line-height:1!important;padding:0 1rem!important;text-decoration:none!important;text-shadow:none!important}a[href*=\"bothive.cloud/dashboard\"]:hover,:is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]):hover{background:#f4f4f5!important;background-color:#f4f4f5!important;border-color:rgba(9, 9, 11, 0.22)!important;color:#09090b!important}:is(.dark,[data-theme=\"dark\"]) a[href*=\"bothive.cloud/dashboard\"],:is(.dark,[data-theme=\"dark\"]) :is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]){background:transparent!important;background-color:transparent!important;border-color:rgba(255, 255, 255, 0.14)!important;color:#f4f4f5!important}:is(.dark,[data-theme=\"dark\"]) a[href*=\"bothive.cloud/dashboard\"]:hover,:is(.dark,[data-theme=\"dark\"]) :is(header,nav,[class*=\"topbar\"],[class*=\"Topbar\"],[class*=\"navbar\"],[class*=\"Navbar\"]) :is(a[href=\"https://bothive.cloud/dashboard\"],a[href=\"https://bothive.cloud/dashboard/\"],a[href*=\"bothive.cloud/dashboard\"],a[href=\"/dashboard\"],a[href=\"/dashboard/\"],a[href*=\"/dashboard\"]):hover{background:rgba(255, 255, 255, 0.04)!important;background-color:rgba(255, 255, 255, 0.04)!important;border-color:rgba(255, 255, 255, 0.22)!important;color:#ffffff!important}a[href*=\"?assistant\"]{color:var(--bv-muted)!important;font-size:13px!important;font-weight:500!important;text-decoration:none!important}a[href*=\"?assistant\"]:hover{color:var(--bv-text)!important;text-decoration:none!important}"}]}
{"page":{"pagePath":"guides/web-widget","slug":"/guides/web-widget","pageMetadata":{"title":"Web Widget","description":"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.","href":"/guides/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 a Bothive agent on any site with a clean, customizable browser-safe chat surface.\"\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={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`quick-embed`,children:`Quick embed`}),`\n`,_jsxs(_components.p,{children:[`Create a `,_jsx(_components.strong,{children:`Web`}),` channel in your agent’s `,_jsx(_components.strong,{children:`Channels`}),` page, then copy the generated snippet into your site before `,_jsx(_components.code,{children:`\u003c/body>`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,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`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_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://bothive.cloud/widget.js\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-bot-id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-bot-id\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-widget-token`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-browser-safe-widget-token\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-title`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ask a question\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-theme`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"system\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-accent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"#18181b\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-suggestions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"What can you help with?|Show me how to get started\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` async`})}),`\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(_components.p,{children:`The widget loads asynchronously. The token is designed for browser use, but it is not an owner API key.`}),`\n`,_jsx(Heading,{level:`2`,id:`customize-the-experience`,children:`Customize the experience`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Attribute`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-bot-id`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Your agent ID`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-widget-token`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Browser-safe token created by the Web channel`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-position`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`bottom-right`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`bottom-right`}),` or `,_jsx(_components.code,{children:`bottom-left`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-mode`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`floating`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`floating`}),` launcher or `,_jsx(_components.code,{children:`inline`}),` embedded panel`]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-theme`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`system`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`system`}),`, `,_jsx(_components.code,{children:`light`}),`, or `,_jsx(_components.code,{children:`dark`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-accent`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`#18181b`})}),_jsx(_components.td,{children:`Hex color for the visitor message and send action`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-title`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Ask a question`})}),_jsx(_components.td,{children:`Header label`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-subtitle`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Usually replies in a moment`})}),_jsx(_components.td,{children:`Header status text`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-greeting`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Hi. How can I help?`})}),_jsx(_components.td,{children:`First assistant message`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-placeholder`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Write a message...`})}),_jsx(_components.td,{children:`Composer placeholder`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-launcher-label`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Chat with us`})}),_jsx(_components.td,{children:`Floating launcher’s label`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-avatar`})}),_jsx(_components.td,{children:`Bothive mark`}),_jsx(_components.td,{children:`HTTPS image URL for an avatar`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`data-suggestions`})}),_jsx(_components.td,{children:`None`}),_jsx(_components.td,{children:\"Up to four starter prompts separated by `\"}),_jsx(_components.td,{children:\"`\"})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`brand-example`,children:`Brand example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,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:`15`,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`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_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://bothive.cloud/widget.js\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-bot-id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bot_abc123xyz\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-widget-token`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-browser-safe-widget-token\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-position`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bottom-right\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-theme`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"light\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-accent`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"#0f766e\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-title`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Acme Support\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-subtitle`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Product and billing help\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-greeting`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Welcome to Acme. I can help with billing, product questions, and getting started.\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-placeholder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ask Acme...\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-avatar`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://yoursite.com/support-avatar.png\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-suggestions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"How do I get started?|Where is my invoice?|Talk to support\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` async`})}),`\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(Heading,{level:`2`,id:`inline-mode`,children:`Inline mode`}),`\n`,_jsx(_components.p,{children:`Use inline mode when chat belongs inside a docs page, help center, or product settings screen rather than floating over the site.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,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:`div`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"help-assistant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`>\u003c/`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`div`}),_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`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_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://bothive.cloud/widget.js\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-bot-id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bot_abc123xyz\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-widget-token`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-browser-safe-widget-token\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-mode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"inline\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-theme`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"system\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` data-title`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Documentation assistant\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` async`})}),`\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(Heading,{level:`2`,id:`sessions-and-observability`,children:`Sessions and observability`}),`\n`,_jsx(_components.p,{children:`The widget creates an opaque session ID in browser storage. It sends that ID with each message so a visitor can continue their own conversation without mixing it with another visitor’s history. It also sends the current page URL and title as runtime metadata.`}),`\n`,_jsxs(_components.p,{children:[`Open your agent’s `,_jsx(_components.strong,{children:`Observability`}),` page after testing. Each widget run is recorded as a Web channel event, with session context, latency, final response, tool activity, memory events, and errors where they exist.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Restrict the Web channel to your allowed website origins before launch. Never put an owner API key, account identity, email address, or private application data into the public script tag.`})}),`\n`,_jsx(Heading,{level:`2`,id:`test-before-launch`,children:`Test before launch`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Open the page in a private browser window.`}),`\n`,_jsx(_components.li,{children:`Test a known answer, an unknown answer, a follow-up, and a request that needs a tool.`}),`\n`,_jsx(_components.li,{children:`Check mobile layout and both light and dark site contexts.`}),`\n`,_jsx(_components.li,{children:`Open the matching trace in Bothive Observability.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-reads`,children:`Next reads`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Deploy to Channels`,icon:`signal`,href:`/guides/deploy-to-channels`}),_jsx(Card,{title:`Telegram Bots`,icon:`telegram`,href:`/guides/telegram-bots`}),_jsx(Card,{title:`Observability`,icon:`chart-line`,href:`/concepts/observability`})]})]})}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","description":"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.","href":"/guides/web-widget"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Quick embed","slug":"quick-embed","depth":2,"children":[]},{"title":"Customize the experience","slug":"customize-the-experience","depth":2,"children":[]},{"title":"Brand example","slug":"brand-example","depth":2,"children":[]},{"title":"Inline mode","slug":"inline-mode","depth":2,"children":[]},{"title":"Sessions and observability","slug":"sessions-and-observability","depth":2,"children":[]},{"title":"Test before launch","slug":"test-before-launch","depth":2,"children":[]},{"title":"Next reads","slug":"next-reads","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/bothive/9bef8a0731a3e181/bothive-docs-assistant.js"],"subdomain":"bothive","siteName":"Bothive","title":"Web Widget - Bothive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-29T16:49:03.955Z","originalFileLocation":"guides/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 a Bothive agent on any site with a clean, customizable browser-safe chat surface.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bothive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Web Widget - Bothive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bothive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bothive.cloud/guides/web-widget\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.bothive.cloud/images/docs-og-image.png\">\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 - Bothive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.bothive.cloud/images/docs-og-image.png\">\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/bothive/zpYsQvaK61VW1Uyi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bothive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#09090b\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Bothive Documentation - Build agents that ship\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bothive.cloud/guides/web-widget\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/web-widget.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bothive.cloud/#organization\",\"name\":\"Bothive\",\"url\":\"https://docs.bothive.cloud\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bothive/40GcNRfQ4jHFu0pQ/images/bothive-logo-light.svg?fit=max\u0026auto=format\u0026n=40GcNRfQ4jHFu0pQ\u0026q=85\u0026s=0030856b13a878aa5fa511ba61258250\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bothive.cloud#website\",\"name\":\"Bothive\",\"url\":\"https://docs.bothive.cloud\",\"publisher\":{\"@id\":\"https://docs.bothive.cloud/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bothive.cloud/guides/web-widget#webpage\",\"url\":\"https://docs.bothive.cloud/guides/web-widget\",\"name\":\"Web Widget\",\"description\":\"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.\",\"dateModified\":\"2026-07-29T16:49:03.955Z\",\"isPartOf\":{\"@id\":\"https://docs.bothive.cloud#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bothive.cloud/guides/web-widget#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bothive.cloud/guides/web-widget#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Building Agents\",\"item\":\"https://docs.bothive.cloud/guides/build-your-first-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Web Widget\",\"item\":\"https://docs.bothive.cloud/guides/web-widget\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bothive.cloud/guides/web-widget#article\",\"headline\":\"Web Widget\",\"name\":\"Web Widget\",\"description\":\"Embed a Bothive agent on any site with a clean, customizable browser-safe chat surface.\",\"url\":\"https://docs.bothive.cloud/guides/web-widget\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bothive.cloud/guides/web-widget#webpage\"},\"image\":\"https://docs.bothive.cloud/images/docs-og-image.png\",\"dateModified\":\"2026-07-29T16:49:03.955Z\",\"publisher\":{\"@id\":\"https://docs.bothive.cloud/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bothive.cloud#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bothive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bothive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/web-widget.md","siteName":"Bothive","nav":{"global":null,"groups":[{"group":"Start Here","pages":[{"title":"Build Your First Agent","href":"/guides/first-agent"},{"title":"Connect Your First Tool","href":"/guides/connect-first-tool"},{"title":"Deploy Your First Agent","href":"/guides/deploy-first-agent"},{"title":"Read Your First Trace","href":"/guides/read-your-first-trace"},{"title":"Bothive Beginner Handbook","href":"/guides/beginner-handbook"}]},{"group":"Getting Started","pages":[{"title":"Bothive Documentation","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Why Bothive","href":"/why-bothive"},{"title":"Platform Status","href":"/platform-status"}]},{"group":"Core Concepts","pages":[{"title":"Platform Architecture","href":"/concepts/architecture"},{"title":"Building SaaS Agents","href":"/concepts/saas-agents"},{"title":"HiveLang","href":"/concepts/hivelang"},{"title":"Bothive vs Vercel AI SDK","href":"/concepts/bothive-vs-vercel-ai"},{"title":"Bothive vs LangChain","href":"/concepts/bothive-vs-langchain"},{"title":"Integrations","href":"/concepts/integrations"},{"title":"Deployment Channels","href":"/concepts/channels"},{"title":"Memory System","href":"/concepts/memory"},{"title":"Observability \u0026 Traces","href":"/concepts/observability"}]},{"group":"Building Agents","pages":[{"title":"Build Your First Agent","href":"/guides/build-your-first-agent"},{"title":"Telegram Bots","href":"/guides/telegram-bots"},{"title":"Slack Bots","href":"/guides/slack-bots"},{"title":"Discord Bots","href":"/guides/discord-bots"},{"title":"Gmail Agents","href":"/guides/gmail-agents"},{"title":"Codebase Assistants","href":"/guides/codebase-assistants"},{"title":"Meeting Assistants","description":"Build agents that schedule meetings, send summaries, and follow up — automatically.","href":"/guides/meeting-assistants"},{"title":"Web Widget","href":"/guides/web-widget"},{"title":"Add a Bothive Agent to Mintlify Docs","description":"Use a Bothive-built agent as the AI assistant inside your Mintlify documentation.","href":"/guides/mintlify-docs-agent"}]},{"group":"Deployment \u0026 Operations","pages":[{"title":"Production Deployment Guide","href":"/guides/deployment-guide"},{"title":"Deploy to Channels","href":"/guides/deploy-to-channels"},{"title":"Connecting Channels \u0026 Tools","href":"/guides/connect-bot-channels-and-tools"},{"title":"Launch Checklist","href":"/guides/launch-checklist"}]},{"group":"Teams \u0026 Organisations","pages":[{"title":"Organisation Workspaces","href":"/guides/organisation-workspaces"},{"title":"Team Shared Bots","href":"/guides/team-shared-bots"}]},{"group":"Integrations","pages":[{"title":"Integration Capabilities","href":"/guides/integration-capabilities"},{"title":"Custom Integrations","href":"/guides/custom-integrations"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api/overview"},{"title":"Execute API","href":"/api/execute"},{"title":"Deploy API","href":"/api/deploy"},{"title":"Chat API","href":"/api/chat"}]},{"group":"Resources","pages":[{"title":"FAQ","href":"/faq"},{"title":null,"href":"/legacy-docs"}]}]},"basePath":"","title":"Web Widget - Bothive","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}