Website Widget

• What customers can do in the widget: chat, Voice, screenshots and files, in their own language.
• How to customize the widget design and behavior.
• How to install the widget on your website.
• How to apply safety settings like allowed domains and excluded pages.

The AI support agent answers every widget conversation from your Knowledge. For signed-in customers it also uses the account data your backend authorizes.

• Chat in their own language: the agent answers in whatever language the customer writes in.
• Talk (Voice): customers can speak to the agent. Speech is detected automatically and Voice answers out loud in 40+ languages; where spoken output isn't supported, the conversation continues in text. Voice minutes come with paid plans.
• Send screenshots and files: images, screenshots and photos, and PDF, DOC, DOCX and TXT files up to 8 MB. Images are read with vision; PDF and Word documents are parsed, including tables.
• Paste links: the agent reads the linked page as context for that conversation. Customer links are context, not your approved knowledge.
• Reach a person: when the agent cannot verify an answer, it hands the conversation to your team instead of guessing, and any teammate can take over from the inbox.

Go to Channels -> Widget. If the widget is not enabled yet, enable it first.

• Live preview of Home, Chat and Talk, on desktop and mobile.
• Design and behavior settings.
• Installation code.

Match the widget to your product without writing CSS. Every change shows in the live preview as you edit.

• Surfaces: Home, Chat and Talk (Voice). You choose which one opens first.
• Theme: light or dark.
• Colors: header, assistant and customer bubbles, chat background, input, send button, launcher, buttons and close button.
• Typography: 45 Google Fonts (sans-serif, serif and monospace), set separately for the header, assistant messages, customer messages, input and launcher, each with its own size.
• Messages: 6 bubble shapes, optionally applied to both sides, and a choice of send icon.
• Header: assistant name, status line and an optional avatar or logo.
• Launcher: 15 icons, optional text (icon-only on mobile if you prefer) and 13 launcher animations.
• Home screen: headline, a short line above it, a primary button, up to 3 links, an animated orb and background styles such as mesh, halo, rays, glow, stars, dots, grain and halftone, with tint, intensity and motion controls.
• Talk: voice, spoken welcome message and orb texture.
• Copy and behavior: welcome message, input placeholder, file uploads on or off, compact mode, allowed domains, and allowed or excluded pages.

Standard install (recommended).

1. 1Copy widget script from Channels -> Widget -> Install code
2. 2Add it to your website so it loads on every page.
3. 3Best place: inside <head>, before </head>.
4. 4If <head> is not available, place before </body> (works, but may load slightly slower).

• Shopify: Online Store>Themes>Edit code -> layout/theme.liquid -> paste before </head> -> Save
• Wix Option A: Settings -> Custom Code -> Add New Tool -> paste code -> Load on all pages -> place in Head -> Save and publish.
• Wix Option B: add script through global site scripts/plugin area and ensure load on all pages.
• Webflow: Project Settings>Custom Code>paste in Head Code -> Save and publish.
• WordPress: use header scripts plugin (Header section) or paste into header.php before </head>.
• Custom-coded sites: place script in global HTML template inside <head> or before </body>.

Recommended settings for safer and cleaner behavior.

• Allowed domains: prevent widget code from being reused on unrelated websites.
• Example domains: yourdomain.com, www.yourdomain.com, shop.yourdomain.com.
• Excluded pages: hide widget where it is not relevant.
• Common exclusions: checkout, order confirmation, account/login, privacy and technical pages.
• Path examples: /checkout, /account, /thank-you.

• Every widget conversation appears in Conversations, in the same inbox as WhatsApp, Instagram and Telegram.
• The AI support agent answers from your Knowledge and, for signed-in customers, from authorized account data, in the customer's language.
• Any teammate can take over and reply directly. While a teammate handles the conversation the AI stays silent; click Resume AI to hand it back.
• In the widget, the customer sees "{name} joined the conversation" when a teammate replies, and "Assistant resumed" when the AI answers again.

• Widget not showing: confirm script is on live site (not only preview), publish changes, verify allowed domains if enabled.
• Widget appears on some pages only: check excluded page rules and confirm script is installed globally.
• Messages not coming in: verify correct OneTwoAgent business account and ensure widget is enabled in Channels -> Widget.