• English

      • Widget Settings

      Setup > Widget Settings controls how HeiChat looks on the storefront and which support or marketing entry points customers can use.

      1. Appearance

      Use Appearance to control the visual behavior of the chat launcher and widget.

      Main settings to review:

      • Desktop and mobile position
      • Widget size
      • Margins and z-index
      • Mobile display mode
      • Chat bubble style and animation
      • Lazy load delay
      • Brand logo, avatars, greetings, callout, and theme color
      • Optional homepage inside the widget
      • Classic UI (1.0) or the newer immersive UI (2.0)
      • RTL support
      • Conversation header style

      Recommended setup flow:

      1. Pick desktop and mobile positions that do not clash with sticky UI elements.
      2. Set widget size and spacing.
      3. Decide whether mobile should use full-screen or drawer mode.
      4. Upload your logo and avatars.
      5. Write a greeting and callout that match your brand tone.
      6. Configure homepage behavior under Basic Settings > Enhance Your Experience.

      New UI (2.0) supports a larger in-chat experience, Chatbar entry, Shopilot, and richer product-card actions. Chatbar automatically hides the callout; position it with its own desktop and mobile Chatbar margins. Classic UI remains available for existing storefronts, but New UI is the forward-looking interface.

      2. Feature Widgets

      Feature Widgets expand HeiChat beyond the main chat bubble.

      Sales widgets

      Common sales-focused widgets include:

      • Restock Notification
      • Product Quiz
      • Exit Intent Popup
      • Spin to Win
      • Promotional Product Card
      • Video Popup Widget
      • Sales Activity Popup

      These are useful when you want to:

      • Capture leads on out-of-stock products
      • Recover abandoning visitors
      • Add urgency and social proof

      Support widgets

      Common support-focused widgets include:

      • Product Search Widget
      • Order Search Widget
      • Help Desk Widget
      • Feedback Widget
      • Inline Chat Button
      • Drawer Cart Widget
      • Shipping Protection and Free Shipping Reminder
      • Product FAQ and Order Status Page

      These are useful when you want to:

      • Reduce repetitive support questions
      • Give customers self-service order tracking
      • Let customers submit structured feedback with screenshots
      • Place chat directly on product pages

      Step-by-step suggestions

      If you are rolling this out gradually:

      1. Start with Product Search or Order Search if self-service is important.
      2. Add Feedback Widget if your support team benefits from screenshots.
      3. Add Restock Notification or Exit Intent only after the base experience is already stable.

      Product Quiz gives shoppers a standalone guided product finder and can be shown on the homepage or in chat quick buttons. It supports blacklist/whitelist page rules using paths such as /products/*.

      Product FAQ generates product-specific FAQ and highlights. After enabling it, add the HeiChat Product FAQ app block to the product template. Review, edit, or regenerate the source-language content from Learned Products > Generated FAQ; other selected languages update from the source automatically.

      3. Quick Buttons

      Quick Buttons create one-click shortcuts inside the widget.

      Most common buttons:

      • Best Seller
      • Need Help
      • Q&A quick buttons

      Use them to shorten the path to common intents.

      Recommended order:

      1. Add Need Help if manual escalation is part of your support flow.
      2. Configure Talk to Human separately in Live Support, including its hours and holiday schedule.
      3. Add Best Seller if chat is also used for product discovery.
      4. Add Q&A buttons for the most repetitive questions.

      The page also lists items enabled elsewhere that are currently shown in chat quick buttons; you can hide those entries there without disabling the underlying feature. Q&A buttons reply directly from the configured answer and avoid extra retrieval for that turn.

      4. Quick Help Guides

      Quick Help Guides are clickable document links shown on the widget homepage or in chat. Homepage behavior is managed in Basic Settings > Enhance Your Experience.

      For each document, prepare:

      • A title
      • A short summary
      • A cover image URL
      • A destination page URL

      Important:

      • These are navigation links only.
      • They do not automatically become AI knowledge.
      • If the same content should influence AI answers, also add it to the Knowledge Base.

      5. Social Media

      The Social Media area lets you add icons for channels such as Instagram, Facebook, TikTok, Messenger, Telegram, and others.

      For each entry:

      1. Choose the platform.
      2. Enter the required link or ID.
      3. Decide whether to display it on the storefront.

      Social links can appear in the Floating Widget, the homepage, and chat quick buttons. Hide an item from a particular surface without deleting it: manage homepage visibility in Basic Settings and Floating Widget visibility in Widget Settings.

      Floating Widget and Live Support

      Floating Widget is the central place to choose which contact methods, social links, and feature widgets appear beside the storefront. Hiding an item there does not disable its original configuration. Live Support now owns the human-handoff entry, button copy, work hours, and holidays separately from Quick Buttons.

      1. Finish Appearance first.
      2. Add the fewest Feature Widgets that solve real problems.
      3. Add Quick Buttons for top customer intents.
      4. Add Quick Help Guides if you already have strong support content.
      5. Add Social Media only when those channels are actively managed.